Metadata-Version: 2.4
Name: efsa_tools
Version: 1.0.0
Summary: EFSA ensemble of data collections tools
Author: Lorenzo Copelli, Luca Belmonte
Maintainer-email: Luca Belmonte <luca.belmonte@efsa.europa.eu>
License-Expression: EUPL-1.2
Project-URL: Homepage, https://openefsa.github.io/efsa_tools/
Project-URL: Repository, https://github.com/openefsa/efsa_tools
Project-URL: Bug Tracker, https://github.com/openefsa/efsa_tools/issues
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=2.0
Requires-Dist: pandas>=2.2
Requires-Dist: eppoPynder>=2.0.0
Requires-Dist: pystiller>=1.0.0
Provides-Extra: dev
Requires-Dist: coverage>=7.6; extra == "dev"
Requires-Dist: pytest>=8.0; extra == "dev"
Dynamic: license-file

# efsa_tools <img src="https://raw.githubusercontent.com/openefsa/efsa_tools/main/media/logo.png" height="140" align="right">

[![Lifecycle: stable](https://img.shields.io/badge/lifecycle-stable-brightgreen.svg)](https://lifecycle.r-lib.org/articles/stages.html#stable)

## Overview

The **efsa_tools** package brings together all the functions developed for
EFSA's ad hoc data collections, providing tools for dataset operations as well
as utilities designed to preserve data history.

The package is intended for researchers, analysts, and practitioners who
require convenient programmatic access to data collection utilities.

During installation, the following packages developed by EFSA are also
installed:
- **eppoPynder** - [Website](https://openefsa.github.io/eppoPynder/) | [PyPI](https://pypi.org/project/eppoPynder/).
- **pystiller** - [Website](https://openefsa.github.io/pystiller/) | [PyPI](https://pypi.org/project/pystiller/).

These packages are not required to use **efsa_tools**, but are included for
convenience and can be imported and used directly in the code if needed:

```python
import eppoPynder
# and/or
import pystiller
```

## Installation

### From PyPi

```
pip install efsa_tools
```

### Development version

To install the latest development version:

```
pip install git+https://github.com/openefsa/efsa_tools.git
```

## Usage

Once installed, load the package as usual:

```python
from efsa_tools import *
```

Basic usage examples and full documentation are available in the package
[guide](https://openefsa.github.io/efsa_tools/guide/).

## Authors and maintainers

- **Lorenzo Copelli** (author, [ORCID](https://orcid.org/0009-0002-4305-065X)).
- **Luca Belmonte** (author, maintainer, [ORCID](https://orcid.org/0000-0002-7977-9170)).

## Links

- **Source code**: [GitHub - openefsa/efsa_tools](https://github.com/openefsa/efsa_tools).
- **Bug tracker**: [Issues on GitHub](https://github.com/openefsa/efsa_tools/issues).
