Arthur de Jong

Open Source / Free Software developer

summaryrefslogtreecommitdiffstats
path: root/tests/test_cn_ric.doctest
blob: 40ce4cf85456e44413ec6b095f252696a1142c2a (plain)
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
test_cn_ric.doctest - more detailed doctests for stdnum.cn.ric module

Copyright (C) 2014 Jiangge Zhang
Copyright (C) 2025 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


This file contains more detailed doctests for the stdnum.cn.ric. It
tries to cover more corner cases and detailed functionality that is not
really useful as module documentation.

>>> from stdnum.cn import ric
>>> from stdnum.exceptions import *  # noqa


Normal values that should just work.

>>> ric.validate('360426199101010071')
'360426199101010071'
>>> ric.validate('44011320141005001x')
'44011320141005001X'
>>> ric.format('44011320141005001x')
'44011320141005001X'


Get the birth date:

>>> ric.get_birth_date('360426199101010071')
datetime.date(1991, 1, 1)
>>> ric.get_birth_date('44011320141005001x')
datetime.date(2014, 10, 5)


Get the birth place:

>>> ric.get_birth_place('360426199101010071')
{'province': '江西省', 'county': '德安县'}
>>> ric.get_birth_place('44011320141005001x')
{'province': '广东省', 'county': '番禺区'}
>>> ric.get_birth_place('412723199010050012')
{'province': '河南省', 'county': '商水县'}
>>> ric.get_birth_place('110102199101010078')
{'province': '北京市', 'county': '西城区'}
>>> ric.get_birth_place('120110198012010073')  # before 1991
{'province': '天津市', 'county': '东郊区'}
>>> ric.get_birth_place('120110199212010072')  # after 1991
{'province': '天津市', 'county': '东丽区'}
>>> ric.get_birth_place('990426199112010074')  # unknown county
Traceback (most recent call last):
    ...
InvalidComponent: ...
>>> ric.get_birth_place('110111198012010078')  # county was not registered yet at birth year
Traceback (most recent call last):
    ...
InvalidComponent: ...
>>> ric.get_birth_place('110201199312010077')  # county was deregistered at birth year
Traceback (most recent call last):
    ...
InvalidComponent: ...


Invalid format:

>>> ric.validate('T60426199101010078')
Traceback (most recent call last):
    ...
InvalidFormat: ...


Invalid date:

>>> ric.validate('360426199113010079')
Traceback (most recent call last):
    ...
InvalidComponent: ...


Invalid checksum:

>>> ric.validate('36042619910102009X')
Traceback (most recent call last):
    ...
InvalidChecksum: ...


Invalid location:

>>> ric.validate('990426199112010074')  # unknown birth place code
Traceback (most recent call last):
    ...
InvalidComponent: ...