python-codicefiscale

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

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

# 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

# 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.

Supporting

⭐ Star this project on GitHub
:octocat: Follow me on GitHub
💙 Follow me on Twitter
💰 Sponsor me on Github

Metadata

Release files for python-codicefiscale 0.5.0

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.5.0
File	Size	Uploaded
python-codicefiscale-0.5.0.tar.gz	404.2 kB	Sep 26, 2022	Details

Built distribution (wheel)

Table of built distributions (wheels) for python-codicefiscale 0.5.0
File	Interpreter	ABI	Platform	Reset
python_codicefiscale-0.5.0-py3-none-any.whl 554.9 kB Sep 26, 2022	Python 3	none	any	Details

Total release size: 959.1 kB

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

Download URL	python-codicefiscale-0.5.0.tar.gz
Size	404.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`c9a1aa4d2e69d9326506ca2da5296cf16a22e7864c2e6c10dbb3a6187920e293`
BLAKE2b-256 checksum How to use checksums	`244a8bd4258d82f59ff014d35ccc0447f3df5cca95355d18fad27952a3002af6`
Upload date	Sep 26, 2022
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/56.0.0 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.8.8`

Release files / python_codicefiscale-0.5.0-py3-none-any.whl

Download URL	python_codicefiscale-0.5.0-py3-none-any.whl
Size	554.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`9a192fcf9afdc6e8124168597254bf953a7ee8f6f3ba45047c3171eec3d444f7`
BLAKE2b-256 checksum How to use checksums	`362f412f769a996757fcec58578e981ce41f4b400e67c00013ac7efca5d2dc81`
Upload date	Sep 26, 2022
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/56.0.0 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.8.8`