Metadata-Version: 2.4
Name: pystiller
Version: 1.1.0
Summary: A wrap around the DistillerSR APIs
Author: Lorenzo Copelli, Fulvio Barizzone, Dayana Stephanie Buzle, Rafael Vieira, Luca Belmonte
Maintainer-email: Luca Belmonte <luca.belmonte@efsa.europa.eu>
License-Expression: EUPL-1.2
Project-URL: Homepage, https://openefsa.github.io/pystiller/
Project-URL: Repository, https://github.com/openefsa/pystiller
Project-URL: Bug Tracker, https://github.com/openefsa/pystiller/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: requests>=2.32
Requires-Dist: python-dotenv>=1.0
Provides-Extra: dev
Requires-Dist: openpyxl>=3.1.5; extra == "dev"
Requires-Dist: coverage>=7.6; extra == "dev"
Requires-Dist: pytest>=8.0; extra == "dev"
Dynamic: license-file

# pystiller <img src="https://raw.githubusercontent.com/openefsa/pystiller/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 **pystiller** package provides a pool of functions to query **DistillerSR**
through its APIs. It features authentication and utilities to retrieve data
from DistillerSR projects and reports.

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

## Installation

### From PyPI

```
pip install pystiller
```

### Development version

To install the latest development version:

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

## Requirements

An active internet connection is required, as the package communicates with
DistillerSR online services to fetch and process data.

## Usage

Once installed, load the package as usual:

```python
from pystiller import *
```

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

## Authors and maintainers

- **Lorenzo Copelli** (author, [ORCID](https://orcid.org/0009-0002-4305-065X)).
- **Fulvio Barizzone** (author, [ORCID](https://orcid.org/0009-0006-3035-520X)).
- **Dayana Stephanie Buzle** (author, [ORCID](https://orcid.org/0009-0003-2990-7431)).
- **Rafael Vieira** (author, [ORCID](https://orcid.org/0009-0009-0289-5438)).
- **Luca Belmonte** (author, maintainer, [ORCID](https://orcid.org/0000-0002-7977-9170)).

## Links

- **Source code**: [GitHub - openefsa/pystiller](https://github.com/openefsa/pystiller).
- **Bug tracker**: [Issues on GitHub](https://github.com/openefsa/pystiller/issues).
- **DistillerSR API Documentation**: [https://apidocs.evidencepartners.com/](https://apidocs.evidencepartners.com/).
