Metadata-Version: 2.1
Name: openaq
Version: 0.1.0
Project-URL: Documentation, https://github.com/openaq/openaq-python#readme
Project-URL: Issues, https://github.com/openaq/openaq-python/issues
Project-URL: Source, https://github.com/openaq/openaq-python
Author-email: Russ Biggs <russ@openaq.org>, Gabe Fosse <gabe@openaq.org>
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python
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 :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Requires-Python: >=3.8
Requires-Dist: httpx==0.25.0
Requires-Dist: pyhumps==3.8.0
Provides-Extra: all
Requires-Dist: orjson>=3.2.1; extra == 'all'
Description-Content-Type: text/markdown

# openaq-python

The official Python wrapper for the OpenAQ API.

> :warning: OpenAQ python is still under active development and may be unstable until a v1.0.0 release


OpenAQ Python is a low-level API wrapper for the OpenAQ Version 3 API. 

[![PyPI - Version](https://img.shields.io/pypi/v/openaq-python.svg)](https://pypi.org/project/openaq-python)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/openaq-python.svg)](https://pypi.org/project/openaq-python)

-----

**Table of Contents**

- [Installation](#installation)
- [Documentation](#documentation)
- [License](#license)

## Installation

OpenAQ python is availble on pip.

```console
pip install openaq
```


## Documentation

Coming soon...

## License

`openaq` is distributed under the terms of the [MIT](https://spdx.org/licenses/MIT.html) license.

## Development

Code is styled according to [black](https://github.com/psf/black), imports are sorted using [isort](https://pycqa.github.io/isort/) and code is linted using [ruff](https://github.com/astral-sh/ruff).

Codebase can be automatcally formatted and linted by running:

```console
hatch run style:fmt
```

style can be checked with:

```console
hatch run style:check
```

Testing uses [pytest](https://docs.pytest.org/en/7.4.x/).

```console
hatch run test:test
```

Code coverage can be viewed with:

```console
hatch run test:cov
```


## Acknowledgements

For many years [py-openaq](https://github.com/dhhagan/py-openaq) by David Hagan filled the gap for a Python API wrapper for the OpenAQ API. Thank you to David for many years of maintaining py-openaq and for taking the original step to develop a wrapper for OpenAQ.