Skip to content

Latest commit

 

History

History
59 lines (44 loc) · 1.42 KB

README.md

File metadata and controls

59 lines (44 loc) · 1.42 KB
Raw

python-kennitala

python-kennitala is a python library for common operations on Icelandic National Registry codes - kennitala.

Capabilities

  • Validation of kennitala
  • Extraction of birth date from kennitala
  • Generating kennitala for a given birth date (for people or companies)
  • Generating random kennitala (for people or companies)
  • Recognize if kennitala belongs to person or company
  • Common formatting.

Usage

>>> from datetime import date
>>> from kennitala import Kennitala
>>>
>>> kt_no = '0101109639'
>>> kennitala = Kennitala(kt_no)
>>> kennitala.validate()
True
>>> kennitala.get_birth_date()
datetime.date(1910, 1, 1)
>>> kennitala.only_digits()
'0101109639'
>>> kennitala.with_dash()
'010110-9639'
>>> kennitala = Kennitala(kt_no.replace('3', '4'))
>>> kennitala.validate()
False
>>> kennitala.get_birht_date()
Traceback (most recent call last):
    File kennitala.py, in get_birth_date
kennitala.Invalid
>>>
>>> company_kt = Kennitala.generate(date.today(), person=False)
>>> Kennitala.is_personal(company_kt)
False

Installation

inside your virtualenv execute:

$ pip install kennitala

or download and install manually.

Tests

Tests are written for py.test

To run tests simply execute:

$ PYTHONPATH=./ py.test tests