Metadata-Version: 2.4
Name: piccione
Version: 3.1.1
Summary: A Python toolkit for uploading and downloading data to external repositories and cloud services.
Project-URL: Homepage, https://github.com/opencitations/piccione
Project-URL: Documentation, https://opencitations.github.io/piccione/
Project-URL: Repository, https://github.com/opencitations/piccione
Author-email: Arcangelo Massari <arcangelo.massari@unibo.it>
License: ISC
License-File: LICENSE.md
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: ISC License (ISCL)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Requires-Dist: httpx>=0.28.1
Requires-Dist: internetarchive>=5.7.1
Requires-Dist: pyyaml>=6.0.3
Requires-Dist: redis>=4.5.5
Requires-Dist: requests>=2.32.5
Requires-Dist: rich>=14.2.0
Requires-Dist: sparqlite>=1.0.0
Requires-Dist: tqdm>=4.67.1
Description-Content-Type: text/markdown

# Piccione

<p align="center">
  <img src="docs/public/piccione.png" alt="Piccione logo" width="200">
</p>

Pronounced *Py-ccione*.

[![Run tests](https://github.com/opencitations/piccione/actions/workflows/tests.yml/badge.svg)](https://github.com/opencitations/piccione/actions/workflows/tests.yml)
[![Coverage](https://opencitations.github.io/piccione/coverage/coverage-badge.svg)](https://opencitations.github.io/piccione/coverage/)
[![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](https://opensource.org/licenses/ISC)

**PICCIONE** - Python Interface for Cloud Content Ingest and Outbound Network Export

A Python toolkit for uploading and downloading data to external repositories and cloud services.

## Installation

```bash
pip install piccione
```

## Quick start

### Upload to Figshare

```bash
python -m piccione.upload.on_figshare config.yaml
```

### Upload to Zenodo

```bash
python -m piccione.upload.on_zenodo config.yaml
```

### Upload to Internet Archive

```bash
python -m piccione.upload.on_internet_archive config.yaml
```

### Upload to triplestore

```bash
python -m piccione.upload.on_triplestore <endpoint> <folder>
```

### Download from Figshare

```bash
python -m piccione.download.from_figshare <article_id> -o <output_dir>
```

### Download from SharePoint

```bash
python -m piccione.download.from_sharepoint config.yaml <output_dir>
```

## Documentation

Full documentation: https://opencitations.github.io/piccione/

Configuration examples: [examples/](examples/)

## Development

```bash
git clone https://github.com/opencitations/piccione.git
cd piccione
uv sync --all-extras --dev
uv run pytest tests/
```

## License

ISC License - see [LICENSE.md](LICENSE.md)
