?iRzdZddlmZddlZddlmZddlddlmZm Z ddZ ddZ dd Z dd Z dd Zdd Zdd Zy)aGID number (South African Identity Document number). The South African ID number is issued to individuals within South Africa. The number consists of 13 digits and contains information about a person's date of birth, gender and whether the person is a citizen or permanent resident. More information: * https://en.wikipedia.org/wiki/South_African_identity_card * https://www.dha.gov.za/index.php/identity-documents2 >>> validate('7503305044089') '7503305044089' >>> validate('8503305044089') Traceback (most recent call last): ... InvalidChecksum: ... >>> validate('9125568') Traceback (most recent call last): ... InvalidLength: ... >>> get_gender('7503305044089') 'M' >>> get_birth_date('7503305044089') datetime.date(1975, 3, 30) >>> get_citizenship('7503305044089') 'citizen' >>> format('750330 5044089') '750330 5044 08 9' ) annotationsN)luhn)*)cleanisdigitsct|dS)zConvert the number to the minimal representation. This strips the number of any valid separators and removes surrounding whitespace.  )rnumbers U/var/www/html/myprovider/mon_projet_qr/lib/python3.12/site-packages/stdnum/za/idnr.pycompactr =s  cTt|}tjj}t |ddd|j dzzz}t |dd}t |dd}||j kDr|dz} tj|||S#t $r twxYw)zSplit the date parts from the number and return the date of birth. Since the number only uses two digits for the year, the century may be incorrect. rd)r datetimedatetodayintyear ValueErrorInvalidComponent)r rrmonthdays r get_birth_daterFs V_F MM   !E va{ sejjC&78 9D q E fQqk C ejj  !}}T5#.. !  !s <BB'c*t|}|ddvryy)z1Get the gender (M/F) from the person's ID number.r01234FM)r r s r get_genderr"Ys V_F ayGrcPt|}|ddk(ry|ddk(ryt)zAGet the citizenship status (citizen/resident) from the ID number. 0citizen1resident)r rr s r get_citizenshipr)bs2 V_F bzS s   rct|}t|s tt|dk7r t t |t |tj|S)zuCheck if the number is a valid South African ID number. This checks the length, formatting and check digit. ) r r InvalidFormatlen InvalidLengthrr)rvalidater s r r/r/msP V_F F o 6{bo6F ==  rcJ tt|S#t$rYywxYw)z7Check if the number is a valid South African ID number.F)boolr/ValidationErrorr s r is_validr3|s)HV$%% s  ""cZt|}dj|dd|dd|dd|ddfS)z8Reformat the number to the standard presentation format.r Nrr$ )r joinr s r formatr7s; V_F 88VBQZ"vb}fRSkJ KKr)r strreturnr8)r r8r9z datetime.date)r r8r9r1)__doc__ __future__rrstdnumrstdnum.exceptions stdnum.utilrrr rr"r)r/r3r7rr r@s?*>#'!&! !Lr