python-codicefiscale

Build Status codecov Code Health Requirements Status PyPI version Py versions License

python-codicefiscale

python-codicefiscale is a tiny library for encode/decode Italian fiscal code - codifica/decodifica del Codice Fiscale.

Features

Transliteration for name/surname
Multiple birthdate formats (datetime/string) (you can see all the supported string formats in tests/tests.py )
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

Test

tox / python setup.py test / python -m unittest tests.tests

License

Released under MIT License.

Metadata

Release files for python-codicefiscale 0.3.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for python-codicefiscale 0.3.2
File	Size	Uploaded
python-codicefiscale-0.3.2.tar.gz	91.0 kB	Sep 17, 2018	Details

Release files / python-codicefiscale-0.3.2.tar.gz

Download URL	python-codicefiscale-0.3.2.tar.gz
Size	91.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`17f73da8fda5d63a32c70affe6ce6bf749b43a8e5d81872e8609394bc2958261`
BLAKE2b-256 checksum How to use checksums	`e6d7cbe6a1590137b1cf42a5a4b893ee2e0de6dd59d36b26d012561a58d6327a`
Upload date	Sep 17, 2018
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`Python-urllib/2.7`