Metadata-Version: 2.4
Name: kennitala
Version: 0.2.0
Summary: Icelandic national registry codes made easy
Home-page: https://github.com/ojake/python-kennitala
Author: Sævar Öfjörð Magnússon, Jakub Owczarski
Author-email: hallo@overcast.is
License: MIT license
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
License-File: LICENSE
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: home-page
Dynamic: license
Dynamic: license-file
Dynamic: summary

python-kennitala
================

python-kennitala is a python library for common operations on Icelandic
National Registry codes -
`kennitala <https://en.wikipedia.org/wiki/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

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 = 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 <https://pytest.org/latest>`_

To run tests simply execute:

::

    $ PYTHONPATH=./ py.test tests

