🌻 A clean, async-focused Python3 API for IQVIA data (https://pollen.com, https://flustar.com, etc.)
MIT License
pyiqvia
is an async-focused Python3 library for allergen, asthma, and disease data from
the IQVIAâ„¢ family of websites (such as Pollen.com,
FluStar, and more).
pyiqvia
is currently supported on:
pip install pyiqvia
import asyncio
from aiohttp import ClientSession
from pyiqvia import Client
async def main() -> None:
"""Run!"""
# Note that ZIP codes must be provided as strings:
client = Client("80012")
# Get current allergen information:
await client.allergens.current()
# Get more information on the current allergen outlook:
await client.allergens.outlook()
# Get extended forecast allergen information:
await client.allergens.extended()
# Get historic allergen information:
await client.allergens.historic()
# Get current asthma information:
await client.asthma.current()
# Get extended forecast asthma information:
await client.asthma.extended()
# Get historic asthma information:
await client.asthma.historic()
# Get current cold and flu information:
await client.disease.current()
# Get extended forecast cold and flu information:
await client.disease.extended()
# Get historic cold and flu information:
await client.disease.historic()
asyncio.run(main())
By default, pyiqvia
will retry appropriate errors 4 times (with an exponentially
increasing delay in-between). This logic can be changed by passing a different value for
request_retries
to the Client
constructor:
import asyncio
from pyiqvia import Client
async def main():
client = Client("80012", request_retries=5)
# ...
asyncio.run(main())
By default, the library creates a new connection to IQVIA 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 pyiqvia import Client
async def main() -> None:
"""Run!"""
async with ClientSession() as session:
client = Client("80012", session=session)
# ...
asyncio.run(main())
Thanks to all of our contributors so far!
python3 -m venv .venv
source ./.venv/bin/activate
script/setup
poetry run pytest --cov pyiqvia tests
README.md
with any new documentation.