diff --git a/source/developers/maintenance.markdown b/source/developers/maintenance.markdown new file mode 100644 index 00000000000..3419830e31b --- /dev/null +++ b/source/developers/maintenance.markdown @@ -0,0 +1,42 @@ +--- +layout: page +title: "Maintenance" +description: "Steps involved to maintain the current state of Home Assistant." +date: 2016-09-13 17:00 +sidebar: true +comments: false +sharing: true +footer: true +--- + +This page documents a couple of points for maintaining the Home Assistant code. Most of the tasks don't need to be performed on a regular base thus the steps, used tools, or details are preserved here. + +### {% linkable_title Line separator %} + +People are using various operating systems to develop components and platforms for Home Assistant. This could lead to different line endings on file. We prefer `LN`. Especially Microsoft Windows tools tend to use `CRLF`. + +```bash +$ find homeassistant -name "*.py" -exec file {} \; | grep BOM +$ find homeassistant -name "*.py" -exec file {} \; | grep CRLF +``` + +To fix the line spearator, use `dos2unix` or `sed`. + +```bash +$ dos2unix homeassistant/components/notify/kodi.py +``` + +### {% linkable_title Dependencies %} + +A lot of components and platforms depends on third-party Python modules. The dependencies which are stored in the `requirements_*.txt` files are tracked by [gemnasium](https://gemnasium.com/github.com/home-assistant/home-assistant) and [Requires.io](https://requires.io/github/home-assistant/home-assistant/requirements/?branch=dev). + +If you update the requirements of a component/platform through the `REQUIREMENTS = ['modules-xyz==0.3']` entry, run the provided script to update the `requirements_*.txt` file(s). + +```bash +$ script/gen_requirements_all.py +``` + +Start a test run of Home Assistant if that was successful include all files in a Pull Request. Add a short summary of the changes, a sample configuration entry, details about the tests, and other useful information to the description. + + +