Skip to main content
Help us improve Python packaging – donate today!

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

Release history Release notifications

History Node

0.9

History Node

0.8

History Node

0.7

History Node

0.6

History Node

0.5

History Node

0.4

This version
History Node

0.3

History Node

0.2

History Node

0.1

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
codicefiscale-0.3-py2.5.egg (7.4 kB) Copy SHA256 hash SHA256 Egg 2.5 Feb 26, 2009
codicefiscale-0.3.tar.gz (12.8 kB) Copy SHA256 hash SHA256 Source None Feb 26, 2009

Supported by

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