Metadata-Version: 2.1
Name: blebox_uniapi
Version: 2.4.2
Summary: Python API for accessing BleBox smart home devices
Home-page: https://github.com/blebox/blebox_uniapi
Author: BleBox
Author-email: opensource@blebox.eu
License: Apache Software License 2.0
Keywords: blebox_uniapi
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Requires-Python: >=3.9
Description-Content-Type: text/x-rst
License-File: LICENSE
Requires-Dist: aiohttp>=3
Requires-Dist: jmespath>1.0.0

====================
BleBox Python UniAPI
====================

.. image:: https://img.shields.io/pypi/v/blebox_uniapi.svg
        :target: https://pypi.python.org/pypi/blebox_uniapi

Python API for accessing BleBox smart home devices


* Free software: Apache Software License 2.0
* Documentation: https://blebox-uniapi.readthedocs.io.


Features
--------

* supports `11 BleBox smart home devices`_
* contains functional/integration tests
* every device supports at least minimum functionality for most common automation needs
* insight of integration level are accesible from file `box_types.py <blebox_uniapi/box_types.py#L43>`_

  (devices with apiLevel lower than defined in BOX_TYPE_CONF will not be supported but higher will)


Contributions are welcome!

Credits
-------

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage
.. _`11 BleBox smart home devices`: https://blebox.eu/produkty/?lang=en


=======
History
=======
2.4.2 (2024-06-04)
------------------
* fix: add missing support for active power sensors on switchbox/switchboxd devices by @swistakm in https://github.com/blebox/blebox_uniapi/pull/175

2.4.1 (2024-06-04)
------------------
* fix: rectify ambiguity around powerConsumption and wind sensor types

2.4.0 (2024-06-03)
------------------
* Fix: Refactor sensor_factory by @Pastucha in https://github.com/blebox/blebox_uniapi/pull/163
* Order in BOX_TYPES by @Pastucha in https://github.com/blebox/blebox_uniapi/pull/164
* Feature: smart meter by @swistakm in https://github.com/blebox/blebox_uniapi/pull/168
* Smartmeter by @pvsti in https://github.com/blebox/blebox_uniapi/pull/170
* fix: resolve regressions in cover and climate due to jmespath introduction by @swistakm in https://github.com/blebox/blebox_uniapi/pull/173

2.3.0 (2024-03-13)
------------------
* feat: add new methods to cover feature enabling handling of tilt open/close actions by @swistakm in https://github.com/blebox/blebox_uniapi/pull/154
* add support for flood sensing for multisensors as binary moisture sensor by @swistakm in https://github.com/blebox/blebox_uniapi/pull/153
* feat/fix: Add Ruff and Pre-commit Configuration, Resolve Undefined Name by @Pastucha in https://github.com/blebox/blebox_uniapi/pull/158
* gatebox and shutterbox improvements: by @swistakm in https://github.com/blebox/blebox_uniapi/pull/156
* BleBox Multisensor Illuminance Integration by @Pastucha in https://github.com/blebox/blebox_uniapi/pull/161

2.2.2 (2024-02-07)
------------------
* fixed wind reading units to get proper raw m/s value (division by 10, see PR #150)


2.2.1 (2024-01-26)
------------------
* fixed support for power measurement capabilities of switchBox and switchBoxD devices

2.2.0 (2023-08-29)
------------------
* added last_reset to energy sensor class
* added BasicAuth support to http client

2.1.4 (2023-01-03)
------------------
* added tilt position support for :code:`cover.Shutter`
* added :code:`Wind` for wind sensor of multisensors
* added :code:`Energy` sensor class for power consumption tracking
* implementing :code:`default_api_level` for
   * dimmerBox
   * wLightBox
   * wLightBoxS

2.1.3 (2022-10-27)
------------------
* thermoBox boost mode doesn't corrupt state

2.1.2 (2022-10-17)
------------------

* fixed CCT, CCTx2 modes for wLightBox v1 & v2

2.1.1 (2022-10-11)
------------------
* added support for thermoBox devices:
   * added thermoBox config to :code:`BOX_TYPE_CONFIG`
   * :code:`Climate` uses factory method implementation
   * added test coverage


2.1.0 (2022-08-05)
------------------
* added support for multiSensor API:
   * :code:`airQuality` moved to sensor module
   * new binary_sensor module, introducing :code:`Rain` class


2.0.2 (2022-07-06)
------------------
* added :code:`query_string` property in :code:`Button` class
* fixed test assertions after changes in error raised ValueError

2.0.1 (2022-06-01)
------------------
* used :code:`ValueError` type instead of :code:`BadOnValueError` in methods:

  * evaluate_brightness_from_rgb
  * apply_brightness
  * normalise_elements_of_rgb
  * _set_last_on_value
  * async_on

2.0.0 (2022-06-21)
------------------

* extended support for color modes in wLightBox devices
* initial support for tvLiftBox device
* major backward-incompatible architectural changes to enable dynamic configuration of devices
* removed products.py module and replaced with factory method on Box class
* general overhaul of public interfaces

1.3.3 (2021-05-12)
------------------

* fix support for wLightBoxS with wLightBox API
* fix state detection in gateBox

1.3.2 (2020-04-2)
------------------

* use proper module-level logger by default
* fix formatting

1.3.1 (2020-04-2)
------------------

* never skip command requests
* improve error messages

1.2.0 (2020-03-30)
------------------

* expose device info
* always add ip/port in connection errors
* fixed gateController support
* support for sauna min/max temp

1.1.0 (2020-03-24)
------------------

* fix bad wLightBox API path
* wrap api calls in semaphore (to serialize reqests to each box)
* throttle updates to 2/second (to avoid unnecessary requests)
* rework error handling and hierarchy (for cleaner usage)
* use actual device name (to help recognize the device)
* handle asyncio.TimeoutError (to handle timeout-related errors nicely)
* properly re-raise exceptions (to avoid lengthy call stacktraces)
* rename wLightBoxS feature to "brightness"

1.1.0 (2020-03-24)
------------------

* fix switchBox support
* fix minimum position handling
* drop Python 3.6 support (still may work)
* misc fixes, cleanup and increased test coverage

1.0.0 (2020-03-24)
------------------

* Fixed wLightBox issues
* Fixed wLightBoxS issues
* Fixed shutterBox issues
* Handle unknown shutterBox position
* Improved error handling + lots of new diagnostics
* Increased tests and test coverage (almost 100%)
* Lots of rework


0.1.1 (2020-03-15)
------------------

* Fixed switchBox support (newer API versions)

0.1.0 (2020-03-10)
------------------

* First release on PyPI.
