Metadata-Version: 2.4
Name: pyvoa
Version: 0.5.0
Summary: Python virus open analysis. See more on pyvoa.org
Author-email: "pyvoa.org" <contact@pyvoa.org>
Maintainer-email: "pyvoa.org" <contact@pyvoa.org>
License: MIT License
        
        Copyright (c) 2025 pyvoa
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
Project-URL: Homepage, https://pyvoa.org
Project-URL: Repository, https://github.com/pyvoa/pyvoa
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: AUTHORS
Requires-Dist: pandas
Requires-Dist: geopandas
Requires-Dist: shapely
Requires-Dist: bs4
Requires-Dist: numpy
Requires-Dist: pycountry
Requires-Dist: pycountry_convert
Requires-Dist: requests
Requires-Dist: unidecode
Requires-Dist: lxml
Requires-Dist: IPython
Requires-Dist: contextily
Requires-Dist: html5lib
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: pytest-cov; extra == "dev"
Requires-Dist: ruff==0.16.1; extra == "dev"
Dynamic: license-file

# pyvoa

[![CI](https://github.com/pyvoa/pyvoa/actions/workflows/ci.yml/badge.svg)](https://github.com/pyvoa/pyvoa/actions/workflows/ci.yml)
[![PyPI](https://img.shields.io/pypi/v/pyvoa)](https://pypi.org/project/pyvoa/)
[![Python](https://img.shields.io/pypi/pyversions/pyvoa)](https://pypi.org/project/pyvoa/)
[![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)

[Pyvoa](https://pyvoa.org) (Python Virus Open Analysis) is a collection of Python™ code that provides:

 - easy access to COVID-19 databases, as well as other viral datasets;
 - tools to visualize and analyze data, such as time series and maps.

This environment is designed to be accessible to non-specialists: high-school students learning Python™, university students, science journalists, and even researchers who are not familiar with data extraction. Simple analyses can be performed directly, while more advanced analyses can be carried out by users experienced in Python™ programming.

Pyvoa provides access to multiple databases and delivers data in a standardized format. It also ensures seamless integration with geolocation databases (handling country or region names, enabling joins across datasets with differing descriptions, and generating maps). This geolocation information can furthermore be reused for applications beyond viral data analysis.

[You may consider the full version installation for visualize charts displays ](https://pypi.org/project/pyvoa-full/)

## Community and support

- **Questions about using pyvoa** — [GitHub Discussions](https://github.com/pyvoa/pyvoa/discussions). Beginner questions are welcome: pyvoa is meant for people who are new to data analysis.
- **Bugs and new data sources** — [open an issue](https://github.com/pyvoa/pyvoa/issues/new/choose). [SUPPORT.md](SUPPORT.md) lists the support channels and two checks worth running first, since many problems originate upstream rather than in pyvoa.
- **Contributing** — [CONTRIBUTING.md](CONTRIBUTING.md), including the checklist for [adding a new database](CONTRIBUTING.md#6-adding-a-new-database).
- **Conduct** — participation is covered by our [Code of Conduct](CODE_OF_CONDUCT.md).
- **Security or privacy concerns** — <contact@pyvoa.org>, rather than a public issue.

## Citation

If you use pyvoa in your work, please cite it. The metadata lives in
[CITATION.cff](CITATION.cff), which GitHub renders as a ready-made citation via
the *Cite this repository* button. Authorship is documented in
[AUTHORS](AUTHORS), and other contributions in [CONTRIBUTORS.md](CONTRIBUTORS.md).

## Licence

[MIT](LICENSE).

