Skip to main content

Python library for Italian fiscal code (codicefiscale)

Project description

Python library for Italian fiscal code

codicefiscale is a Python library for working with Italian fiscal code numbers officially known as Italy’s Codice Fiscale.

Copyright (C) 2009 Emanuele Rocca Homepage: http://code.google.com/p/pycodicefiscale

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA

codicefiscale Module Documentation

A quick example

>>> import datetime
>>> from codicefiscale import build
>>>
>>> build('Rocca', 'Emanuele', datetime.datetime(1983, 11, 18), 'M', 'D969')
'RCCMNL83S18D969H'

Module Contents

build(surname, name, birthday, sex, municipality) -> string

Computes the fiscal code for the given person data.

eg: build(‘Rocca’, ‘Emanuele’, datetime.datetime(1983, 11, 18), ‘M’, ‘D969’)
-> RCCMNL83S18D969H

control_code(input_string) -> int

Computes the control code for the given input_string string. The expected input_string is the first 15 characters of a fiscal code.

eg: control_code(‘RCCMNL83S18D969’) -> ‘H’

get_birthday(code) -> string

The birthday of the person whose fiscal code is ‘code’, in the format DD-MM-YY.

Unfortunately it’s not possible to guess the four digit birth year, given that the Italian fiscal code uses only the last two digits (1983 -> 83). Therefore, this function returns a string and not a datetime object.

eg: birthday(‘RCCMNL83S18D969H’) -> 18-11-83

get_sex(code) -> string

The sex of the person whose fiscal code is ‘code’.

eg: sex(‘RCCMNL83S18D969H’) -> ‘M’
sex(‘CNTCHR83T41D969D’) -> ‘F’

isvalid(code) -> bool

This function checks if the given fiscal code is syntactically valid.

eg: isvalid(‘RCCMNL83S18D969H’) -> True
isvalid(‘RCCMNL83S18D969’) -> False

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for codicefiscale, version 0.3
Filename, size & hash File type Python version Upload date
codicefiscale-0.3-py2.5.egg (7.4 kB) View hashes Egg 2.5
codicefiscale-0.3.tar.gz (12.8 kB) View hashes Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page