aiocamedomotic


Nameaiocamedomotic JSON
Version 1.0.0a4 PyPI version JSON
download
home_pagehttps://github.com/camedomotic-unofficial/aiocamedomotic
SummaryPython library to interact with a CAME ETI/Domo domotic server.
upload_time2024-06-17 07:40:46
maintainercamedomotic-unofficial
docs_urlNone
authorcamedomotic-unofficial
requires_python<4.0,>=3.12
licenseApache-2.0
keywords came eti/domo domotic home automation home assistant home-assistant
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            .. Copyright 2024 - GitHub user: fredericks1982

.. Licensed under the Apache License, Version 2.0 (the "License");
.. you may not use this file except in compliance with the License.
.. You may obtain a copy of the License at

..     http://www.apache.org/licenses/LICENSE-2.0

.. Unless required by applicable law or agreed to in writing, software
.. distributed under the License is distributed on an "AS IS" BASIS,
.. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
.. See the License for the specific language governing permissions and
.. limitations under the License.

Welcome!
========

.. image:: https://img.shields.io/badge/License-Apache%202.0-D22128.svg
   :target: https://opensource.org/licenses/Apache-2.0
   :alt: License: Apache 2.0

.. image:: https://img.shields.io/badge/python-3.12-417fb0.svg
    :target: https://www.python.org
    :alt: Python 3.12

.. image:: https://sonarcloud.io/api/project_badges/measure?project=camedomotic-unofficial_aiocamedomotic&metric=security_rating
   :target: https://sonarcloud.io/project/overview?id=camedomotic-unofficial_aiocamedomotic
   :alt: SonarCloud - Security Rating

.. image:: https://sonarcloud.io/api/project_badges/measure?project=camedomotic-unofficial_aiocamedomotic&metric=vulnerabilities
   :target: https://sonarcloud.io/project/overview?id=camedomotic-unofficial_aiocamedomotic
   :alt: SonarCloud - Vulnerabilities

.. image:: https://sonarcloud.io/api/project_badges/measure?project=camedomotic-unofficial_aiocamedomotic&metric=bugs
   :target: https://sonarcloud.io/project/overview?id=camedomotic-unofficial_aiocamedomotic
   :alt: SonarCloud - Bugs

.. image:: https://readthedocs.org/projects/aiocamedomotic/badge/?version=latest
   :target: https://aiocamedomotic.readthedocs.io/en/latest/?badge=latest
   :alt: Documentation status


The **CAME Domotic Unofficial Library** provides a streamlined Python interface for
interacting with CAME Domotic plants, much like the official
`CAME Domotic app <https://www.came.com/global/itex/installers/solutions/domotica-e-termoregolazione/prodotti-compatibili-domotica/app-domotic-30>`_.
This library is designed to simplify the management of domotic devices by abstracting
the complexities of the CAME Domotic API.

Although primarily developed for use with
`Home Assistant <https://www.home-assistant.io/>`_, the library is freely available
under the `Apache license 2.0 <http://www.apache.org/licenses/LICENSE-2.0>`_ for anyone
interested in experimenting with a CAME Domotic plant.


.. warning::
    This library is currently in **beta development status**.
    It is not yet stable and should be used only for studying purposes.
    Please be aware that you cannot rely on it for any production use.
    Use at your own risk.

.. note::
    This library is independently developed and is not affiliated with, endorsed by,
    or supported by `CAME <https://www.came.com/>`_. It may not be compatible with all
    CAME Domotic systems. Use at your own risk.

.. danger::

    This library is not intended for use in critical systems, such as security or
    life-support systems. Always use official and supported tools for such applications.


Key Features
------------
- **Simplicity**: Easy interaction with domotic entities.
- **Automatic session management**: No need for manual login or session handling.
- **First of its kind**: Unique in providing integration with CAME Domotic systems.
- **Open source**: Freely available under the Apache 2.0 license, inviting
  contributions and adaptations.


Quick Start
-----------

Have a look at the following guides to learn how to install and use the library:

- `Getting started <https://aiocamedomotic.readthedocs.io/en/latest/getting_started.html>`_
- `Usage examples <https://aiocamedomotic.readthedocs.io/en/latest/usage_examples.html>`_

Once you are a bit more familiar with the library, you may want to explore the following
resources too:

- `API reference <https://aiocamedomotic.readthedocs.io/en/latest/api_reference.html>`_
- `What's new (releases) <https://github.com/camedomotic-unofficial/aiocamedomotic/releases>`_
- `Development roadmap <https://github.com/camedomotic-unofficial/aiocamedomotic/blob/master/ROADMAP.md#development-roadmap>`_
- `Security Policy <https://github.com/camedomotic-unofficial/aiocamedomotic/blob/master/SECURITY.md#security-policy>`_
- `Contributing to Our Project <https://github.com/camedomotic-unofficial/aiocamedomotic/blob/master/CONTRIBUTING.md#contributing-to-our-project>`_


Acknowledgments
---------------
Special thanks to Andrea Michielan for his foundational work with the
`eti_domo <https://github.com/andrea-michielan/eti_domo>`_ library, which greatly
facilitated the development of this library. We also found great inspiration in the Home
Assistant document
`Building a Python library for an API <https://developers.home-assistant.io/docs/api_lib_index>`_.


License
=======
This project is licensed under the Apache License 2.0. For more details, see the
`LICENSE file <https://github.com/camedomotic-unofficial/aiocamedomotic/blob/master/LICENSE>`_
on GitHub.


            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/camedomotic-unofficial/aiocamedomotic",
    "name": "aiocamedomotic",
    "maintainer": "camedomotic-unofficial",
    "docs_url": null,
    "requires_python": "<4.0,>=3.12",
    "maintainer_email": "camedomotic-unofficial@gmail.com",
    "keywords": "CAME, ETI/Domo, domotic, home automation, home assistant, home-assistant",
    "author": "camedomotic-unofficial",
    "author_email": "camedomotic-unofficial@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/60/cd/39b5429df5795376b73ae5c65095caa27e39f33bbddb5ed127b817449906/aiocamedomotic-1.0.0a4.tar.gz",
    "platform": null,
    "description": ".. Copyright 2024 - GitHub user: fredericks1982\n\n.. Licensed under the Apache License, Version 2.0 (the \"License\");\n.. you may not use this file except in compliance with the License.\n.. You may obtain a copy of the License at\n\n..     http://www.apache.org/licenses/LICENSE-2.0\n\n.. Unless required by applicable law or agreed to in writing, software\n.. distributed under the License is distributed on an \"AS IS\" BASIS,\n.. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n.. See the License for the specific language governing permissions and\n.. limitations under the License.\n\nWelcome!\n========\n\n.. image:: https://img.shields.io/badge/License-Apache%202.0-D22128.svg\n   :target: https://opensource.org/licenses/Apache-2.0\n   :alt: License: Apache 2.0\n\n.. image:: https://img.shields.io/badge/python-3.12-417fb0.svg\n    :target: https://www.python.org\n    :alt: Python 3.12\n\n.. image:: https://sonarcloud.io/api/project_badges/measure?project=camedomotic-unofficial_aiocamedomotic&metric=security_rating\n   :target: https://sonarcloud.io/project/overview?id=camedomotic-unofficial_aiocamedomotic\n   :alt: SonarCloud - Security Rating\n\n.. image:: https://sonarcloud.io/api/project_badges/measure?project=camedomotic-unofficial_aiocamedomotic&metric=vulnerabilities\n   :target: https://sonarcloud.io/project/overview?id=camedomotic-unofficial_aiocamedomotic\n   :alt: SonarCloud - Vulnerabilities\n\n.. image:: https://sonarcloud.io/api/project_badges/measure?project=camedomotic-unofficial_aiocamedomotic&metric=bugs\n   :target: https://sonarcloud.io/project/overview?id=camedomotic-unofficial_aiocamedomotic\n   :alt: SonarCloud - Bugs\n\n.. image:: https://readthedocs.org/projects/aiocamedomotic/badge/?version=latest\n   :target: https://aiocamedomotic.readthedocs.io/en/latest/?badge=latest\n   :alt: Documentation status\n\n\nThe **CAME Domotic Unofficial Library** provides a streamlined Python interface for\ninteracting with CAME Domotic plants, much like the official\n`CAME Domotic app <https://www.came.com/global/itex/installers/solutions/domotica-e-termoregolazione/prodotti-compatibili-domotica/app-domotic-30>`_.\nThis library is designed to simplify the management of domotic devices by abstracting\nthe complexities of the CAME Domotic API.\n\nAlthough primarily developed for use with\n`Home Assistant <https://www.home-assistant.io/>`_, the library is freely available\nunder the `Apache license 2.0 <http://www.apache.org/licenses/LICENSE-2.0>`_ for anyone\ninterested in experimenting with a CAME Domotic plant.\n\n\n.. warning::\n    This library is currently in **beta development status**.\n    It is not yet stable and should be used only for studying purposes.\n    Please be aware that you cannot rely on it for any production use.\n    Use at your own risk.\n\n.. note::\n    This library is independently developed and is not affiliated with, endorsed by,\n    or supported by `CAME <https://www.came.com/>`_. It may not be compatible with all\n    CAME Domotic systems. Use at your own risk.\n\n.. danger::\n\n    This library is not intended for use in critical systems, such as security or\n    life-support systems. Always use official and supported tools for such applications.\n\n\nKey Features\n------------\n- **Simplicity**: Easy interaction with domotic entities.\n- **Automatic session management**: No need for manual login or session handling.\n- **First of its kind**: Unique in providing integration with CAME Domotic systems.\n- **Open source**: Freely available under the Apache 2.0 license, inviting\n  contributions and adaptations.\n\n\nQuick Start\n-----------\n\nHave a look at the following guides to learn how to install and use the library:\n\n- `Getting started <https://aiocamedomotic.readthedocs.io/en/latest/getting_started.html>`_\n- `Usage examples <https://aiocamedomotic.readthedocs.io/en/latest/usage_examples.html>`_\n\nOnce you are a bit more familiar with the library, you may want to explore the following\nresources too:\n\n- `API reference <https://aiocamedomotic.readthedocs.io/en/latest/api_reference.html>`_\n- `What's new (releases) <https://github.com/camedomotic-unofficial/aiocamedomotic/releases>`_\n- `Development roadmap <https://github.com/camedomotic-unofficial/aiocamedomotic/blob/master/ROADMAP.md#development-roadmap>`_\n- `Security Policy <https://github.com/camedomotic-unofficial/aiocamedomotic/blob/master/SECURITY.md#security-policy>`_\n- `Contributing to Our Project <https://github.com/camedomotic-unofficial/aiocamedomotic/blob/master/CONTRIBUTING.md#contributing-to-our-project>`_\n\n\nAcknowledgments\n---------------\nSpecial thanks to Andrea Michielan for his foundational work with the\n`eti_domo <https://github.com/andrea-michielan/eti_domo>`_ library, which greatly\nfacilitated the development of this library. We also found great inspiration in the Home\nAssistant document\n`Building a Python library for an API <https://developers.home-assistant.io/docs/api_lib_index>`_.\n\n\nLicense\n=======\nThis project is licensed under the Apache License 2.0. For more details, see the\n`LICENSE file <https://github.com/camedomotic-unofficial/aiocamedomotic/blob/master/LICENSE>`_\non GitHub.\n\n",
    "bugtrack_url": null,
    "license": "Apache-2.0",
    "summary": "Python library to interact with a CAME ETI/Domo domotic server.",
    "version": "1.0.0a4",
    "project_urls": {
        "Bug tracker": "https://github.com/camedomotic-unofficial/aiocamedomotic/issues",
        "Documentation": "https://aiocamedomotic.readthedocs.io/latest/index.html",
        "Homepage": "https://github.com/camedomotic-unofficial/aiocamedomotic",
        "Repository": "https://github.com/camedomotic-unofficial/aiocamedomotic.git"
    },
    "split_keywords": [
        "came",
        " eti/domo",
        " domotic",
        " home automation",
        " home assistant",
        " home-assistant"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "ba1d78c9f5793cd3e6377e9e9f703d5ae59d59667f6e4831dbdb64204e19b362",
                "md5": "d0aa06cc45ba96cd40ec03cacbae962d",
                "sha256": "ee914a3b8cd3ec62bcd2a92a499c886defe832c8747896d1e2f52aa7b669c1ae"
            },
            "downloads": -1,
            "filename": "aiocamedomotic-1.0.0a4-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "d0aa06cc45ba96cd40ec03cacbae962d",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<4.0,>=3.12",
            "size": 22228,
            "upload_time": "2024-06-17T07:40:44",
            "upload_time_iso_8601": "2024-06-17T07:40:44.163215Z",
            "url": "https://files.pythonhosted.org/packages/ba/1d/78c9f5793cd3e6377e9e9f703d5ae59d59667f6e4831dbdb64204e19b362/aiocamedomotic-1.0.0a4-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "60cd39b5429df5795376b73ae5c65095caa27e39f33bbddb5ed127b817449906",
                "md5": "ff0ff2c1a2647d56a7703b9878af3848",
                "sha256": "13266b738d50b6fbe251d091692a7ff8d7420fbb0cbb069736a0e81fa7c8450b"
            },
            "downloads": -1,
            "filename": "aiocamedomotic-1.0.0a4.tar.gz",
            "has_sig": false,
            "md5_digest": "ff0ff2c1a2647d56a7703b9878af3848",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<4.0,>=3.12",
            "size": 17118,
            "upload_time": "2024-06-17T07:40:46",
            "upload_time_iso_8601": "2024-06-17T07:40:46.545805Z",
            "url": "https://files.pythonhosted.org/packages/60/cd/39b5429df5795376b73ae5c65095caa27e39f33bbddb5ed127b817449906/aiocamedomotic-1.0.0a4.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-06-17 07:40:46",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "camedomotic-unofficial",
    "github_project": "aiocamedomotic",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "aiocamedomotic"
}
        
Elapsed time: 0.27199s