Metadata-Version: 2.1
Name: gce-ipx800
Version: 0.6.0
Summary: Library to interact with the GCE Electronics IPX800 device
Home-page: https://github.com/marcaurele/gce-ipx800
License: Apache-2.0
Keywords: ipx800,GCE-Electronics,GCE,home-automation
Author: Marc-Aurèle Brothier
Author-email: m@brothier.org
Requires-Python: >=3.8,<4.0
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
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: Topic :: Home Automation
Classifier: Topic :: Scientific/Engineering :: Electronic Design Automation (EDA)
Requires-Dist: requests (>=2.26,<3.0)
Project-URL: Bug Tracker, https://github.com/marcaurele/gce-ipx800/issues
Project-URL: Repository, https://github.com/marcaurele/gce-ipx800
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.8+ support
* Apache 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 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 Apache License Version 2.0

