python_awair

This is an async library which accesses portions of the Awair REST API, and it exists primarily to support the Home Assistant integration for Awair devices.

Features:

• Object-oriented approach to querying and handling data
• Supports the "user" portion of the API.
• Possible to list devices, user information, and to query for a variety of sensor data over various timeframes.

Not yet supported:

• Device API usage
• Organization API
• Device management (such as changing the display of a device)

Dive into our documentation to get started!

Status

This project could be considered in "maintenance mode". It meets the needs of the Home Assistant integration, and there are no current plans to add new features. Large PRs adding significant new features or drastically changing the library are unlikely to be accepted without prior discussion (please open an issue first).

However, bug fixes and updates to support python and/or Home Assistant compatibility are welcomed and accepted! I intend to keep passively maintaining the library, and please open an issue if there is an unaddressed need.

Development

• We manage dependencies and builds via poetry
• We use pytest and tox to test
• A variety of linters are available and CI enforces them

After installing and configuring poetry:

• Run poetry install to install dev dependencies
• Run poetry shell to drop into a virtualenv
• Run poetry run tox (or just tox if you're in a virtualenv) to test
  • Run poetry run tox -e lint (or just tox -e lint if you're in a virtualenv) to run linters.