python-codicefiscale is a tiny library for encode/decode Italian fiscal code - codifica/decodifica del Codice Fiscale.
Project description
python-codicefiscale
python-codicefiscale is a library for encode/decode Italian fiscal code - codifica/decodifica del Codice Fiscale.
Features
NEW
Auto-updated data (once a week) directly from ANPR data-source.- 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
Installation
pip install python-codicefiscale
Usage
Import
from codicefiscale import codicefiscale
Encode
codicefiscale.encode(surname='Caccamo', name='Fabio', sex='M', birthdate='03/04/1985', birthplace='Torino')
# 'CCCFBA85D03L219P'
Decode
codicefiscale.decode('CCCFBA85D03L219P')
# {
# 'code': 'CCCFBA85D03L219P',
# 'sex': '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',
# 'surname': 'CCC',
# 'name': 'FBA',
# 'birthdate': '85D03',
# 'birthdate_year': '85'
# 'birthdate_month': 'D',
# 'birthdate_day': '03',
# 'birthplace': 'L219',
# 'cin': 'P',
# },
# }
Check
codicefiscale.is_valid('CCCFBA85D03L219P')
# True
codicefiscale.is_omocode('CCCFBA85D03L219P')
# False
Testing
# create python virtual environment
virtualenv testing_codicefiscale
# activate virtualenv
cd testing_codicefiscale && . bin/activate
# clone repo
git clone https://github.com/fabiocaccamo/python-codicefiscale.git src && cd src
# install requirements
pip install -r requirements.txt
pip install -r requirements-test.txt
# run tests using tox
tox
# or run tests using unittest
python -m unittest tests.tests
# or run tests using setuptools
python setup.py test
License
Released under MIT License.
See also
-
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. 🧟♂️
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
python-codicefiscale-0.4.0.tar.gz
(403.8 kB
view hashes)
Built Distribution
Close
Hashes for python-codicefiscale-0.4.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | faa869edd94d3d7cf7aa998368ccdc62e1efb1b443974d8e37ab79ffb82c3001 |
|
MD5 | 97e2f4d5047db56b1ba06b22677fe81c |
|
BLAKE2b-256 | f7b5048cc21a4d46152184e53809916b0eb523bfb4b2e3429bc6457c4c8d1b78 |
Close
Hashes for python_codicefiscale-0.4.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2330f84d636c2a70fe5c4541d0ad7d7632985fa05409320ea42c310f4135e05f |
|
MD5 | 7f00c8b919deeca315a6d91f34d6ee04 |
|
BLAKE2b-256 | c24507c0bb9f01790e4d4834e49bac9fce41e7bc8b075048f38bc22dbfb5f52f |