Skip to main content

A clean, async-focused Python3 API for IQVIA data

Project description

🌻 pyiqvia: A clean, async-focused Python3 API for IQVIA™

CI PyPi Version License Code Coverage Maintainability Say Thanks

pyiqvia is an async-focused Python3 library for allergen, asthma, and disease data from the IQVIA™ family of websites (such as https://pollen.com, https://flustar.com, and more).

Python Versions

pyiqvia is currently supported on:

  • Python 3.6
  • Python 3.7
  • Python 3.8

Installation

pip install pyiqvia

Usage

pyiqvia starts within an aiohttp ClientSession:

import asyncio

from aiohttp import ClientSession

from pyiqvia import Client


async def main() -> None:
    """Create the aiohttp session and run the example."""
    async with ClientSession() as websession:
      # YOUR CODE HERE


asyncio.get_event_loop().run_until_complete(main())

Create a client and get to it:

import asyncio

from aiohttp import ClientSession

from pyiqvia import Client


async def main() -> None:
    """Create the aiohttp session and run the example."""
    async with ClientSession() as websession:
      client = Client(80012, websession)

      # ZIP codes starting with 0 need to be provided as strings:
      client = Client('00544', websession)

      # 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.get_event_loop().run_until_complete(main())

Contributing

  1. Check for open features/bugs or initiate a discussion on one.
  2. Fork the repository.
  3. (optional, but highly recommended) Create a virtual environment: python3 -m venv .venv
  4. (optional, but highly recommended) Enter the virtual environment: source ./venv/bin/activate
  5. Install the dev environment: script/setup
  6. Code your new feature or bug fix.
  7. Write tests that cover your new functionality.
  8. Run tests and ensure 100% code coverage: script/test
  9. Update README.md with any new documentation.
  10. Add yourself to AUTHORS.md.
  11. Submit a pull request!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyiqvia-0.2.5.tar.gz (5.2 kB view hashes)

Uploaded Source

Built Distribution

pyiqvia-0.2.5-py3-none-any.whl (6.1 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page