You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Thanks for considering contributing your work to make Platypush a better product!
Contributions are more than welcome, and the follow the standard Gitlab procedure:
- Fork the repo.
- Prepare your changes.
- Submit a merge request.
The code should ideally have no LINT warnings/issues.
- 4 spaces to indent.
- RST format for classes and methods documentation
python generate_missing_docs.pyif you are adding new plugins/backends to automatically generate the doc templates. Make sure that you don't accidentally remove lines elements from the docs because of missing dependencies on the machine you use to generate the docs.
- Naming conventions: plugin classes are named
<Module>Pluginand backend classes are named
<Module>being the (camel-case) representation of the Python module of the plugin without the prefix - for example, the plugin under
platypush.plugins.light.huemust be named
If possible, add a test for the new functionality. If you have built a new functionality that works with some specific device or service then it's not required to write a test that mocks the whole service, but if you are changing some of the core entities (e.g. requests, events, procedures, hooks, crons or the bus) then make sure to add tests and not to break the existing tests.
If the feature requires an optional dependency then make sure to document it:
- In the class docstring (see other plugins and backends for examples)
requirements.txt- if the feature is optional then leave it commented and add a one-line comment to explain which plugin or backend requires it.