Metadata-Version: 2.4
Name: gce-ipx800
Version: 0.8.0
Summary: Library to interact with the GCE Electronics IPX800 device
Project-URL: Homepage, https://github.com/marcaurele/gce-ipx800
Project-URL: Repository, https://github.com/marcaurele/gce-ipx800
Project-URL: Bug Tracker, https://github.com/marcaurele/gce-ipx800/issues
Author-email: Marc-Aurèle Brothier <m@brothier.org>
License-Expression: AGPL-3.0-or-later
License-File: LICENSE
Keywords: GCE,GCE-Electronics,home-automation,ipx800
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Home Automation
Classifier: Topic :: Scientific/Engineering :: Electronic Design Automation (EDA)
Requires-Python: <4,>=3.9
Requires-Dist: requests<3,>=2.26
Description-Content-Type: text/x-rst

GCE-IPX800
==========

.. image:: https://img.shields.io/pypi/v/gce-ipx800?color=blue
   :alt: Pypi version
   :target: https://pypi.org/project/gce-ipx800/

.. image:: https://github.com/marcaurele/gce-ipx800/workflows/Build%20status/badge.svg
   :alt: Build Status
   :target: https://github.com/marcaurele/gce-ipx800/actions

.. image:: https://codecov.io/gh/marcaurele/gce-ipx800/branch/main/graph/badge.svg
   :alt: Code coverage
   :target: https://codecov.io/gh/marcaurele/gce-ipx800

.. image:: https://img.shields.io/pypi/l/gce-ipx800.svg
   :alt: License
   :target: https://pypi.org/project/gce-ipx800/

.. image:: https://img.shields.io/pypi/pyversions/gce-ipx800.svg
   :alt: Python versions
   :target: https://pypi.org/project/gce-ipx800/

A python library to control a GCE-Electronics IPX800 V4 device through its API.

* Python 3.9+ support
* AGPL-3.0 license

IPX800 features implemented
---------------------------

* Analog sensors (``ipx.analogs[]``)
* Control:

  - relays (``ipx.relays[]``)
  - virtual inputs (``ipx.virtual_inputs[]``)
  - virtual outputs (``ipx.virtual_outputs[]``)

* Counters (``ipx.counters[]``)

Installation
------------

.. code-block:: console

    > pip install gce-ipx800

Usage
-----

.. note:: The default API key of the device is `apikey`.

.. code-block:: python

    from gce_ipx800 import ipx800

    ipx = ipx800("http://your-device-ip", "apikey")

    r4 = ipx.relays[3]

    r4.status  # => return a Boolean

    r4.on()

    r4.off()

    r4.toggle()

    len(ipx.relays)  # => 56

Links
-----

* GCE IPX800 V4 API: https://gce.ovh/wiki/index.php?title=API_V4

Licence
-------

Licensed under GNU Affero General Public License v3.0
