dhhagan / py-openaq

Python wrapper for the Open AQ API
MIT License
63 stars 10 forks source link

Build Status PyPI version Coverage Status

py-openaq

This project contains the python wrapper for the Open AQ API.

Full documentation can be found here!

Installation

pip install py-openaq

Contributing to Development

Generating Documentation

Documentation is generated using sphinx and auto-doc. Please see their respective documents for help. Docs are automatically built for each new release, but you can build them locally by navigating to the /docs directory and then issuing the following commands:

>>> make clean
>>> make notebooks
>>> make html

You can then go ahead and navigate to the /docs/_build/html directory and open them up by clicking on index.html. There is a brief explanation on how to better contribute to docs, which can be found in the README.md file within the docs/ directory!

Suggestions

If there is a feature you would like to see added, please submit as an Issue. Feel free to send pull requests if you are comfortable, otherwise another developer will try to reply to any issue requests.

Running Tests Locally

To run the tests locally:

python setup.py test

To run the tests locally with coverage:

coverage run --source openaq setup.py test

# View the report
coverage report -m

Quickstart

import openaq

api = openaq.OpenAQ()

status, resp = api.cities()