Metadata-Version: 2.4
Name: istat-census-data
Version: 1.4.1
Summary: Python package to download and process ISTAT census grid cell data for Italian population censuses (1991-2021)
License: MIT
License-File: LICENSE
Keywords: istat,census,gis,geospatial,italy,demographics,population
Author: Massimiliano Moraca
Author-email: gis.massimilianomoraca@gmail.com
Requires-Python: >=3.10,<4.0
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Natural Language :: Italian
Classifier: Operating System :: OS Independent
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
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Requires-Dist: chardet (>=5.2.0,<6.0.0)
Requires-Dist: geopandas (>=1.0.1,<2.0.0)
Requires-Dist: openpyxl (>=3.1.5,<4.0.0)
Requires-Dist: requests (>=2.32.0,<3.0.0)
Requires-Dist: tqdm (>=4.66.5,<5.0.0)
Requires-Dist: xlrd (>=2.0.1,<3.0.0)
Project-URL: Documentation, https://maxdragonheart.github.io/istat-census-data/
Project-URL: Homepage, https://maxdragonheart.github.io/istat-census-data/
Project-URL: Repository, https://github.com/MaxDragonheart/istat-census-data
Description-Content-Type: text/markdown

# ISTAT Cell Data

[![CI](https://github.com/MaxDragonheart/istat-census-data/actions/workflows/ci.yml/badge.svg)](https://github.com/MaxDragonheart/istat-census-data/actions/workflows/ci.yml)
[![Documentation](https://github.com/MaxDragonheart/istat-census-data/actions/workflows/docs.yml/badge.svg)](https://maxdragonheart.github.io/istat-census-data/)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
[![PyPI version](https://badge.fury.io/py/istat-census-data.svg)](https://badge.fury.io/py/istat-census-data)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

Con **ISTAT Cell Data** puoi ottenere facilmente il set di dati riferiti ai censimenti ISTAT in cui sono stati
rilasciati anche i dati delle celle censuarie.

E' possibile scaricare e processare i dati dal 1991 al 2021.

## Installazione

```bash
pip install istat-census-data
```

## Rinomina del progetto e manutenzione

`istat-census-data` è la distribuzione PyPI mantenuta a partire dalla versione 1.4.0
ed è la continuazione del precedente progetto `istatcelldata`.

Il nome della distribuzione PyPI è `istat-census-data`, mentre il package Python
da importare resta `istatcelldata`:

```python
import istatcelldata
```

La vecchia distribuzione/repository `istatcelldata` non è più mantenuta e non riceverà
nuove release. Aggiorna le dipendenze di installazione da `istatcelldata` a
`istat-census-data`; il codice Python esistente può continuare a usare
`import istatcelldata`.

## Pubblicazione release

Le nuove release PyPI devono essere pubblicate da GitHub Actions tramite PyPI Trusted
Publishing. Il workflow di rilascio non usa token PyPI salvati in locale o nei GitHub
secrets.

Prima della prima pubblicazione, configura su PyPI un pending Trusted Publisher che
corrisponda al workflow di rilascio del repository e usa un environment GitHub protetto
per approvare la pubblicazione.

Per pubblicare, crea una GitHub Release sul tag che corrisponde alla versione in
`pyproject.toml`. Lo script `release.sh` resta solo una verifica locale pre-rilascio:
non pubblica più su PyPI e non effettua il deploy della documentazione.

!!! INFO

    Questo progetto non è collegato ad ISTAT nè supportato da ISTAT ed è una iniziativa autonoma di [Massimiliano Moraca](https://massimilianomoraca.me/).

Questo repository è stato creato grazie a [MkDocs](https://www.mkdocs.org/), [Material for MkDocs](https://squidfunk.github.io/mkdocs-material) e [mkdocstring](https://mkdocstrings.github.io/).

