diff options
Diffstat (limited to 'python-pyiqvia.spec')
| -rw-r--r-- | python-pyiqvia.spec | 512 |
1 files changed, 512 insertions, 0 deletions
diff --git a/python-pyiqvia.spec b/python-pyiqvia.spec new file mode 100644 index 0000000..2789a10 --- /dev/null +++ b/python-pyiqvia.spec @@ -0,0 +1,512 @@ +%global _empty_manifest_terminate_build 0 +Name: python-pyiqvia +Version: 2022.10.0 +Release: 1 +Summary: A clean, async-focused Python3 API for IQVIA data +License: MIT +URL: https://github.com/bachya/pyiqvia +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/cb/87/aa99db63d149ef105ebc4b2706b3f506cb7354a82798c6c83269d95caafa/pyiqvia-2022.10.0.tar.gz +BuildArch: noarch + +Requires: python3-aiohttp +Requires: python3-backoff + +%description +# 🌻 pyiqvia: A clean, async-focused Python3 API for IQVIA™ + +[](https://github.com/bachya/pyiqvia/actions) +[](https://pypi.python.org/pypi/pyiqvia) +[](https://pypi.python.org/pypi/pyiqvia) +[](https://github.com/bachya/pyiqvia/blob/master/LICENSE) +[](https://codecov.io/gh/bachya/pyiqvia) +[](https://codeclimate.com/github/bachya/pyiqvia/maintainability) +[](https://saythanks.io/to/bachya) + +<a href="https://www.buymeacoffee.com/bachya1208P" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/default-orange.png" alt="Buy Me A Coffee" height="41" width="174"></a> + +`pyiqvia` is an async-focused Python3 library for allergen, asthma, and disease +data from the [IQVIA™](https://www.iqvia.com) family of websites (such as +https://pollen.com, https://flustar.com, and more). + +- [Python Versions](#python-versions) +- [Installation](#installation) +- [Usage](#usage) +- [Contributing](#contributing) + +# Python Versions + +`pyiqvia` is currently supported on: + +- Python 3.9 +- Python 3.10 +- Python 3.11 + +# Installation + +```bash +pip install pyiqvia +``` + +# Usage + +```python +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()) +``` + +## Retries + +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: + +```python +import asyncio + +from pyiqvia import Client + + +async def main(): + client = Client("80012", request_retries=5) + + # ... + + +asyncio.run(main()) +``` + +## Connection Pooling + +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`](https://github.com/aio-libs/aiohttp) `ClientSession` can be used for connection +pooling: + +```python +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()) +``` + +# Contributing + +1. [Check for open features/bugs](https://github.com/bachya/pyiqvia/issues) + or [initiate a discussion on one](https://github.com/bachya/pyiqvia/issues/new). +2. [Fork the repository](https://github.com/bachya/pyiqvia/fork). +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: `nox -rs coverage` +9. Update `README.md` with any new documentation. +10. Add yourself to `AUTHORS.md`. +11. Submit a pull request! + + +%package -n python3-pyiqvia +Summary: A clean, async-focused Python3 API for IQVIA data +Provides: python-pyiqvia +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-pyiqvia +# 🌻 pyiqvia: A clean, async-focused Python3 API for IQVIA™ + +[](https://github.com/bachya/pyiqvia/actions) +[](https://pypi.python.org/pypi/pyiqvia) +[](https://pypi.python.org/pypi/pyiqvia) +[](https://github.com/bachya/pyiqvia/blob/master/LICENSE) +[](https://codecov.io/gh/bachya/pyiqvia) +[](https://codeclimate.com/github/bachya/pyiqvia/maintainability) +[](https://saythanks.io/to/bachya) + +<a href="https://www.buymeacoffee.com/bachya1208P" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/default-orange.png" alt="Buy Me A Coffee" height="41" width="174"></a> + +`pyiqvia` is an async-focused Python3 library for allergen, asthma, and disease +data from the [IQVIA™](https://www.iqvia.com) family of websites (such as +https://pollen.com, https://flustar.com, and more). + +- [Python Versions](#python-versions) +- [Installation](#installation) +- [Usage](#usage) +- [Contributing](#contributing) + +# Python Versions + +`pyiqvia` is currently supported on: + +- Python 3.9 +- Python 3.10 +- Python 3.11 + +# Installation + +```bash +pip install pyiqvia +``` + +# Usage + +```python +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()) +``` + +## Retries + +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: + +```python +import asyncio + +from pyiqvia import Client + + +async def main(): + client = Client("80012", request_retries=5) + + # ... + + +asyncio.run(main()) +``` + +## Connection Pooling + +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`](https://github.com/aio-libs/aiohttp) `ClientSession` can be used for connection +pooling: + +```python +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()) +``` + +# Contributing + +1. [Check for open features/bugs](https://github.com/bachya/pyiqvia/issues) + or [initiate a discussion on one](https://github.com/bachya/pyiqvia/issues/new). +2. [Fork the repository](https://github.com/bachya/pyiqvia/fork). +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: `nox -rs coverage` +9. Update `README.md` with any new documentation. +10. Add yourself to `AUTHORS.md`. +11. Submit a pull request! + + +%package help +Summary: Development documents and examples for pyiqvia +Provides: python3-pyiqvia-doc +%description help +# 🌻 pyiqvia: A clean, async-focused Python3 API for IQVIA™ + +[](https://github.com/bachya/pyiqvia/actions) +[](https://pypi.python.org/pypi/pyiqvia) +[](https://pypi.python.org/pypi/pyiqvia) +[](https://github.com/bachya/pyiqvia/blob/master/LICENSE) +[](https://codecov.io/gh/bachya/pyiqvia) +[](https://codeclimate.com/github/bachya/pyiqvia/maintainability) +[](https://saythanks.io/to/bachya) + +<a href="https://www.buymeacoffee.com/bachya1208P" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/default-orange.png" alt="Buy Me A Coffee" height="41" width="174"></a> + +`pyiqvia` is an async-focused Python3 library for allergen, asthma, and disease +data from the [IQVIA™](https://www.iqvia.com) family of websites (such as +https://pollen.com, https://flustar.com, and more). + +- [Python Versions](#python-versions) +- [Installation](#installation) +- [Usage](#usage) +- [Contributing](#contributing) + +# Python Versions + +`pyiqvia` is currently supported on: + +- Python 3.9 +- Python 3.10 +- Python 3.11 + +# Installation + +```bash +pip install pyiqvia +``` + +# Usage + +```python +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()) +``` + +## Retries + +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: + +```python +import asyncio + +from pyiqvia import Client + + +async def main(): + client = Client("80012", request_retries=5) + + # ... + + +asyncio.run(main()) +``` + +## Connection Pooling + +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`](https://github.com/aio-libs/aiohttp) `ClientSession` can be used for connection +pooling: + +```python +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()) +``` + +# Contributing + +1. [Check for open features/bugs](https://github.com/bachya/pyiqvia/issues) + or [initiate a discussion on one](https://github.com/bachya/pyiqvia/issues/new). +2. [Fork the repository](https://github.com/bachya/pyiqvia/fork). +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: `nox -rs coverage` +9. Update `README.md` with any new documentation. +10. Add yourself to `AUTHORS.md`. +11. Submit a pull request! + + +%prep +%autosetup -n pyiqvia-2022.10.0 + +%build +%py3_build + +%install +%py3_install +install -d -m755 %{buildroot}/%{_pkgdocdir} +if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi +if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi +if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi +if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi +pushd %{buildroot} +if [ -d usr/lib ]; then + find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/lib64 ]; then + find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/bin ]; then + find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/sbin ]; then + find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst +fi +touch doclist.lst +if [ -d usr/share/man ]; then + find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst +fi +popd +mv %{buildroot}/filelist.lst . +mv %{buildroot}/doclist.lst . + +%files -n python3-pyiqvia -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Thu Mar 09 2023 Python_Bot <Python_Bot@openeuler.org> - 2022.10.0-1 +- Package Spec generated |