From 04390b9357d5a7b6ca88f57c81ea3c036dc73f8d Mon Sep 17 00:00:00 2001
From: Fabian Affolter <fabian@affolter-engineering.ch>
Date: Sat, 20 Feb 2016 09:45:42 +0100
Subject: [PATCH 1/6] Add first section of devel tutorial

---
 source/developers/tutorial.markdown           | 117 ++++++++++++++++++
 .../images/screenshots/create-component01.png | Bin 0 -> 11155 bytes
 2 files changed, 117 insertions(+)
 create mode 100644 source/developers/tutorial.markdown
 create mode 100644 source/images/screenshots/create-component01.png

diff --git a/source/developers/tutorial.markdown b/source/developers/tutorial.markdown
new file mode 100644
index 00000000000..fb149a8b8a3
--- /dev/null
+++ b/source/developers/tutorial.markdown
@@ -0,0 +1,117 @@
+---
+layout: page
+title: "Development tuorial"
+description: "Tutorial about the first steps on Home Assistant development"
+date: 2016-02-20 07:00
+sidebar: false
+comments: false
+sharing: true
+footer: true
+---
+
+This is a simple tutorial on how to write a component for [Home Assistant](https://home-assistant.io/). We will work on a component called "information". The purpose of this component is to display a given text in the frontend. 
+
+The setup of a development environment is described in the [Developers section](/developers/#starting-development) of the documentation.
+
+As a start, create a file `information.py` in your Git checkout of Home Assistant in the folder `homeassistant/component/`.
+
+```python
+"""
+homeassistant.components.information
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+The information component allows to show text in the frontend.
+
+For more details about this component, please refer to the documentation at
+https://home-assistant.io/components/information/
+"""
+import logging
+
+_LOGGER = logging.getLogger(__name__)
+
+DOMAIN = 'information'
+DEPENDENCIES = []
+
+def setup(hass, config=None):
+    """ Setup the Information component. """
+
+    _LOGGER.info("The 'information' component is ready!")
+
+    return True
+```
+
+1. In the file header we decided to add some details. Like the path, a short description, and the link to the documentation. 
+2. We want to do some logging. This means that we import the Python logging module and create an alias.
+3. The component name is equal to the domain name.
+4. At the moment this component has no dependencies. For detail check [dependencies](/developers/creating_components/#dependencies) section.
+5. The `setup` function will take care of the initialization of our component.
+   The component will only write a log message. Keep in mind for later that you have several options for the severity:
+
+   - _LOGGER.info(msg)
+   - _LOGGER.warning(msg)
+   - _LOGGER.error(msg)
+   - _LOGGER.critical(msg)
+   - _LOGGER.exception(msg)
+
+7. We return `True` if everything is ok.
+
+Add the component to your `configuration.yaml` file.
+
+```yaml
+information:
+```
+
+If you replace `_LOGGER.info("The 'information' component is ready!")` with or add
+
+```python
+hass.states.set('information.Text', 'Info component')
+```
+
+Then the component will not be different to the sample included in the `config/custom_components` folder or shown as an [example](/cookbook/python_component_basic_state/). After a start or a restart of Home Assistant the component will be visible in the frontend.
+
+<p class='img'>
+<img src='/images/screenshots/create-component01.png' />
+</p>
+
+The next step is the introduction of configuration options. Most configuration details are coming out of the `configuration.yaml` file. To do that we need to update the  `def setup()` method to accept configuration information and access the configuration variable in the `setup` method.
+
+```python
+import logging
+
+_LOGGER = logging.getLogger(__name__)
+
+DOMAIN = 'information'
+DEPENDENCIES = []
+CONF_NAME = 'text'
+
+def setup(hass, config):
+    """ Setup the Information component. """
+
+    test = config[DOMAIN].get(CONF_NAME, DEFAULT_NAME)
+    hass.states.set('information.Text', test)
+
+    return True
+```
+
+To add the latest feature of our component, update the entry in your `configuration.yaml` file.
+
+```yaml
+information:
+  text: 'Sample text'
+```
+
+It's important to check if all mandatory configuration variables are provided. If not, the setup should fail. We will use the `validate_config` as a helper to archive this. The next listing shows the essential parts.
+
+```python
+from homeassistant.helpers import validate_config
+[...]
+    if not validate_config(config, {DOMAIN: ['text']}, _LOGGER):
+        return False
+```
+
+So far our new component is rendered as a default compoment in the frontend. But we want our own view of the component in the frontend. We assume that you have setup the (frontend development)[/developers/frontend/] already
+
+We need two new files in the folder `src/cards/`:
+
+- ha-information-card.html
+- ha-information-card.js
+
diff --git a/source/images/screenshots/create-component01.png b/source/images/screenshots/create-component01.png
new file mode 100644
index 0000000000000000000000000000000000000000..74a4fd0cde65d872fb95a24a664f9fb6182ab8a8
GIT binary patch
literal 11155
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

literal 0
HcmV?d00001


From 3fe9bf754b8e359a626e47d6ada27f4aed672b56 Mon Sep 17 00:00:00 2001
From: Fabian Affolter <fabian@affolter-engineering.ch>
Date: Sat, 20 Feb 2016 10:50:24 +0100
Subject: [PATCH 2/6] Add more content

---
 source/developers/tutorial.markdown | 29 ++++++++++++++++++++++++++---
 1 file changed, 26 insertions(+), 3 deletions(-)

diff --git a/source/developers/tutorial.markdown b/source/developers/tutorial.markdown
index fb149a8b8a3..8dbde843ce5 100644
--- a/source/developers/tutorial.markdown
+++ b/source/developers/tutorial.markdown
@@ -1,6 +1,6 @@
 ---
 layout: page
-title: "Development tuorial"
+title: "Development tutorial"
 description: "Tutorial about the first steps on Home Assistant development"
 date: 2016-02-20 07:00
 sidebar: false
@@ -13,6 +13,9 @@ This is a simple tutorial on how to write a component for [Home Assistant](https
 
 The setup of a development environment is described in the [Developers section](/developers/#starting-development) of the documentation.
 
+## {% linkable_title Component %}
+
+
 As a start, create a file `information.py` in your Git checkout of Home Assistant in the folder `homeassistant/component/`.
 
 ```python
@@ -66,7 +69,7 @@ If you replace `_LOGGER.info("The 'information' component is ready!")` with or a
 hass.states.set('information.Text', 'Info component')
 ```
 
-Then the component will not be different to the sample included in the `config/custom_components` folder or shown as an [example](/cookbook/python_component_basic_state/). After a start or a restart of Home Assistant the component will be visible in the frontend.
+then the component will not be different to the sample included in the `config/custom_components` folder or shown as an [example](/cookbook/python_component_basic_state/). After a start or a restart of Home Assistant the component will be visible in the frontend.
 
 <p class='img'>
 <img src='/images/screenshots/create-component01.png' />
@@ -74,6 +77,8 @@ Then the component will not be different to the sample included in the `config/c
 
 The next step is the introduction of configuration options. Most configuration details are coming out of the `configuration.yaml` file. To do that we need to update the  `def setup()` method to accept configuration information and access the configuration variable in the `setup` method.
 
+More details about this topic can be found in the [User given configuration](/developers/creating_components/#config-user-given-configuration) section.
+
 ```python
 import logging
 
@@ -108,10 +113,28 @@ from homeassistant.helpers import validate_config
         return False
 ```
 
-So far our new component is rendered as a default compoment in the frontend. But we want our own view of the component in the frontend. We assume that you have setup the (frontend development)[/developers/frontend/] already
+## {% linkable_title Frontend %}
+
+So far our new component is rendered as a default compoment in the frontend. But we want our own view of the component in the frontend. We assume that you have setup the (frontend development)[/developers/frontend/] already.
 
 We need two new files in the folder `src/cards/`:
 
 - ha-information-card.html
 - ha-information-card.js
 
+
+TBD
+
+Rebuild the frontend.
+
+```bash
+$ script/build_frontend
+```
+
+Change the [http](/components/http/) component to load the `development` version of the frontend as also mentioned in the [ Setting up the environment](/developers/frontend/#setting-up-the-environment) section of the (frontend development)[/developers/frontend/] page.
+
+```yaml
+http:
+  development: 1
+```
+

From 3b0e7e67b9b73ec07479e9b0ef96ef3e0a089d28 Mon Sep 17 00:00:00 2001
From: Fabian Affolter <fabian@affolter-engineering.ch>
Date: Sat, 20 Feb 2016 09:45:42 +0100
Subject: [PATCH 3/6] Add first section of devel tutorial

---
 source/developers/tutorial.markdown           | 117 ++++++++++++++++++
 .../images/screenshots/create-component01.png | Bin 0 -> 11155 bytes
 2 files changed, 117 insertions(+)
 create mode 100644 source/developers/tutorial.markdown
 create mode 100644 source/images/screenshots/create-component01.png

diff --git a/source/developers/tutorial.markdown b/source/developers/tutorial.markdown
new file mode 100644
index 00000000000..fb149a8b8a3
--- /dev/null
+++ b/source/developers/tutorial.markdown
@@ -0,0 +1,117 @@
+---
+layout: page
+title: "Development tuorial"
+description: "Tutorial about the first steps on Home Assistant development"
+date: 2016-02-20 07:00
+sidebar: false
+comments: false
+sharing: true
+footer: true
+---
+
+This is a simple tutorial on how to write a component for [Home Assistant](https://home-assistant.io/). We will work on a component called "information". The purpose of this component is to display a given text in the frontend. 
+
+The setup of a development environment is described in the [Developers section](/developers/#starting-development) of the documentation.
+
+As a start, create a file `information.py` in your Git checkout of Home Assistant in the folder `homeassistant/component/`.
+
+```python
+"""
+homeassistant.components.information
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+The information component allows to show text in the frontend.
+
+For more details about this component, please refer to the documentation at
+https://home-assistant.io/components/information/
+"""
+import logging
+
+_LOGGER = logging.getLogger(__name__)
+
+DOMAIN = 'information'
+DEPENDENCIES = []
+
+def setup(hass, config=None):
+    """ Setup the Information component. """
+
+    _LOGGER.info("The 'information' component is ready!")
+
+    return True
+```
+
+1. In the file header we decided to add some details. Like the path, a short description, and the link to the documentation. 
+2. We want to do some logging. This means that we import the Python logging module and create an alias.
+3. The component name is equal to the domain name.
+4. At the moment this component has no dependencies. For detail check [dependencies](/developers/creating_components/#dependencies) section.
+5. The `setup` function will take care of the initialization of our component.
+   The component will only write a log message. Keep in mind for later that you have several options for the severity:
+
+   - _LOGGER.info(msg)
+   - _LOGGER.warning(msg)
+   - _LOGGER.error(msg)
+   - _LOGGER.critical(msg)
+   - _LOGGER.exception(msg)
+
+7. We return `True` if everything is ok.
+
+Add the component to your `configuration.yaml` file.
+
+```yaml
+information:
+```
+
+If you replace `_LOGGER.info("The 'information' component is ready!")` with or add
+
+```python
+hass.states.set('information.Text', 'Info component')
+```
+
+Then the component will not be different to the sample included in the `config/custom_components` folder or shown as an [example](/cookbook/python_component_basic_state/). After a start or a restart of Home Assistant the component will be visible in the frontend.
+
+<p class='img'>
+<img src='/images/screenshots/create-component01.png' />
+</p>
+
+The next step is the introduction of configuration options. Most configuration details are coming out of the `configuration.yaml` file. To do that we need to update the  `def setup()` method to accept configuration information and access the configuration variable in the `setup` method.
+
+```python
+import logging
+
+_LOGGER = logging.getLogger(__name__)
+
+DOMAIN = 'information'
+DEPENDENCIES = []
+CONF_NAME = 'text'
+
+def setup(hass, config):
+    """ Setup the Information component. """
+
+    test = config[DOMAIN].get(CONF_NAME, DEFAULT_NAME)
+    hass.states.set('information.Text', test)
+
+    return True
+```
+
+To add the latest feature of our component, update the entry in your `configuration.yaml` file.
+
+```yaml
+information:
+  text: 'Sample text'
+```
+
+It's important to check if all mandatory configuration variables are provided. If not, the setup should fail. We will use the `validate_config` as a helper to archive this. The next listing shows the essential parts.
+
+```python
+from homeassistant.helpers import validate_config
+[...]
+    if not validate_config(config, {DOMAIN: ['text']}, _LOGGER):
+        return False
+```
+
+So far our new component is rendered as a default compoment in the frontend. But we want our own view of the component in the frontend. We assume that you have setup the (frontend development)[/developers/frontend/] already
+
+We need two new files in the folder `src/cards/`:
+
+- ha-information-card.html
+- ha-information-card.js
+
diff --git a/source/images/screenshots/create-component01.png b/source/images/screenshots/create-component01.png
new file mode 100644
index 0000000000000000000000000000000000000000..74a4fd0cde65d872fb95a24a664f9fb6182ab8a8
GIT binary patch
literal 11155
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

literal 0
HcmV?d00001


From 76a3a0ce16ac806b74cf8e9663fc2e515ab1c7a4 Mon Sep 17 00:00:00 2001
From: Fabian Affolter <fabian@affolter-engineering.ch>
Date: Sat, 20 Feb 2016 10:50:24 +0100
Subject: [PATCH 4/6] Add more content

---
 source/developers/tutorial.markdown | 29 ++++++++++++++++++++++++++---
 1 file changed, 26 insertions(+), 3 deletions(-)

diff --git a/source/developers/tutorial.markdown b/source/developers/tutorial.markdown
index fb149a8b8a3..8dbde843ce5 100644
--- a/source/developers/tutorial.markdown
+++ b/source/developers/tutorial.markdown
@@ -1,6 +1,6 @@
 ---
 layout: page
-title: "Development tuorial"
+title: "Development tutorial"
 description: "Tutorial about the first steps on Home Assistant development"
 date: 2016-02-20 07:00
 sidebar: false
@@ -13,6 +13,9 @@ This is a simple tutorial on how to write a component for [Home Assistant](https
 
 The setup of a development environment is described in the [Developers section](/developers/#starting-development) of the documentation.
 
+## {% linkable_title Component %}
+
+
 As a start, create a file `information.py` in your Git checkout of Home Assistant in the folder `homeassistant/component/`.
 
 ```python
@@ -66,7 +69,7 @@ If you replace `_LOGGER.info("The 'information' component is ready!")` with or a
 hass.states.set('information.Text', 'Info component')
 ```
 
-Then the component will not be different to the sample included in the `config/custom_components` folder or shown as an [example](/cookbook/python_component_basic_state/). After a start or a restart of Home Assistant the component will be visible in the frontend.
+then the component will not be different to the sample included in the `config/custom_components` folder or shown as an [example](/cookbook/python_component_basic_state/). After a start or a restart of Home Assistant the component will be visible in the frontend.
 
 <p class='img'>
 <img src='/images/screenshots/create-component01.png' />
@@ -74,6 +77,8 @@ Then the component will not be different to the sample included in the `config/c
 
 The next step is the introduction of configuration options. Most configuration details are coming out of the `configuration.yaml` file. To do that we need to update the  `def setup()` method to accept configuration information and access the configuration variable in the `setup` method.
 
+More details about this topic can be found in the [User given configuration](/developers/creating_components/#config-user-given-configuration) section.
+
 ```python
 import logging
 
@@ -108,10 +113,28 @@ from homeassistant.helpers import validate_config
         return False
 ```
 
-So far our new component is rendered as a default compoment in the frontend. But we want our own view of the component in the frontend. We assume that you have setup the (frontend development)[/developers/frontend/] already
+## {% linkable_title Frontend %}
+
+So far our new component is rendered as a default compoment in the frontend. But we want our own view of the component in the frontend. We assume that you have setup the (frontend development)[/developers/frontend/] already.
 
 We need two new files in the folder `src/cards/`:
 
 - ha-information-card.html
 - ha-information-card.js
 
+
+TBD
+
+Rebuild the frontend.
+
+```bash
+$ script/build_frontend
+```
+
+Change the [http](/components/http/) component to load the `development` version of the frontend as also mentioned in the [ Setting up the environment](/developers/frontend/#setting-up-the-environment) section of the (frontend development)[/developers/frontend/] page.
+
+```yaml
+http:
+  development: 1
+```
+

From 662821a2685709fd86a980b9cc15e772a45eed65 Mon Sep 17 00:00:00 2001
From: Fabian Affolter <fabian@affolter-engineering.ch>
Date: Sat, 12 Mar 2016 14:52:22 +0100
Subject: [PATCH 5/6] Update

---
 .../images/screenshots/create-component01.png | Bin 11155 -> 12625 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/source/images/screenshots/create-component01.png b/source/images/screenshots/create-component01.png
index 74a4fd0cde65d872fb95a24a664f9fb6182ab8a8..3bc3b34984aa8b355d5803d26246a53127ba9d42 100644
GIT binary patch
literal 12625
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
Bi&X#s

literal 11155
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


From 82fde628ce6d715a8c7087943a8aa8dfa684d5e1 Mon Sep 17 00:00:00 2001
From: Fabian Affolter <fabian@affolter-engineering.ch>
Date: Sat, 12 Mar 2016 14:52:33 +0100
Subject: [PATCH 6/6] Move content

---
 .../python_component_basic_state.markdown     | 120 +++++++++++++++---
 1 file changed, 101 insertions(+), 19 deletions(-)

diff --git a/source/_cookbook/python_component_basic_state.markdown b/source/_cookbook/python_component_basic_state.markdown
index 3eca0d8bbab..7a95cec30ad 100644
--- a/source/_cookbook/python_component_basic_state.markdown
+++ b/source/_cookbook/python_component_basic_state.markdown
@@ -10,34 +10,116 @@ footer: true
 ha_category: Custom Python Component Examples
 ---
 
-This is a simple hello world example to show the basics for setting a state. To use this example, create the file `<config dir>/custom_components/hello_state.py` and copy the below example code.
+This is a simple tutorial/example on how to write a component for [Home Assistant](https://home-assistant.io/). We will work on a component called "hello_state" to beginn with. The purpose of this component is to display a given text in the frontend. 
+
+The setup of a development environment is described in the [Developers section](/developers/#starting-development) of the documentation.
+
+## {% linkable_title Component %}
+
+To get started, create the file `<config dir>/custom_components/hello_state.py` and copy the below example code.
 
 ```python
-# The domain of your component. Should be equal to the name of your component.
+"""
+Support for showing text in the frontend.
+
+For more details about this component, please refer to the documentation at
+https://home-assistant.io/components/hello_state/
+"""
+import logging
+
+_LOGGER = logging.getLogger(__name__)
+
 DOMAIN = 'hello_state'
+DEPENDENCIES = []
 
-CONF_NAME = 'name'
-DEFAULT_NAME = 'World'
+def setup(hass, config=None):
+    """Setup the Hello State component. """
+    _LOGGER.info("The 'hello state' component is ready!")
 
-
-def setup(hass, config):
-    """Setup is called when Home Assistant is loading our component."""
-
-    # Get the name from the configuration. Use DEFAULT_NAME if no name provided.
-    name = config[DOMAIN].get(CONF_NAME, DEFAULT_NAME)
-
-    # States are in the format DOMAIN.OBJECT_ID
-    hass.states.set('hello_state.hello', name)
-
-    # Return boolean to indicate that initialization was successfully.
     return True
 ```
 
-Load the component by adding the following to your `configuration.yaml`:
+1. In the file header we decided to add some details: A short description and the link to the documentation. 
+2. We want to do some logging. This means that we import the Python logging module and create an alias.
+3. The component name is equal to the domain name.
+4. At the moment this component has no dependencies. For detail check [dependencies](/developers/creating_components/#dependencies) section.
+5. The `setup` function will take care of the initialization of our component.
+   The component will only write a log message. Keep in mind for later that you have several options for the severity:
+
+   - `_LOGGER.info(msg)`
+   - `_LOGGER.warning(msg)`
+   - `_LOGGER.error(msg)`
+   - `_LOGGER.critical(msg)`
+   - `_LOGGER.exception(msg)`
+
+7. We return `True` if everything is ok.
+
+Add the component to your `configuration.yaml` file.
 
 ```yaml
-# configuration.yaml entry
 hello_state:
-  # optional
-  name: Paulus
 ```
+
+After a start or a restart of Home Assistant the component will create an entry in the log.
+
+```bash
+16-03-12 14:16:42 INFO (MainThread) [custom_components.hello_state] The 'hello state' component is ready!
+```
+
+The next step is the introduction of configuration options. Most configuration details are coming out of the `configuration.yaml` file. To do that we need to update the `def setup()` method to accept configuration information and access the configuration variable in the `setup` method.
+
+More details about this topic can be found in the [User given configuration](/developers/creating_components/#config-user-given-configuration) section.
+
+```python
+import logging
+
+_LOGGER = logging.getLogger(__name__)
+
+DOMAIN = 'hello_state'
+DEPENDENCIES = []
+
+CONF_TEXT = 'text'
+DEFAULT_TEXT = 'No text!'
+
+def setup(hass, config):
+    """Setup the Hello State component. """
+    # Get the text from the configuration. Use DEFAULT_TEXT if no name is provided.
+    text = config[DOMAIN].get(CONF_TEXT, DEFAULT_TEXT)
+
+    # States are in the format DOMAIN.OBJECT_ID
+    hass.states.set('hello_state.Hello_State', text)
+
+    return True
+```
+
+To add the latest feature of our component, update the entry in your `configuration.yaml` file.
+
+```yaml
+information:
+  text: 'Hello, World!'
+```
+
+Thanks to `DEFAULT_TEXT` variable the component will launch even if no `text:` field is used in the `configuration.yaml` file. Quite often there are variables which are required. It's important to check if all mandatory configuration variables are provided. If not, the setup should fail. We will use the `validate_config` function as a helper to achive this. The next listing shows the essential parts.
+
+```python
+from homeassistant.helpers import validate_config
+[...]
+    if not validate_config(config, {DOMAIN: [CONF_TEXT]}, _LOGGER):
+        return False
+```
+
+If `text:` is missing, there will be a warning in the log file.
+
+```bash
+16-03-12 14:37:37 ERROR (MainThread) [custom_components.hello_state] Missing required configuration items in hello_state: text
+16-03-12 14:37:37 ERROR (MainThread) [homeassistant.bootstrap] component hello_state failed to initialize
+```
+
+After a start or a restart of Home Assistant the component will be visible in the frontend if the `configuration.yaml` file is up-to-date.
+
+<p class='img'>
+<img src='/images/screenshots/create-component01.png' />
+</p>
+
+To get your component included in the Home Assistant releases, follow the steps described in the [Submitting improvements](https://home-assistant.io/developers/#submitting-improvements) section. Basically you only need to move your component in the `homeassistant/component/` directory of your fork and create a Pull Request.
+