From 371ab3c213181cf2c60d7cea9f843248ea2aee4e Mon Sep 17 00:00:00 2001 From: Travis CI Date: Mon, 22 May 2017 20:42:23 +0000 Subject: [PATCH] Site updated at 2017-05-22 20:42:22 UTC --- atom.xml | 2 +- blog/categories/announcements/atom.xml | 2 +- blog/categories/community/atom.xml | 2 +- blog/categories/device-tracking/atom.xml | 2 +- blog/categories/esp8266/atom.xml | 2 +- blog/categories/how-to/atom.xml | 2 +- blog/categories/ibeacons/atom.xml | 2 +- blog/categories/internet-of-things/atom.xml | 2 +- blog/categories/iot-data/atom.xml | 2 +- blog/categories/merchandise/atom.xml | 2 +- blog/categories/micropython/atom.xml | 2 +- blog/categories/mqtt/atom.xml | 2 +- blog/categories/organisation/atom.xml | 2 +- blog/categories/owntracks/atom.xml | 2 +- blog/categories/presence-detection/atom.xml | 2 +- .../public-service-announcement/atom.xml | 2 +- blog/categories/release-notes/atom.xml | 2 +- blog/categories/survey/atom.xml | 2 +- blog/categories/talks/atom.xml | 2 +- blog/categories/technology/atom.xml | 2 +- blog/categories/user-stories/atom.xml | 2 +- blog/categories/video/atom.xml | 2 +- blog/categories/website/atom.xml | 2 +- developers/development_environment/index.html | 53 +++++++++---------- sitemap.xml | 30 +++++------ 25 files changed, 62 insertions(+), 67 deletions(-) diff --git a/atom.xml b/atom.xml index 68ffce3269..521fd64236 100644 --- a/atom.xml +++ b/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Home Assistant]]> - 2017-05-22T18:53:31+00:00 + 2017-05-22T20:37:44+00:00 https://home-assistant.io/ diff --git a/blog/categories/announcements/atom.xml b/blog/categories/announcements/atom.xml index dd0b0b0868..9e8e641b85 100644 --- a/blog/categories/announcements/atom.xml +++ b/blog/categories/announcements/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Announcements | Home Assistant]]> - 2017-05-22T18:53:31+00:00 + 2017-05-22T20:37:44+00:00 https://home-assistant.io/ diff --git a/blog/categories/community/atom.xml b/blog/categories/community/atom.xml index 5fbc888195..be0e3f0d59 100644 --- a/blog/categories/community/atom.xml +++ b/blog/categories/community/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Community | Home Assistant]]> - 2017-05-22T18:53:31+00:00 + 2017-05-22T20:37:44+00:00 https://home-assistant.io/ diff --git a/blog/categories/device-tracking/atom.xml b/blog/categories/device-tracking/atom.xml index 62a4d92bfc..93015973e8 100644 --- a/blog/categories/device-tracking/atom.xml +++ b/blog/categories/device-tracking/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Device-Tracking | Home Assistant]]> - 2017-05-22T18:53:31+00:00 + 2017-05-22T20:37:44+00:00 https://home-assistant.io/ diff --git a/blog/categories/esp8266/atom.xml b/blog/categories/esp8266/atom.xml index 46776a9723..7cf116521f 100644 --- a/blog/categories/esp8266/atom.xml +++ b/blog/categories/esp8266/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: ESP8266 | Home Assistant]]> - 2017-05-22T18:53:31+00:00 + 2017-05-22T20:37:44+00:00 https://home-assistant.io/ diff --git a/blog/categories/how-to/atom.xml b/blog/categories/how-to/atom.xml index 1cbe3c7261..49e88da432 100644 --- a/blog/categories/how-to/atom.xml +++ b/blog/categories/how-to/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: How-To | Home Assistant]]> - 2017-05-22T18:53:31+00:00 + 2017-05-22T20:37:44+00:00 https://home-assistant.io/ diff --git a/blog/categories/ibeacons/atom.xml b/blog/categories/ibeacons/atom.xml index 23bcd20b9f..82eb449f5f 100644 --- a/blog/categories/ibeacons/atom.xml +++ b/blog/categories/ibeacons/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: iBeacons | Home Assistant]]> - 2017-05-22T18:53:31+00:00 + 2017-05-22T20:37:44+00:00 https://home-assistant.io/ diff --git a/blog/categories/internet-of-things/atom.xml b/blog/categories/internet-of-things/atom.xml index 96d435796c..670cce790a 100644 --- a/blog/categories/internet-of-things/atom.xml +++ b/blog/categories/internet-of-things/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Internet-of-Things | Home Assistant]]> - 2017-05-22T18:53:31+00:00 + 2017-05-22T20:37:44+00:00 https://home-assistant.io/ diff --git a/blog/categories/iot-data/atom.xml b/blog/categories/iot-data/atom.xml index 225f5e8c55..e82c8b84d8 100644 --- a/blog/categories/iot-data/atom.xml +++ b/blog/categories/iot-data/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: IoT-Data | Home Assistant]]> - 2017-05-22T18:53:31+00:00 + 2017-05-22T20:37:44+00:00 https://home-assistant.io/ diff --git a/blog/categories/merchandise/atom.xml b/blog/categories/merchandise/atom.xml index e56f9abb3c..9ef66e8702 100644 --- a/blog/categories/merchandise/atom.xml +++ b/blog/categories/merchandise/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Merchandise | Home Assistant]]> - 2017-05-22T18:53:31+00:00 + 2017-05-22T20:37:44+00:00 https://home-assistant.io/ diff --git a/blog/categories/micropython/atom.xml b/blog/categories/micropython/atom.xml index 2ffa6bae8d..415fee6f69 100644 --- a/blog/categories/micropython/atom.xml +++ b/blog/categories/micropython/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Micropython | Home Assistant]]> - 2017-05-22T18:53:31+00:00 + 2017-05-22T20:37:44+00:00 https://home-assistant.io/ diff --git a/blog/categories/mqtt/atom.xml b/blog/categories/mqtt/atom.xml index 5cf7038232..aae482e0dc 100644 --- a/blog/categories/mqtt/atom.xml +++ b/blog/categories/mqtt/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: MQTT | Home Assistant]]> - 2017-05-22T18:53:31+00:00 + 2017-05-22T20:37:44+00:00 https://home-assistant.io/ diff --git a/blog/categories/organisation/atom.xml b/blog/categories/organisation/atom.xml index a204cbb912..d3c52478d3 100644 --- a/blog/categories/organisation/atom.xml +++ b/blog/categories/organisation/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Organisation | Home Assistant]]> - 2017-05-22T18:53:31+00:00 + 2017-05-22T20:37:44+00:00 https://home-assistant.io/ diff --git a/blog/categories/owntracks/atom.xml b/blog/categories/owntracks/atom.xml index b571ba936b..341e065a55 100644 --- a/blog/categories/owntracks/atom.xml +++ b/blog/categories/owntracks/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: OwnTracks | Home Assistant]]> - 2017-05-22T18:53:31+00:00 + 2017-05-22T20:37:44+00:00 https://home-assistant.io/ diff --git a/blog/categories/presence-detection/atom.xml b/blog/categories/presence-detection/atom.xml index 77fc32246a..4ac6caca38 100644 --- a/blog/categories/presence-detection/atom.xml +++ b/blog/categories/presence-detection/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Presence-Detection | Home Assistant]]> - 2017-05-22T18:53:31+00:00 + 2017-05-22T20:37:44+00:00 https://home-assistant.io/ diff --git a/blog/categories/public-service-announcement/atom.xml b/blog/categories/public-service-announcement/atom.xml index 59b5530ffe..533b8ae023 100644 --- a/blog/categories/public-service-announcement/atom.xml +++ b/blog/categories/public-service-announcement/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Public-Service-Announcement | Home Assistant]]> - 2017-05-22T18:53:31+00:00 + 2017-05-22T20:37:44+00:00 https://home-assistant.io/ diff --git a/blog/categories/release-notes/atom.xml b/blog/categories/release-notes/atom.xml index a643c1fb2d..bf75113f6f 100644 --- a/blog/categories/release-notes/atom.xml +++ b/blog/categories/release-notes/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Release-Notes | Home Assistant]]> - 2017-05-22T18:53:31+00:00 + 2017-05-22T20:37:44+00:00 https://home-assistant.io/ diff --git a/blog/categories/survey/atom.xml b/blog/categories/survey/atom.xml index f7debd4012..1fd53b6ce2 100644 --- a/blog/categories/survey/atom.xml +++ b/blog/categories/survey/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Survey | Home Assistant]]> - 2017-05-22T18:53:31+00:00 + 2017-05-22T20:37:44+00:00 https://home-assistant.io/ diff --git a/blog/categories/talks/atom.xml b/blog/categories/talks/atom.xml index c6802d73c8..5bba72aad6 100644 --- a/blog/categories/talks/atom.xml +++ b/blog/categories/talks/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Talks | Home Assistant]]> - 2017-05-22T18:53:31+00:00 + 2017-05-22T20:37:44+00:00 https://home-assistant.io/ diff --git a/blog/categories/technology/atom.xml b/blog/categories/technology/atom.xml index b3823e3160..1c04c1298f 100644 --- a/blog/categories/technology/atom.xml +++ b/blog/categories/technology/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Technology | Home Assistant]]> - 2017-05-22T18:53:31+00:00 + 2017-05-22T20:37:44+00:00 https://home-assistant.io/ diff --git a/blog/categories/user-stories/atom.xml b/blog/categories/user-stories/atom.xml index 550ad03242..cf1cc2a663 100644 --- a/blog/categories/user-stories/atom.xml +++ b/blog/categories/user-stories/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: User-Stories | Home Assistant]]> - 2017-05-22T18:53:31+00:00 + 2017-05-22T20:37:44+00:00 https://home-assistant.io/ diff --git a/blog/categories/video/atom.xml b/blog/categories/video/atom.xml index 9877833840..4b385e7abb 100644 --- a/blog/categories/video/atom.xml +++ b/blog/categories/video/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Video | Home Assistant]]> - 2017-05-22T18:53:31+00:00 + 2017-05-22T20:37:44+00:00 https://home-assistant.io/ diff --git a/blog/categories/website/atom.xml b/blog/categories/website/atom.xml index 2fa513d195..4534d90a74 100644 --- a/blog/categories/website/atom.xml +++ b/blog/categories/website/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Website | Home Assistant]]> - 2017-05-22T18:53:31+00:00 + 2017-05-22T20:37:44+00:00 https://home-assistant.io/ diff --git a/developers/development_environment/index.html b/developers/development_environment/index.html index d352ff005f..2a9eef0663 100644 --- a/developers/development_environment/index.html +++ b/developers/development_environment/index.html @@ -67,21 +67,12 @@

You’ll need to set up a development environment if you want to develop a new feature or component for Home Assistant. Read on to learn how to set up.

-

Setup Local Repository

-

Visit the Home Assistant repository and click Fork. -Once forked, setup your local copy of the source using the commands:

-
$ git clone https://github.com/YOUR_GIT_USERNAME/home-assistant.git
-$ cd home-assistant
-$ git remote add upstream https://github.com/home-assistant/home-assistant.git
-
-
-

Prepare Your Environment

-

Core dependencies

+

Preparing your environment

+

Developing on Linux

Install the core dependencies.

-
$ sudo apt-get install python3-pip python3-dev
+
$ sudo apt-get install python3-pip python3-dev python3-venv
 

 

-
 Platform dependencies

 
In order to run script/setup below you will need some more dependencies.

 
$ sudo apt-get install libssl-dev libxml2-dev libxslt1-dev libjpeg-dev libffi-dev libudev-dev
 

@@ -90,28 +81,38 @@ Once forked, setup your local copy of the source using the commands:

 Different distributions have different package installation mechanisms and sometimes packages names as well. For example Centos would use: sudo yum install epel-release && sudo yum install python34 python34-devel mysql-devel
 

 
Additional dependencies exist if you you plan to perform Frontend Development, please read the Frontend section to learn more.

-
 Setting up virtual environment (optional)

+
 Developing on Windows

+
If you are using Windows as a development platform, make sure that you have the correct Microsoft Visual C++ build tools installed. Check the Windows Compilers section on the Python website for details. Validation using tox will fail if this is not done correctly.

+
Also, make sure to install or upgrade the setuptools Python package. It contains compatibility improvements and adds automatic use of compilers:

+
$ pip install --upgrade setuptools
+

+

+
 Developing on OS X

+
Install Homebrew, then use that to install Python 3:

+
$ brew install python3
+

+

+
 Setup Local Repository

+
Visit the Home Assistant repository and click Fork.
+Once forked, setup your local copy of the source using the commands:

+
$ git clone https://github.com/YOUR_GIT_USERNAME/home-assistant.git
+$ cd home-assistant
+$ git remote add upstream https://github.com/home-assistant/home-assistant.git
+

+

+
 Setting up virtual environment (optional)

 
If you plan on providing isolation to your environment using venv. Within the home-assistant directory, create and activate your virtual environment.

 
$ python3 -m venv venv
 $ source venv/bin/activate
 

 

-
Note, Debian does not ship a full Python3 package and so requires you to install venv manually sudo apt-get install python3-venv.

 
 Setup and Run

-
    
-  
  • On Mac OS X and Linux:
    • 
-

 
$ cd home-assistant
 $ script/setup
 

 

 
    
-  
  • 
-    
    On Windows, you can use python setup.py develop instead of the setup script.
    
-  
    • 
-  
  • 
-    
    Run hass to invoke your local installation.
    
-  
    • 
+  
  • Run hass to invoke your local installation.
    • 
 

 
 Logging

 
By default logging in home-assistant is tuned for operating in
@@ -119,12 +120,6 @@ production (set to INFO by default, with some modules set to even less
 verbose logging levels).

 
You can use the logger component to adjust
 logging to DEBUG to see even more details about what is going on.

-
 Developing on Windows

-
If you are using Windows as a development platform, make sure that you have the correct Microsoft Visual C++ build tools installed. Check the Windows Compilers section on the Python website for details. Validation using tox will fail if this is not done correctly.

-
Also, make sure to install or upgrade the setuptools Python package. It contains compatibility improvements and adds automatic use of compilers:

-
$ pip install --upgrade setuptools
-

-