This repository contains multiple files, here is a overview:
File | Purpose |
---|---|
.devcontainer/* |
Used for development/testing with VSCODE, more info in the readme file in that dir. |
.github/ISSUE_TEMPLATE/feature_request.md |
Template for Feature Requests |
.github/ISSUE_TEMPLATE/issue.md |
Template for issues |
.vscode/tasks.json |
Tasks for the devcontainer. |
custom_components/dragino/translations/* |
Translation files. |
custom_components/dragino/__init__.py |
The component file for the integration. |
custom_components/dragino/api.py |
This is a sample API client. |
custom_components/dragino/binary_sensor.py |
Binary sensor platform for the integration. |
custom_components/dragino/config_flow.py |
Config flow file, this adds the UI configuration possibilities. |
custom_components/dragino/const.py |
A file to hold shared variables/constants for the entire integration. |
custom_components/dragino/manifest.json |
A manifest file for Home Assistant. |
custom_components/dragino/sensor.py |
Sensor platform for the integration. |
custom_components/dragino/switch.py |
Switch sensor platform for the integration. |
tests/__init__.py |
Makes the tests folder a module. |
tests/conftest.py |
Global fixtures used in tests to patch functions. |
tests/test_api.py |
Tests for custom_components/dragino/api.py . |
tests/test_config_flow.py |
Tests for custom_components/dragino/config_flow.py . |
tests/test_init.py |
Tests for custom_components/dragino/__init__.py . |
tests/test_switch.py |
Tests for custom_components/dragino/switch.py . |
CONTRIBUTING.md |
Guidelines on how to contribute. |
example.png |
Screenshot that demonstrate how it might look in the UI. |
info.md |
An example on a info file (used by hacs). |
LICENSE |
The license file for the project. |
README.md |
The file you are reading now, should contain info about the integration, installation and configuration instructions. |
requirements.txt |
Python packages used by this integration. |
requirements_dev.txt |
Python packages used to provide IntelliSense/code hints during development of this integration, typically includes packages in requirements.txt but may include additional packages |
requirements_test.txt |
Python packages required to run the tests for this integration, typically includes packages in requirements_dev.txt but may include additional packages |
If you want to use all the potential and features of this integration you
should use Visual Studio Code to develop in a container. In this container you
will have all the tools to ease your python development and a dedicated Home
Assistant core instance to run your integration. See .devcontainer/README.md
for more information.
If you need to work on the python library in parallel of this integration
(sampleclient
in this example) there are different options. The following one seems
easy to implement:
- Create a dedicated branch for your python library on a public git repository (example: branch
dev
onhttps://github.com/ludeeus/sampleclient
) - Update in the
manifest.json
file therequirements
key to point on your development branch ( example:"requirements": ["git+https://github.com/ludeeus/sampleclient.git@dev#devp==0.0.1beta1"]
) - Each time you need to make a modification to your python library, push it to your
development branch and increase the number of the python library version in
manifest.json
file to ensure Home Assistant update the code of the python library. (example"requirements": ["git+https://...==0.0.1beta2"]
).
README content if this was a published component:
Component to integrate with [dragino][dragino].
This component will set up the following platforms.
Platform | Description |
---|---|
binary_sensor |
Show something True or False . |
sensor |
Show info from Dragino API. |
switch |
Switch something True or False . |
- Using the tool of choice open the directory (folder) for your HA configuration (where you find
configuration.yaml
). - If you do not have a
custom_components
directory (folder) there, you need to create it. - In the
custom_components
directory (folder) create a new folder calleddragino
. - Download all the files from the
custom_components/dragino/
directory (folder) in this repository. - Place the files you downloaded in the new directory (folder) you created.
- Restart Home Assistant
- In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "Dragino"
Using your HA configuration directory (folder) as a starting point you should now also have this:
custom_components/dragino/translations/en.json
custom_components/dragino/translations/nb.json
custom_components/dragino/translations/sensor.nb.json
custom_components/dragino/__init__.py
custom_components/dragino/api.py
custom_components/dragino/binary_sensor.py
custom_components/dragino/config_flow.py
custom_components/dragino/const.py
custom_components/dragino/manifest.json
custom_components/dragino/sensor.py
custom_components/dragino/switch.py
If you want to contribute to this please read the Contribution guidelines