Codice fiscale in Python

Presentazione

python-codicefiscale calcola un codice fiscale a partire da cognome, nome, sesso, data e luogo di nascita, e fa anche il percorso inverso. La decodifica restituisce sesso, data di nascita, luogo (nome, provincia, codice), possibili nomi, tutte le varianti di omocodia e i segmenti grezzi del codice. Due funzioni verificano la validità del codice e se si tratta di un omocodo.

La libreria riconosce il codice del luogo di nascita a partire dal nome di un comune italiano o di uno Stato estero e accetta diversi formati di data. Secondo il README, i dati vengono aggiornati ogni settimana dalla fonte ANPR. È disponibile anche un’interfaccia a riga di comando.

Punti di forza

• Codifica e decodifica del codice fiscale, più le funzioni is_valid e is_omocode.
• Supporto all’omocodia: la decodifica elenca le varianti possibili del codice.
• Riconoscimento automatico del codice del luogo di nascita (comune italiano o Stato estero) a partire dal nome.
• Dati aggiornati una volta a settimana dai dati ANPR, secondo il README.
• Interfaccia a riga di comando: python -m codicefiscale con i sottocomandi encode e decode.

Per chi

Per gli sviluppatori Python che devono calcolare, verificare o analizzare un codice fiscale, ad esempio per ricavare la data e il luogo di nascita che contiene.

Installazione

Installazione con pip da PyPI, poi importazione del modulo codicefiscale nel codice Python, oppure uso da riga di comando con python -m codicefiscale.

pip install python-codicefiscale

Leggete il README su GitHub

Punti di attenzione

• Il README avverte sulla riga di comando: se dati sensibili finiscono in un log, possono essere esposti a chi riesce ad accedere ai log.
• I suggerimenti sul nome (firstname_options) sono parziali: per un luogo di nascita italiano circa il 60% dei casi restituisce un solo nome; per un luogo estero l’elenco è vuoto.

Utilizzabile da un agente?

Libreria Python tradizionale con un’interfaccia a riga di comando. Nessun SKILL.md, AGENTS.md, CLAUDE.md, regola Cursor né server MCP trovato alla radice del repository.