## PyISY
### Python Library for the ISY Controller
This library allows for easy interaction with ISY nodes, programs, variables, and the network module. This class also allows for functions to be
assigned as handlers when ISY parameters are changed. ISY parameters can be
monitored automatically as changes are reported from the device.
**NOTE:** Significant changes have been made in V2, please refer to the [CHANGELOG](CHANGELOG.md) for details. It is recommended you do not update to the latest version without testing for any unknown breaking changes or impacts to your dependent code.
### Examples
See the [examples](examples/) folder for connection examples.
The full documentation is available at https://pyisy.readthedocs.io.
### Development Team
- Greg Laabs ([@overloadut]) - Maintainer
- Ryan Kraus ([@rmkraus]) - Creator
- Tim ([@shbatm]) - Version 2 Contributor
### Contributing
A note on contributing: contributions of any sort are more than welcome! This repo uses precommit hooks to validate all code. We use `black` to format our code, `isort` to sort our imports, `flake8` for linting and syntax checks, and `codespell` for spell check.
To use [pre-commit](https://pre-commit.com/#installation), see the installation instructions for more details.
Short version:
```shell
# From your copy of the pyisy repo folder:
pip install pre-commit
pre-commit install
```
A [VSCode DevContainer](https://code.visualstudio.com/docs/remote/containers#_getting-started) is also available to provide a consistent development environment.
Assuming you have the pre-requisites installed from the link above (VSCode, Docker, & Remote-Containers Extension), to get started:
1. Fork the repository.
2. Clone the repository to your computer.
3. Open the repository using Visual Studio code.
4. When you open this repository with Visual Studio code you are asked to "Reopen in Container", this will start the build of the container.
- If you don't see this notification, open the command palette and select Remote-Containers: Reopen Folder in Container.
5. Once started, you will also have a `test_scripts/` folder with a copy of the example scripts to run in the container which won't be committed to the repo, so you can update them with your connection details and test directly on your ISY.
[@overloadut]: https://github.com/overloadut
[@rmkraus]: https://github.com/rmkraus
[@shbatm]: https://github.com/shbatm
Raw data
{
"_id": null,
"home_page": "https://github.com/automicus/PyISY",
"name": "pyisy-beta",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "",
"keywords": "home,automation,isy,isy994,isy-994,UDI,polisy,eisy",
"author": "Ryan Kraus",
"author_email": "Ryan Kraus <automicus@gmail.com>, shbatm <support@shbatm.com>",
"download_url": "https://files.pythonhosted.org/packages/da/1f/763f82ef3e25d6e59f52a836ccd7bb941bc1bd42f3f4d849959dbcd69efc/pyisy-beta-4.0.0a4.tar.gz",
"platform": "any",
"description": "## PyISY\n\n### Python Library for the ISY Controller\n\nThis library allows for easy interaction with ISY nodes, programs, variables, and the network module. This class also allows for functions to be\nassigned as handlers when ISY parameters are changed. ISY parameters can be\nmonitored automatically as changes are reported from the device.\n\n**NOTE:** Significant changes have been made in V2, please refer to the [CHANGELOG](CHANGELOG.md) for details. It is recommended you do not update to the latest version without testing for any unknown breaking changes or impacts to your dependent code.\n\n### Examples\n\nSee the [examples](examples/) folder for connection examples.\n\nThe full documentation is available at https://pyisy.readthedocs.io.\n\n### Development Team\n\n- Greg Laabs ([@overloadut]) - Maintainer\n- Ryan Kraus ([@rmkraus]) - Creator\n- Tim ([@shbatm]) - Version 2 Contributor\n\n### Contributing\n\nA note on contributing: contributions of any sort are more than welcome! This repo uses precommit hooks to validate all code. We use `black` to format our code, `isort` to sort our imports, `flake8` for linting and syntax checks, and `codespell` for spell check.\n\nTo use [pre-commit](https://pre-commit.com/#installation), see the installation instructions for more details.\n\nShort version:\n\n```shell\n# From your copy of the pyisy repo folder:\npip install pre-commit\npre-commit install\n```\n\nA [VSCode DevContainer](https://code.visualstudio.com/docs/remote/containers#_getting-started) is also available to provide a consistent development environment.\n\nAssuming you have the pre-requisites installed from the link above (VSCode, Docker, & Remote-Containers Extension), to get started:\n\n1. Fork the repository.\n2. Clone the repository to your computer.\n3. Open the repository using Visual Studio code.\n4. When you open this repository with Visual Studio code you are asked to \"Reopen in Container\", this will start the build of the container.\n - If you don't see this notification, open the command palette and select Remote-Containers: Reopen Folder in Container.\n5. Once started, you will also have a `test_scripts/` folder with a copy of the example scripts to run in the container which won't be committed to the repo, so you can update them with your connection details and test directly on your ISY.\n\n[@overloadut]: https://github.com/overloadut\n[@rmkraus]: https://github.com/rmkraus\n[@shbatm]: https://github.com/shbatm\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Python module to talk to ISY devices from UDI.",
"version": "4.0.0a4",
"split_keywords": [
"home",
"automation",
"isy",
"isy994",
"isy-994",
"udi",
"polisy",
"eisy"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "59a522c211060ab81031ca0df382c484c602542b0285e6b45c72a6bf1d30aed4",
"md5": "5dc91212e9799ff0604779059106c4e9",
"sha256": "b2653f6c2b6f6911e15379cd229122382e7afb559440b51727011c0df537ea47"
},
"downloads": -1,
"filename": "pyisy_beta-4.0.0a4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5dc91212e9799ff0604779059106c4e9",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 77164,
"upload_time": "2023-02-08T20:21:16",
"upload_time_iso_8601": "2023-02-08T20:21:16.311522Z",
"url": "https://files.pythonhosted.org/packages/59/a5/22c211060ab81031ca0df382c484c602542b0285e6b45c72a6bf1d30aed4/pyisy_beta-4.0.0a4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "da1f763f82ef3e25d6e59f52a836ccd7bb941bc1bd42f3f4d849959dbcd69efc",
"md5": "ff9bff13ceec4aed335706189c834164",
"sha256": "3f52cb141062d96539a7ba1dfd4c0a79ebeaef0c334c6b0acd3ed322cffc257a"
},
"downloads": -1,
"filename": "pyisy-beta-4.0.0a4.tar.gz",
"has_sig": false,
"md5_digest": "ff9bff13ceec4aed335706189c834164",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 78475,
"upload_time": "2023-02-08T20:21:18",
"upload_time_iso_8601": "2023-02-08T20:21:18.084575Z",
"url": "https://files.pythonhosted.org/packages/da/1f/763f82ef3e25d6e59f52a836ccd7bb941bc1bd42f3f4d849959dbcd69efc/pyisy-beta-4.0.0a4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-02-08 20:21:18",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "automicus",
"github_project": "PyISY",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "aiohttp",
"specs": [
[
">=",
"3.8.1"
]
]
},
{
"name": "python-dateutil",
"specs": [
[
">=",
"2.8.1"
]
]
},
{
"name": "requests",
"specs": [
[
">=",
"2.28.1"
]
]
},
{
"name": "colorlog",
"specs": [
[
">=",
"6.6.0"
]
]
}
],
"lcname": "pyisy-beta"
}
JSON
