A Python3 API for Outbreaks Near Me
Project description
🚰 pyoutbreaksnearme: A Python3 API for Outbreaks Near Me
pyoutbreaksnearme
is a Python3, asyncio-based library for getting data from
Outbreaks Near Me.
Installation
pip install pyoutbreaksnearme
Python Versions
pyoutbreaksnearme
is currently supported on:
- Python 3.10
- Python 3.11
- Python 3.12
Usage
import asyncio
from aiohttp import ClientSession
from pyoutbreaksnearme import Client
async def main() -> None:
"""Create the aiohttp session and run the example."""
client = await Client()
# Get user-reported data for the location closest to a latitude/longitude:
nearest_user_data = await client.user_data.async_get_nearest_by_coordinates(
40.7152, -73.9877
)
# Get totals for user-reported data:
user_totals_data = await client.user_data.async_get_totals()
# Get CDC data for the location closest to a latitude/longitude:
nearest_user_data = await client.cdc_data.async_get_nearest_by_coordinates(
40.7152, -73.9877
)
asyncio.run(main())
By default, the library creates a new connection to Outbreaks Near Me with each
coroutine. If you are calling a large number of coroutines (or merely want to squeeze
out every second of runtime savings possible), an aiohttp
ClientSession
can
be used for connection pooling:
import asyncio
from aiohttp import ClientSession
from pyoutbreaksnearme import Client
async def main() -> None:
"""Create the aiohttp session and run the example."""
async with ClientSession() as session:
# Create a Notion API client:
client = await Client(session=session)
# Get to work...
asyncio.run(main())
Contributing
Thanks to all of our contributors so far!
- Check for open features/bugs or initiate a discussion on one.
- Fork the repository.
- (optional, but highly recommended) Create a virtual environment:
python3 -m venv .venv
- (optional, but highly recommended) Enter the virtual environment:
source ./.venv/bin/activate
- Install the dev environment:
script/setup
- Code your new feature or bug fix on a new branch.
- Write tests that cover your new functionality.
- Run tests and ensure 100% code coverage:
poetry run pytest --cov pyoutbreaksnearme tests
- Update
README.md
with any new documentation. - Submit a pull request!
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Close
Hashes for pyoutbreaksnearme-2023.10.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | cdeee72b75cbd2e1a7205b888abd839496276d9b0123b15443b9682525ef18b1 |
|
MD5 | 140f6228786c2ad2f961d49d49738de3 |
|
BLAKE2b-256 | 6c9bb2e653c7576130ff32f1b05a310ff34ebc252f86c54dc1a1cf3e89195649 |
Close
Hashes for pyoutbreaksnearme-2023.10.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0ef52b271f2a07ee2408dc3c1e6b4712d07fc7bf6c8bd79fe12f229272a5c265 |
|
MD5 | 88d1d0afcc7749bef18ba25731178c3a |
|
BLAKE2b-256 | cabebddf304b9f277ced40adb7c7da1efa4fca5e51eb229e394e6a7bacb0f21d |