# kennitala.py - functions for handling Icelandic identity codes # coding: utf-8 # # Copyright (C) 2015 Tuomas Toivonen # Copyright (C) 2015 Arthur de Jong # # 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 """Kennitala (Icelandic personal and organisation identity code). Module for handling Icelandic personal and organisation identity codes (kennitala). >>> validate('450401-3150') # organisation '4504013150' >>> validate('120174-3399') # individual '1201743399' >>> validate('530575-0299') Traceback (most recent call last): ... InvalidChecksum: ... >>> validate('320174-3399') Traceback (most recent call last): ... InvalidComponent: ... >>> format('1201743399') '120174-3399' """ import datetime import re from stdnum.exceptions import * from stdnum.util import clean # Icelandic personal and organisation identity codes are composed of # date part, a dash, two random digits, a checksum, and a century # indicator where '9' for 1900-1999 and '0' for 2000 and beyond. For # organisations instead of birth date, the registration date is used, # and number 4 is added to the first digit. _kennitala_re = re.compile( r'^(?P[01234567]\d)(?P[01]\d)(?P\d\d)' r'(?P\d\d)(?P\d)' r'(?P[09])$') def compact(number): """Convert the kennitala to the minimal representation. This strips surrounding whitespace and separation dash, and converts it to upper case.""" return clean(number, '-').upper().strip() def checksum(number): """Calculate the checksum.""" weights = (3, 2, 7, 6, 5, 4, 3, 2, 1, 0) return sum(w * int(n) for w, n in zip(weights, number)) % 11 def validate(number): """Check if the number provided is a valid kennitala. It checks the format, whether a valid date is given and whether the check digit is correct.""" number = compact(number) match = _kennitala_re.search(number) if not match: raise InvalidFormat() day = int(match.group('day')) month = int(match.group('month')) year = int(match.group('year')) if match.group('century') == '9': year += 1900 else: year += 2000 # check if birth date or registration data is valid try: if day >= 40: # organisation datetime.date(year, month, day - 40) else: # individual datetime.date(year, month, day) except ValueError: raise InvalidComponent() # validate the checksum if checksum(number) != 0: raise InvalidChecksum() return number def is_valid(number): """Check if the number provided is a valid HETU. It checks the format, whether a valid date is given and whether the check digit is correct.""" try: return bool(validate(number)) except ValidationError: return False def format(number): """Reformat the number to the standard presentation format.""" number = compact(number) return number[:6] + '-' + number[6:]