1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
|
# rrn.py - functions for handling South Korean RRN numbers
# coding: utf-8
#
# Copyright (C) 2019 Dimitri Papadopoulos
# Copyright (C) 2019 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
"""RRN (South Korean resident registration number).
The RRN (resident registration number, 주민등록번호) is a 13-digit number
issued to all residents of the Republic of Korea. Foreigners residing in the
Republic of Korea receive an alien registration number (ARN) which follows
the same encoding pattern.
The first six digits code the date of birth. The seventh digit encodes the
century and gender. The next four digits encode the place of birth for
Koreans or the issuing agency for foreigners, followed by two digits for the
community center number, one serial number and a check digit.
More information:
* http://www.law.go.kr/lsSc.do?tabMenuId=tab18&p1=&subMenu=1&nwYn=1§ion=&tabNo=&query=%EA%B0%9C%EC%9D%B8%EC%A0%95%EB%B3%B4%20%EB%B3%B4%ED%98%B8%EB%B2%95
* https://en.wikipedia.org/wiki/Resident_registration_number
* https://techscience.org/a/2015092901/
>>> validate('971013-9019902')
'9710139019902'
>>> validate('971013-9019903') # incorrect checksum
Traceback (most recent call last):
...
InvalidChecksum: ...
"""
import datetime
from stdnum.exceptions import *
from stdnum.util import clean, isdigits
def compact(number):
"""Convert the number to the minimal representation. This strips the
number of any valid separators and removes surrounding whitespace."""
return clean(number, '-').strip()
def calc_check_digit(number):
"""Calculate the check digit."""
weights = (2, 3, 4, 5, 6, 7, 8, 9, 2, 3, 4, 5)
check = sum(w * int(n) for w, n in zip(weights, number))
return str((11 - (check % 11)) % 10)
def get_birth_date(number, allow_future=True):
"""Split the date parts from the number and return the birth date. If
allow_future is False birth dates in the future are rejected."""
number = compact(number)
year = int(number[0:2])
month = int(number[2:4])
day = int(number[4:6])
if number[6] in '1256': # born 1900-1999
year += 1900
elif number[6] in '3478': # born 2000-2099
year += 2000
else: # born 1800-1899
year += 1800
try:
date_of_birth = datetime.date(year, month, day)
except ValueError:
raise InvalidComponent()
else:
# The resident registration number is given to each Korean citizen
# at birth or by naturalization, although the resident registration
# card is issued upon the 17th birthday.
if not allow_future and date_of_birth >= datetime.date.today():
raise InvalidComponent()
return date_of_birth
def validate(number, allow_future=True):
"""Check if the number is a valid RNN. This checks the length, formatting
and check digit. If allow_future is False birth dates in the future are
rejected."""
number = compact(number)
if not isdigits(number):
raise InvalidFormat()
if len(number) != 13:
raise InvalidLength()
get_birth_date(number, allow_future)
place_of_birth = int(number[7:9])
if place_of_birth > 96:
raise InvalidComponent()
# We cannot check the community center (CC), any information on
# valid/invalid CC digits is welcome.
if number[-1] != calc_check_digit(number[:-1]):
raise InvalidChecksum()
return number
def is_valid(number, allow_future=True):
"""Check if the number provided is valid."""
try:
return bool(validate(number, allow_future))
except ValidationError:
return False
def format(number):
"""Reformat the number to the standard presentation format."""
number = compact(number)
if len(number) == 13:
number = number[:6] + '-' + number[6:]
return number
|