Codice fiscale en Python

Présentation

python-codicefiscale calcule un codice fiscale à partir du nom, du prénom, du sexe, de la date et du lieu de naissance, et fait l’opération inverse. Le décodage renvoie le sexe, la date de naissance, le lieu (nom, province, code), les prénoms possibles, toutes les variantes d’omocodia et les segments bruts du code. Deux fonctions vérifient la validité du code et s’il s’agit d’un omocode.

La bibliothèque détecte le code du lieu de naissance à partir du nom d’une commune italienne ou d’un pays étranger, et accepte plusieurs formats de date. Selon le README, ses données sont mises à jour chaque semaine depuis la source ANPR. Une interface en ligne de commande est aussi disponible.

Points forts

• Encodage et décodage du codice fiscale, plus les fonctions is_valid et is_omocode.
• Prise en charge de l’omocodia : le décodage liste les variantes possibles du code.
• Détection automatique du code du lieu de naissance (commune italienne ou pays étranger) à partir de son nom.
• Données mises à jour une fois par semaine depuis les données ANPR, d’après le README.
• Interface en ligne de commande : python -m codicefiscale avec les sous-commandes encode et decode.

Pour qui

Pour les développeurs Python qui doivent calculer, vérifier ou analyser un codice fiscale, par exemple retrouver la date et le lieu de naissance qu’il encode.

Installation

Installation par pip depuis PyPI, puis import du module codicefiscale dans le code Python, ou utilisation en ligne de commande avec python -m codicefiscale.

pip install python-codicefiscale

Lire le README sur GitHub

Points d’attention

• Le README met en garde sur la ligne de commande : si des données sensibles sont écrites dans un journal, elles peuvent être exposées à quelqu’un qui accède aux journaux.
• Les suggestions de prénoms (firstname_options) sont partielles : pour un lieu de naissance italien, environ 60 % des cas donnent un seul prénom ; pour un lieu étranger, la liste est vide.

Utilisable par un agent ?

Bibliothèque Python classique avec une interface en ligne de commande. Aucun SKILL.md, AGENTS.md, CLAUDE.md, règle Cursor ni serveur MCP trouvé à la racine du dépôt.