Metadata-Version: 2.4
Name: nettigo_air_monitor
Version: 5.0.0
Summary: Python wrapper for getting air quality data from Nettigo Air Monitor devices.
Author: Maciej Bieniek
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/bieniu/nettigo-air-monitor
Classifier: Development Status :: 5 - Production/Stable
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Typing :: Typed
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiohttp>=3.9.4
Requires-Dist: aqipy-atmotech
Requires-Dist: dacite>=1.7.0
Requires-Dist: tenacity
Provides-Extra: test
Requires-Dist: aioresponses==0.7.8; extra == "test"
Requires-Dist: coverage==7.9.1; extra == "test"
Requires-Dist: mypy==1.16.1; extra == "test"
Requires-Dist: pytest-asyncio==1.0.0; extra == "test"
Requires-Dist: pytest-cov>=2.12.1; extra == "test"
Requires-Dist: pytest-error-for-skips==2.0.2; extra == "test"
Requires-Dist: pytest-timeout==2.4.0; extra == "test"
Requires-Dist: pytest==8.4.1; extra == "test"
Requires-Dist: ruff==0.12.1; extra == "test"
Requires-Dist: syrupy==4.9.1; extra == "test"
Provides-Extra: dev
Requires-Dist: pre-commit==4.2.0; extra == "dev"
Dynamic: license-file

[![GitHub Release][releases-shield]][releases]
[![PyPI][pypi-releases-shield]][pypi-releases]
[![PyPI - Downloads][pypi-downloads]][pypi-statistics]
[![Buy me a coffee][buy-me-a-coffee-shield]][buy-me-a-coffee]
[![PayPal_Me][paypal-me-shield]][paypal-me]
[![Revolut.Me][revolut-me-shield]][revolut-me]

# nettigo-air-monitor

Python wrapper for getting air quality data from Nettigo Air Monitor devices.

[Sensor.Community firmware](https://github.com/opendata-stuttgart/sensors-software) is also supported.


## How to use package

```python
"""An example of using Nettigo Air Monitor package."""
import asyncio
import logging

from aiohttp import ClientConnectorError, ClientError, ClientSession
from tenacity import RetryError

from nettigo_air_monitor import (
    ApiError,
    AuthFailedError,
    ConnectionOptions,
    InvalidSensorDataError,
    NettigoAirMonitor,
)

logging.basicConfig(level=logging.DEBUG)

HOST = "nam"
USERNAME = "user"
PASSWORD = "password"


async def main() -> None:
    """Run main function."""
    options = ConnectionOptions(host=HOST, username=USERNAME, password=PASSWORD)

    async with ClientSession() as websession:
        nam = await NettigoAirMonitor.create(websession, options)

        try:
            data = await nam.async_update()
        except (
            TimeoutError,
            ApiError,
            AuthFailedError,
            ClientConnectorError,
            ClientError,
            InvalidSensorDataError,
            RetryError,
        ) as error:
            print(f"Error: {error}")
        else:
            print(f"Firmware: {nam.software_version}")
            print(f"MAC address: {nam.mac}")
            print(f"Latitude: {nam.latitude}, Longitude: {nam.longitude}")
            print(f"Data: {data}")


loop = asyncio.new_event_loop()
loop.run_until_complete(main())
loop.close()

```

[releases]: https://github.com/bieniu/nettigo-air-monitor/releases
[releases-shield]: https://img.shields.io/github/release/bieniu/nettigo-air-monitor.svg?style=popout
[pypi-releases]: https://pypi.org/project/nettigo-air-monitor/
[pypi-statistics]: https://pepy.tech/project/nettigo-air-monitor
[pypi-releases-shield]: https://img.shields.io/pypi/v/nettigo-air-monitor
[pypi-downloads]: https://pepy.tech/badge/nettigo-air-monitor/month
[buy-me-a-coffee-shield]: https://img.shields.io/static/v1.svg?label=%20&message=Buy%20me%20a%20coffee&color=6f4e37&logo=buy%20me%20a%20coffee&logoColor=white
[buy-me-a-coffee]: https://www.buymeacoffee.com/QnLdxeaqO
[paypal-me-shield]: https://img.shields.io/static/v1.svg?label=%20&message=PayPal.Me&logo=paypal
[paypal-me]: https://www.paypal.me/bieniu79
[revolut-me-shield]: https://img.shields.io/static/v1.svg?label=%20&message=Revolut&logo=revolut
[revolut-me]: https://revolut.me/maciejbieniek
