Metadata-Version: 2.4
Name: aiocamedomotic
Version: 1.14.0
Summary: Async Python library for interacting with CAME Domotic home automation systems. Provides automatic session management and device control.
License: Apache-2.0
License-File: LICENSE
Keywords: CAME,ETI/Domo,domotic,home automation,home assistant,home-assistant
Author: camedomotic-unofficial
Author-email: camedomotic-unofficial@gmail.com
Maintainer: camedomotic-unofficial
Maintainer-email: camedomotic-unofficial@gmail.com
Requires-Python: >=3.12,<4.0
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Home Automation
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: aiohttp (>=3.13.3,<4.0.0)
Requires-Dist: cryptography (>=44.0.2,<50.0.0)
Project-URL: Bug tracker, https://github.com/camedomotic-unofficial/aiocamedomotic/issues
Project-URL: Documentation, https://aiocamedomotic.readthedocs.io/latest/index.html
Project-URL: Homepage, https://github.com/camedomotic-unofficial/aiocamedomotic
Project-URL: Repository, https://github.com/camedomotic-unofficial/aiocamedomotic.git
Description-Content-Type: text/x-rst

.. SPDX-FileCopyrightText: 2026 - GitHub user: fredericks1982
.. SPDX-License-Identifier: Apache-2.0

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%20%7C%203.13%20%7C%203.14-417fb0.svg
    :target: https://www.python.org
    :alt: Python 3.12 | 3.13 | 3.14

.. 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 Library** (`aiocamedomotic <https://github.com/camedomotic-unofficial/aiocamedomotic>`_)
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.


.. important::
    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. While this library is stable and publicly released, it comes
    with no guarantees. 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.
- **Real-time updates**: Built-in long-polling support with typed update classes
  for monitoring device state changes as they happen.
- **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/latest/getting_started.html>`_
- `Usage examples <https://aiocamedomotic.readthedocs.io/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/latest/api_reference.html>`_
- `LLM-friendly docs <https://aiocamedomotic.readthedocs.io/latest/llms.txt>`_
  (also available: `full version <https://aiocamedomotic.readthedocs.io/latest/llms-full.txt>`_)
- `What's new (releases) <https://github.com/camedomotic-unofficial/aiocamedomotic/releases>`_
- `Development roadmap <https://github.com/camedomotic-unofficial/aiocamedomotic/blob/main/ROADMAP.md#development-roadmap>`_
- `Security Policy <https://github.com/camedomotic-unofficial/aiocamedomotic/blob/main/SECURITY.md#security-policy>`_
- `Contributing to Our Project <https://github.com/camedomotic-unofficial/aiocamedomotic/blob/main/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 initial 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/main/LICENSE>`_
on GitHub.

