python-codicefiscale is a library for encode/decode Italian fiscal code - codifica/decodifica del Codice Fiscale.
NEWAuto-updated data (once a week) directly from ANPR data-source.NEWCommand Line Interface available.- Transliteration for name/surname
- Multiple birthdate formats (date/string) (you can see all the supported string formats here)
- Automatic birthplace city/foreign-country code detection from name
- Omocodia support
pip install python-codicefiscale
from codicefiscale import codicefiscalecodicefiscale.encode( lastname="Caccamo", firstname="Fabio", gender="M", birthdate="03/04/1985", birthplace="Torino", ) # "CCCFBA85D03L219P"codicefiscale.decode("CCCFBA85D03L219P") # { # "code": "CCCFBA85D03L219P", # "gender": "M", # "birthdate": datetime.datetime(1985, 4, 3, 0, 0), # "birthplace": { # "name": "TORINO" # "province": "TO", # "code": "L219", # }, # "omocodes": [ # "CCCFBA85D03L219P", # "CCCFBA85D03L21VE", # "CCCFBA85D03L2MVP", # "CCCFBA85D03LNMVE", # "CCCFBA85D0PLNMVA", # "CCCFBA85DLPLNMVL", # "CCCFBA8RDLPLNMVX", # "CCCFBAURDLPLNMVU", # ], # "raw": { # "code": "CCCFBA85D03L219P", # "lastname": "CCC", # "firstname": "FBA", # "birthdate": "85D03", # "birthdate_year": "85" # "birthdate_month": "D", # "birthdate_day": "03", # "birthplace": "L219", # "cin": "P", # }, # }codicefiscale.is_valid("CCCFBA85D03L219P") # Truecodicefiscale.is_omocode("CCCFBA85D03L219P") # FalseCaution
If sensitive data is written to a log entry it could be exposed to an attacker who gains access to the logs.
This library can be used also as a CLI tool, for more info run:
python -m codicefiscale --helppython -m codicefiscale encode --firstname Fabio --lastname Caccamo --gender M --birthdate 03/04/1985 --birthplace Torinopython -m codicefiscale decode CCCFBA85D03L219P# clone repository git clone https://github.com/fabiocaccamo/python-codicefiscale.git && cd python-codicefiscale # create virtualenv and activate it python -m venv venv && . venv/bin/activate # upgrade pip python -m pip install --upgrade pip # install requirements pip install -r requirements.txt -r requirements-test.txt # install pre-commit to run formatters and linters pre-commit install --install-hooks # run tests using tox tox # or run tests using pytest pytestReleased under MIT License.
Follow me on -
python-benedict- dict subclass with keylist/keypath support, I/O shortcuts (base64, csv, json, pickle, plist, query-string, toml, xml, yaml) and many utilities. 📘 -
python-fontbro- friendly font operations. 🧢 -
python-fsutil- file-system utilities for lazy devs. 🧟♂️
