Metadata-Version: 2.1
Name: za-id-number
Version: 0.0.3
Summary: Library South African ID number validation and easy data extraction.
Home-page: https://github.com/c-goosen/za_identity_number
Author: Christo Goosen
Author-email: christogoosen@gmail.com
License: MIT
Description: # za_identity_number
        Library to validate/check and retrieve ID number info for South African IDs
        
        Current version: 0.0.3
        
        Poetry & pip compatibility
        
        Python 3.5 or greater for f-strings
        
        Installation:
        
        pip:
        ```buildoutcfg
        
        pip install za-id-number
        
        ```
        
        poetry:
        
        ```buildoutcfg
        
        poetry add za-id-number
        
        ```
        
        ZA Id Numbers:
        
        ZA id  numbers are based on a luhn algorithm validation, with the last number validating that the entire number is correct.
        
        ZA ID number is broken up into  2 digits birth year, 2 digits birth month, 2 digits birth date, 4 digits for gender, 1 digit for citizenship (za/other), 1 digit race (phased out after 1980) 1 digit for validation.
        
        For more info: https://www.westerncape.gov.za/sites/www.westerncape.gov.za/files/sa-id-number-new.png
        
        Easiest ZA ID validation is the length. The length must be exactly 13 integers.
        
        Example:
        ```
        from za_id_number.za_identity_number import SouthAfricanIdentityValidate
        
        if __name__ == "__main__":
            za_validation = SouthAfricanIdentityValidate("9202204720082")
            valid = za_validation.validate()
            za_identity = za_validation.identity()
            print(f"Valid: {valid}, Identity: {za_identity}")
        ```
        
        Methods:
        ```
        SouthAfricanIdentityValidate("9202204720082").validate()
        SouthAfricanIdentityValidate("9202204720082").identity()
        SouthAfricanIdentityValidate("9202204720082").gender()
        SouthAfricanIdentityValidate("9202204720082").citizen()
        SouthAfricanIdentityValidate("9202204720082")identity_length()
        SouthAfricanIdentityValidate("9202204720082").age()
        
        
        ```
Keywords: South Africa ID Number
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Operating System :: Unix
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: POSIX :: BSD :: FreeBSD
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Software Development
Classifier: Typing :: Typed
Requires-Python: >=3.5.0
Description-Content-Type: text/markdown
Provides-Extra: dev
