?i  dZddlmZddlZddlddlmZejdZddd d d d d ddddd Z ddZ ddZ ddZ ddZ ddZy)auPAN (Permanent Account Number, Indian income tax identifier). The Permanent Account Number (PAN) is a 10 digit alphanumeric identifier for Indian individuals, families and corporates for income tax purposes. It is also issued to foreign nationals subject to a valid visa. PAN is made up of 5 letters, 4 digits and 1 alphabetic check digit. The 4th character indicates the type of holder, the 5th character is either 1st letter of the holder's name or holder's surname in case of 'Individual' PAN, next 4 digits are serial numbers running from 0001 to 9999 and the last character is a check digit computed by an undocumented checksum algorithm. More information: * https://en.wikipedia.org/wiki/Permanent_account_number * https://incometaxindia.gov.in/tutorials/1.permanent%20account%20number%20(pan).pdf >>> validate('ACUPA7085R') 'ACUPA7085R' >>> validate('ACUPA7085RR') Traceback (most recent call last): ... InvalidLength: ... >>> validate('ABMPA32111') # check digit should be a letter Traceback (most recent call last): ... InvalidFormat: ... >>> validate('ABMXA3211G') # invalid type of holder Traceback (most recent call last): ... InvalidComponent: ... >>> validate('ACUPA0000R') # serial number should not be '0000' Traceback (most recent call last): ... InvalidComponent: ... >>> mask('AAPPV8261K') 'AAPPVXXXXK' >>> info('AAPPV8261K')['holder_type'] 'Individual' ) annotationsN)*)cleanz^[A-Z]{5}[0-9]{4}[A-Z]$zAssociation of Persons (AOP)zBody of Individuals (BOI)Companyz"Firm/Limited Liability PartnershipzGovernment AgencyzHindu Undivided Family (HUF)zLocal AuthorityzArtificial Juridical Person IndividualTrustzKrish (Trust Krish)) ABCFGHLJPTKcRt|djjS)zConvert the number to the minimal representation. This strips the number of any valid separators and removes surrounding whitespace.z -)rupperstripnumbers U/var/www/html/myprovider/mon_projet_qr/lib/python3.12/site-packages/stdnum/in_/pan.pycompactrXs#   $ $ & , , ..ct|}t|dk7r ttj |s t t ||dddk(r t|S)WCheck if the number provided is a valid PAN. This checks the length and formatting.  0000)rlen InvalidLength_pan_rematch InvalidFormatinfoInvalidComponentrs rvalidater)^sXV_F 6{bo == oL a{f  MrcJ tt|S#t$rYywxYw)rF)boolr)ValidationErrorrs ris_validr-ls)HV$%% s  ""crt|}tj|d}|s t|||ddS)z5Provide information that can be decoded from the PAN.) holder_typecard_holder_typeinitial)r_pan_holder_typesgetr()rr1s rr'r'usB V_F#''q 2K   "'!9 rc4t|}|dddz|ddzS)zNMask the PAN as per Central Board of Direct Taxes (CBDT) masking standard.NrXXXX)rrs rmaskr9s)V_F "1:  ,,r)rstrreturnr:)rr:r;r+)rr:r;zdict[str, str])__doc__ __future__rrestdnum.exceptions stdnum.utilrcompiler$r4rr)r-r'r9rrrCsp*'R#  "**/ 0 ( $  -  '  &     /  -r