From d8c8cf4c8dbc2eb5df46f000d2f7f7c88cfc8b42 Mon Sep 17 00:00:00 2001
From: Paulus Schoutsen <paulus@paulusschoutsen.nl>
Date: Sat, 16 Apr 2016 23:00:45 -0700
Subject: [PATCH] More tweaks to developer docs

---
 sass/custom/_paulus.scss                      |   4 +
 .../asides/developers_navigation.html         |  25 ++++--
 source/developers/add_new_platform.markdown   |  83 ++----------------
 .../architecture_components.markdown          |   5 ++
 .../component_deps_and_reqs.markdown          |  26 ++++++
 ....markdown => component_discovery.markdown} |   4 +-
 source/developers/component_events.markdown   |  12 +++
 .../component_initialization.markdown         |  36 ++++++++
 source/developers/component_loading.markdown  |  25 ++++++
 .../developers/creating_components.markdown   |  75 +++-------------
 .../platform_example_light.markdown           |  77 ++++++++++++++++
 .../platform_example_sensor.markdown          |  49 +++++++++++
 .../architecture/component_interaction.png    | Bin 0 -> 30512 bytes
 13 files changed, 272 insertions(+), 149 deletions(-)
 create mode 100644 source/developers/component_deps_and_reqs.markdown
 rename source/developers/{platform_discovery.markdown => component_discovery.markdown} (96%)
 create mode 100644 source/developers/component_events.markdown
 create mode 100644 source/developers/component_initialization.markdown
 create mode 100644 source/developers/component_loading.markdown
 create mode 100644 source/developers/platform_example_light.markdown
 create mode 100644 source/developers/platform_example_sensor.markdown
 create mode 100644 source/images/architecture/component_interaction.png

diff --git a/sass/custom/_paulus.scss b/sass/custom/_paulus.scss
index f2904767113..bfe0c472ce3 100644
--- a/sass/custom/_paulus.scss
+++ b/sass/custom/_paulus.scss
@@ -337,3 +337,7 @@ ul.sidebar-menu a.active {
   color: #000;
   font-weight: bold;
 }
+
+a code {
+  color: #049cdb;
+}
\ No newline at end of file
diff --git a/source/_includes/asides/developers_navigation.html b/source/_includes/asides/developers_navigation.html
index e99588eea03..67f87aac324 100644
--- a/source/_includes/asides/developers_navigation.html
+++ b/source/_includes/asides/developers_navigation.html
@@ -12,6 +12,23 @@
           <li>{% active_link /developers/development_environment/ Setup Dev Environment %}</li>
         </ul>
       </li>
+      <li>
+        {% active_link /developers/add_new_platform/ Support a new device (as a platform) %}
+        <ul>
+          <li>{% active_link /developers/platform_example_sensor/ Example sensor platform  %}</li>
+          <li>{% active_link /developers/platform_example_light/ Example light platform %}</li>
+        </ul>
+      </li>
+      <li>
+        {% active_link /developers/creating_components/ Adding a new component %}
+        <ul>
+          <li>{% active_link /developers/component_loading/ Loading components %}</li>
+          <li>{% active_link /developers/component_deps_and_reqs/ Requirements & Dependencies %}</li>
+          <li>{% active_link /developers/component_initialization/ Initialization %}</li>
+          <li>{% active_link /developers/component_events/ Handling events %}</li>
+          <li>{% active_link /developers/component_discovery/ Component Discovery %}</li>
+        </ul>
+      </li>
       <li>
         Frontend Development
         <ul>
@@ -20,14 +37,6 @@
           <li>{% active_link /developers/frontend_add_more_info/ Add More Info Dialog %}</li>
         </ul>
       </li>
-      <li>
-        Extending Home Assistant
-        <ul>
-          <li>{% active_link /developers/creating_components/ Creating Components %}</li>
-          <li>{% active_link /developers/add_new_platform/ Adding Platform Support %}</li>
-          <li>{% active_link /developers/platform_discovery/ Platform Discovery %}</li>
-        </ul>
-      </li>
       <li>
         API
         <ul>
diff --git a/source/developers/add_new_platform.markdown b/source/developers/add_new_platform.markdown
index 0e17acc7a0c..73bf3e5367c 100644
--- a/source/developers/add_new_platform.markdown
+++ b/source/developers/add_new_platform.markdown
@@ -9,16 +9,23 @@ sharing: true
 footer: true
 ---
 
-Components that interact with devices are structured in core- and platform logic. This allows the same logic to be used for different platforms.
+Components that interact with devices are called Entity Components. They are structured in core- and platform logic. This allows the same logic to handle a light to be used by different brands.
 
 For example, the built-in `switch` component consists of various platform in [`homeassistant/components/switch/`](https://github.com/home-assistant/home-assistant/tree/master/homeassistant/components/switch). The file `__init__.py` contains the core logic of all platform and the `vendor_name.py` files only the relevant platform code.
 
-If you are planning to add support for a new type of device to an existing component, you can get away with only writing platform logic. Have a look at how the component works with other platforms and create a similar file for the platform that you would like to add.
+If you are planning to add support for a new type of device to an existing component, you can get away with only writing platform logic. Have a look at how the component works with other platforms and create a similar file for the platform that you would like to add:
+
+ - [Example sensor platform](/developers/platform_example_sensor): hello world of platforms.
+ - [Example light platform](/developers/platform_example_light): showing best practices.
 
 ### {% linkable_title Interfacing with devices %}
 
 One of the rules for Home Assistant is that platform logic should never interface directly with devices but use a third-party Python 3 library to do so. This way Home Assistant is able to share code with the Python community and we can keep the project maintainable.
 
+To integrate the third-party library you create an Entity class for your device. Entities are Home Assistant's representation of lights, switches, sensors, etc. and are derived from the [Entity Abstract Class](https://github.com/home-assistant/home-assistant/blob/master/homeassistant/helpers/entity.py). This abstract class contains logic for integrating most standard features into your entities, such as visibility, entity IDs, updates, and much more.
+
+### {% linkable_title Requirements and dependencies %}
+
 Platforms can specify dependencies and requirements the same way as a component does.
 
 ```python
@@ -26,75 +33,3 @@ REQUIREMENTS = ['some-package==2.0.0', 'some-other-package==2.5.0']
 DEPENDENCIES = ['mqtt']
 ```
 
-### {% linkable_title Platform example %}
-
-
-
-Entities are Home Assistant's representation of lights, switches, sensors, etc. and are derived from the [Entity Abstract Class](https://github.com/home-assistant/home-assistant/blob/master/homeassistant/helpers/entity.py). This abstract class contains logic for integrating most standard features into your entities, such as visibility, entity IDs, updates, and many more.
-
-This example is for adding support for the imaginary Awesome Lights.
-
-```python
-import logging
-
-# Import the device class from the component that you want to support
-from homeassistant.components.light import Light
-from homeassistant.const import CONF_HOST, CONF_USERNAME, CONF_PASSWORD
-
-# Home Assistant depends on 3rd party packages for API specific code.
-REQUIREMENTS = ['awesome_lights==1.2.3']
-
-_LOGGER = logging.getLogger(__name__)
-
-
-setup_platform(hass, config, add_devices, discovery_info=None):
-    """Initialize Awesome Light platform."""
-    import awesomelights
-
-    # Validate passed in config
-    host = config.get(CONF_HOST)
-    username = config.get(CONF_USERNAME)
-    password = config.get(CONF_PASSWORD)
-
-    if host is None or username is None or password is None:
-        _LOGGER.error('Invalid config. Expected %s, %s and %s',
-                      CONF_HOST, CONF_USERNAME, CONF_PASSWORD)
-        return False
-
-    # Setup connection with devices/cloud
-    hub = awesomelights.Hub(host, username, password)
-
-    # Verify that passed in config works
-    if not hub.is_valid_login():
-        _LOGGER.error('Could not connect to AwesomeLight hub')
-        return False
-
-    # Add devices
-    add_devices(AwesomeLight(light) for light in hub.lights())
-
-class AwesomeLight(Light):
-    """Represents an AwesomeLight in Home Assistant."""
-
-    def __init__(self, light):
-        """Initialize an AwesomeLight."""
-        self._light = light
-
-    def update(self):
-        """Fetch new state data for this light.
-
-        This is the only method that should fetch new data for Home Assitant.
-        """
-        self._light.update()
-
-    def brightness(self):
-        """Brightness of the light.
-
-        This method is optional. Removing it indicates to Home Assistant
-        that brightness is not supported for this light.
-        """
-        return self._light.brightness
-
-    def is_on(self):
-        """If light is on."""
-        return self._light.is_on()
-```
diff --git a/source/developers/architecture_components.markdown b/source/developers/architecture_components.markdown
index a2f7f056bed..ae8b36320df 100644
--- a/source/developers/architecture_components.markdown
+++ b/source/developers/architecture_components.markdown
@@ -11,6 +11,11 @@ footer: true
 
 Home Assistant can be extended by **components**. Each component is responsible for a specific domain within Home Assistant. Components can listen for or trigger events, offer services and maintain states. Components are written in Python and can do all the goodness that Python has to offer. Out of the box, Home Assistant offers a bunch of [built-in components]({{site_root}}/components/).
 
+<p class='img'>
+<img src='/images/architecture/component_interaction.png' alt='Diagram showing interaction between components and the Home Assistant core.'>
+Diagram showing interaction between components and the Home Assistant core.
+</p>
+
 We can differentiate between two different types of components within Home Assistant.
 
 #### {% linkable_title Components that interact with an Internet of Things domain %}
diff --git a/source/developers/component_deps_and_reqs.markdown b/source/developers/component_deps_and_reqs.markdown
new file mode 100644
index 00000000000..05d8cf19f7d
--- /dev/null
+++ b/source/developers/component_deps_and_reqs.markdown
@@ -0,0 +1,26 @@
+---
+layout: page
+title: "Requirements & Dependencies"
+description: "Instructions how to define requirements and dependencies."
+date: 2016-04-16 13:32
+sidebar: true
+comments: false
+sharing: true
+footer: true
+---
+
+Home Assistant allows components and platforms to specify their dependencies and requirements using the variables `DEPENDENCIES` and `REQUIREMENTS`. Both are lists that contain strings.
+
+Dependencies are other Home Assistant components that should be setup before the platform is loaded. An example is the MQTT sensor component, which requires an active connection to an MQTT broker. If Home Assistant is unable to load and setup the MQTT component, it will not setup the MQTT sensor component.
+
+```python
+DEPENDENCIES = ['mqtt']
+```
+
+Requirements are Python libraries that you would normally install using `pip`. If Home Assistant is unable to install the requirements or verify it is installed, the component will fail to load.
+
+Requirements is a list of strings. Each entry is a pip compatible string. For example, the media player Cast platform depends on the Python package PyChromecast v0.6.12:
+
+```python
+REQUIREMENTS = ['pychromecast==0.6.12']
+```
diff --git a/source/developers/platform_discovery.markdown b/source/developers/component_discovery.markdown
similarity index 96%
rename from source/developers/platform_discovery.markdown
rename to source/developers/component_discovery.markdown
index 78f19ffbb40..dd1d82d6d49 100644
--- a/source/developers/platform_discovery.markdown
+++ b/source/developers/component_discovery.markdown
@@ -1,7 +1,7 @@
 ---
 layout: page
-title: "Platform Discovery"
-description: "How to make platform discovery work."
+title: "Component Discovery"
+description: "How to make component discovery work."
 date: 2016-04-16 14:24 -07:00
 sidebar: true
 comments: false
diff --git a/source/developers/component_events.markdown b/source/developers/component_events.markdown
new file mode 100644
index 00000000000..485bc2863c8
--- /dev/null
+++ b/source/developers/component_events.markdown
@@ -0,0 +1,12 @@
+---
+layout: page
+title: "Handling events"
+description: "Instructions how to handle events with your component."
+date: 2016-04-16 13:32
+sidebar: true
+comments: false
+sharing: true
+footer: true
+---
+
+Home Assistant has different ways of responding to events that occur in Home Assistant. These have been organized in [helper methods](https://github.com/home-assistant/home-assistant/blob/dev/homeassistant/helpers/event.py). Examples are `track_state_change`, `track_point_in_time`, `track_time_change`.
diff --git a/source/developers/component_initialization.markdown b/source/developers/component_initialization.markdown
new file mode 100644
index 00000000000..1724765d998
--- /dev/null
+++ b/source/developers/component_initialization.markdown
@@ -0,0 +1,36 @@
+---
+layout: page
+title: "Initializing your components"
+description: "Instructions how to handle initialization of your component."
+date: 2016-04-16 13:32
+sidebar: true
+comments: false
+sharing: true
+footer: true
+---
+
+After loading, the bootstrapper will call `setup(hass, config)` method on the component to initialize it.
+
+### {% linkable_title hass: the Home Assistant instance %}
+
+The Home Assistant instance contains three objects to help you interact with the system.
+
+| Object | Description |
+| ------ | ----------- |
+| `hass.config` | This is the core configuration of Home Assistant exposing location, temperature preferences and config directory path. [Details](https://github.com/home-assistant/home-assistant/blob/dev/homeassistant/core.py#L687)
+| `hass.states` | This is the StateMachine. It allows you to set states and track when they are changed. [See available methods](https://github.com/home-assistant/home-assistant/blob/dev/homeassistant/core.py#L434). |
+| `hass.bus` | This is the EventBus. It allows you to trigger and listen for events.<br>[See available methods](https://github.com/home-assistant/home-assistant/blob/dev/homeassistant/core.py#L229). |
+| `hass.services` | This is the ServiceRegistry. It allows you to register services.<br>[See available methods](https://github.com/home-assistant/home-assistant/blob/dev/homeassistant/core.py#L568). |
+
+### {% linkable_title config: User given configuration. %}
+
+The `config` parameter is a dictionary containing the user supplied configuration. The keys of the dictionary are the component names and the value is another dictionary with the component configuration.
+
+If your configuration file contains the following lines:
+
+```yaml
+example:
+  host: paulusschoutsen.nl
+```
+
+Then in the setup method of your component you will be able to refer to `config['example']['host']` to get the value `paulusschoutsen.nl`.
diff --git a/source/developers/component_loading.markdown b/source/developers/component_loading.markdown
new file mode 100644
index 00000000000..35b50ee975c
--- /dev/null
+++ b/source/developers/component_loading.markdown
@@ -0,0 +1,25 @@
+---
+layout: page
+title: "Loading your components"
+description: "Instructions how to get your component loaded by Home Assistant."
+date: 2016-04-16 13:32
+sidebar: true
+comments: false
+sharing: true
+footer: true
+---
+
+A component will be loaded on start if a section (ie. `light:`) for it exists in the config file. A component can also be loaded if another component is loaded that depends on it. When loading a component Home Assistant will check the following paths:
+
+ * `<config directory>/custom_components/<component name>`
+ * `homeassistant/components/<component name>` (built-in components)
+
+Once loaded, a component will only be setup if all dependencies can be loaded and are able to setup. Keep an eye on the logs to see if your component could be loaded and initialized.
+
+<p class='note warning'>
+You can override a built-in component by having a component with the same name in your <code>config/custom_components</code> folder. This is not recommended and will probably break things!
+</p>
+
+<p class='note'>
+Home Assistant will use the directory that contains your config file as the directory that holds your customizations. By default this is the <code>config</code> folder in your current work directory. You can use a different folder by running Home Assistant with the --config argument: <code>python3 homeassistant --config /YOUR/CONFIG/PATH/</code>.
+</p>
diff --git a/source/developers/creating_components.markdown b/source/developers/creating_components.markdown
index f869a434f9c..f52629db8a4 100644
--- a/source/developers/creating_components.markdown
+++ b/source/developers/creating_components.markdown
@@ -9,74 +9,19 @@ sharing: true
 footer: true
 ---
 
-Home Assistant offers [built-in components]({{site_root}}/components/) but it is easy to build your own. If you are the kind of person that likes to learn from code rather then guide then head over to the [`config/custom_components`](https://github.com/home-assistant/home-assistant/tree/master/config/custom_components) folder in the repository for two example components. Or visit the [Custom Python Component Examples]({{site_root}}/cookbook/#custom-python-component-examples).
+Alright, you're ready to make your first component. AWESOME. Don't worry, we've tried hard to keep it as easy as possible.
 
-The first is [hello_world.py](https://github.com/home-assistant/home-assistant/blob/master/config/custom_components/hello_world.py) (this is similar to the [Basic State Setting Example](https://home-assistant.io/cookbook/python_component_basic_state/)), which is the classic "Hello World" example for Home Assistant. The second one is [example.py](https://github.com/home-assistant/home-assistant/blob/master/config/custom_components/example.py) which showcases various ways you can tap into Home Assistant to be notified when certain events occur.
+### {% linkable_title Example component %}
 
-If you want to load these components in Home Assistant, add the following lines to your `configuration.yaml` file:
+Add `hello_state:` to your `configuration.yaml` file and create a file `<config_dir>/custom_components/hello_state.py` with the below code to test it locally.
 
-```yaml
-hello_world:
+```python
+DOMAIN = 'hello_state'
 
-example:
-  target: TARGET_ENTITY
+def setup(hass, config):
+    hass.states.set('hello.world', 'Paulus')
+
+    return True
 ```
 
-`TARGET_ENTITY` should be one of your devices that can be turned on and off, ie a light or a switch. Example value could be `light.Ceiling` or `switch.AC` (if you have these devices with those names).
-
-## {% linkable_title Loading components %}
-
-A component will be loaded on start if a section (ie. `light:`) for it exists in the config file. A component can also be loaded if another component is loaded that depends on it. When loading a component Home Assistant will check the following paths:
-
- * `<config directory>/custom_components/<component name>`
- * `homeassistant/components/<component name>` (built-in components)
-
-Once loaded, a component will only be setup if all dependencies can be loaded and are able to setup. Keep an eye on the logs to see if your component could be loaded and initialized.
-
-<p class='note warning'>
-You can override a built-in component by having a component with the same name in your <code>config/custom_components</code> folder. This is not recommended and will probably break things!
-</p>
-
-<p class='note'>
-Home Assistant will use the directory that contains your config file as the directory that holds your customizations. By default this is the <code>config</code> folder in your current work directory. You can use a different folder by running Home Assistant with the --config argument: <code>python3 homeassistant --config /YOUR/CONFIG/PATH/</code>.
-</p>
-
-## {% linkable_title Dependencies %}
-
-Home Assistant allows components and platforms to specify their dependencies and requirements using the variables `DEPENDENCIES` and `REQUIREMENTS`. Both are lists that contain strings.
-
-Dependencies are other Home Assistant components that should be setup before the platform is loaded. An example is the MQTT sensor component, which requires an active connection to an MQTT broker. If Home Assistant is unable to load and setup the MQTT component, it will not setup the MQTT sensor component.
-
-Requirements are Python libraries that you would normally install using `pip`. Each entry in a requirement list is a pip compatible string. For example, the media player Cast platform depends on the Python package PyChromecast thus `REQUIREMENTS = ['pychromecast==0.6.12']`. If Home Assistant is unable to install the package or verify it is installed, the component will fail to load.
-
-## {% linkable_title Initializing components %}
-
-After loading, the bootstrapper will call `setup(hass, config)` method on the component to initialize it.
-
-### {% linkable_title `hass`: the Home Assistant instance %}
-
-The Home Assistant instance contains three objects to help you interact with the system.
-
-| Object | Description |
-| ------ | ----------- |
-| `hass.config` | This is the core configuration of Home Assistant exposing location, temperature preferences and config directory path. [Details](https://github.com/home-assistant/home-assistant/blob/dev/homeassistant/core.py#L687)
-| `hass.states` | This is the StateMachine. It allows you to set states and track when they are changed. [See available methods](https://github.com/home-assistant/home-assistant/blob/dev/homeassistant/core.py#L434). |
-| `hass.bus` | This is the EventBus. It allows you to trigger and listen for events.<br>[See available methods](https://github.com/home-assistant/home-assistant/blob/dev/homeassistant/core.py#L229). |
-| `hass.services` | This is the ServiceRegistry. It allows you to register services.<br>[See available methods](https://github.com/home-assistant/home-assistant/blob/dev/homeassistant/core.py#L568). |
-
-### {% linkable_title `config`: User given configuration. %}
-
-The `config` parameter is a dictionary containing the user supplied configuration. The keys of the dictionary are the component names and the value is another dictionary with the component configuration.
-
-If your configuration file contains the following lines:
-
-```yaml
-example:
-  host: paulusschoutsen.nl
-```
-
-Then in the setup method of your component you will be able to refer to `config['example']['host']` to get the value `paulusschoutsen.nl`.
-
-## {% linkable_title Responding to events %}
-
-Home Assistant has different ways of responding to events that occur in Home Assistant. These have been organized in [helper methods](https://github.com/home-assistant/home-assistant/blob/dev/homeassistant/helpers/event.py). Examples are `track_state_change`, `track_point_in_time`, `track_time_change`.
+For more examples, see the [Custom Python Component Examples](/cookbook/#custom-python-component-examples) on our examples page.
diff --git a/source/developers/platform_example_light.markdown b/source/developers/platform_example_light.markdown
new file mode 100644
index 00000000000..b80e966907b
--- /dev/null
+++ b/source/developers/platform_example_light.markdown
@@ -0,0 +1,77 @@
+---
+layout: page
+title: "Example light platform"
+description: "Minimum implementation of a Home Assistant platform."
+date: 2016-04-16 14:24 -07:00
+sidebar: true
+comments: false
+sharing: true
+footer: true
+---
+
+This example is for adding support for the imaginary Awesome Lights. It shows the different best practices for developing a platform.
+
+```python
+import logging
+
+# Import the device class from the component that you want to support
+from homeassistant.components.light import Light
+from homeassistant.const import CONF_HOST, CONF_USERNAME, CONF_PASSWORD
+
+# Home Assistant depends on 3rd party packages for API specific code.
+REQUIREMENTS = ['awesome_lights==1.2.3']
+
+_LOGGER = logging.getLogger(__name__)
+
+
+setup_platform(hass, config, add_devices, discovery_info=None):
+    """Initialize Awesome Light platform."""
+    import awesomelights
+
+    # Validate passed in config
+    host = config.get(CONF_HOST)
+    username = config.get(CONF_USERNAME)
+    password = config.get(CONF_PASSWORD)
+
+    if host is None or username is None or password is None:
+        _LOGGER.error('Invalid config. Expected %s, %s and %s',
+                      CONF_HOST, CONF_USERNAME, CONF_PASSWORD)
+        return False
+
+    # Setup connection with devices/cloud
+    hub = awesomelights.Hub(host, username, password)
+
+    # Verify that passed in config works
+    if not hub.is_valid_login():
+        _LOGGER.error('Could not connect to AwesomeLight hub')
+        return False
+
+    # Add devices
+    add_devices(AwesomeLight(light) for light in hub.lights())
+
+class AwesomeLight(Light):
+    """Represents an AwesomeLight in Home Assistant."""
+
+    def __init__(self, light):
+        """Initialize an AwesomeLight."""
+        self._light = light
+
+    def update(self):
+        """Fetch new state data for this light.
+
+        This is the only method that should fetch new data for Home Assitant.
+        """
+        self._light.update()
+
+    def brightness(self):
+        """Brightness of the light.
+
+        This method is optional. Removing it indicates to Home Assistant
+        that brightness is not supported for this light.
+        """
+        return self._light.brightness
+
+    def is_on(self):
+        """If light is on."""
+        return self._light.is_on()
+```
diff --git a/source/developers/platform_example_sensor.markdown b/source/developers/platform_example_sensor.markdown
new file mode 100644
index 00000000000..6519ced0ba8
--- /dev/null
+++ b/source/developers/platform_example_sensor.markdown
@@ -0,0 +1,49 @@
+---
+layout: page
+title: "Example sensor platform"
+description: "Minimum implementation of a Home Assistant platform."
+date: 2016-04-16 14:24 -07:00
+sidebar: true
+comments: false
+sharing: true
+footer: true
+---
+
+This is a minimum implementation of a platform for the sensor component.
+
+### {% linkable_title Installation %}
+
+Copy the code below and create it as a file in `<config_dir>/sensor/example.py`.
+
+Add the following to your configuration.yaml:
+
+```yaml
+# Example configuration.yaml entry
+sensor:
+  platform: example
+```
+
+### {% linkable_title Code %}
+
+```python
+from homeassistant.const import TEMP_CELCIUS
+from homeassistant.helpers.entity import Entity
+
+
+def setup_platform(hass, config, add_devices, discovery_info=None):
+    add_devices([ExampleSensor()])
+
+
+class ExampleSensor(Entity):
+    @property
+    def name(self):
+        return 'Temperature'
+
+    @property
+    def state(self):
+        return 23
+
+    @property
+    def unit_of_measurement(self):
+        return TEMP_CELCIUS
+```
diff --git a/source/images/architecture/component_interaction.png b/source/images/architecture/component_interaction.png
new file mode 100644
index 0000000000000000000000000000000000000000..29df5c1da11e12260b258976f4c9960eb3432cd5
GIT binary patch
literal 30512
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
ZkM*#lI*QW}*37I*?H};tGUXS6{{v@KvTXnW

literal 0
HcmV?d00001