Skip to main content

South African (RSA/ZA) ID number validation and easy data extraction Library.

Project description

za_identity_number

ZA / RSA Identity Number Library to validate/check/manipulate and retrieve ID number info for South African IDs

Current version: 0.0.8

Downloads total: Downloads

Poetry & pip compatibility

Python 3.5 or greater for f-strings. Officially only support from py 3.7 >=

Installation:

pip:

pip install za-id-number

poetry:

poetry add za-id-number

ZA ID Numbers / RSA ID numbers / South African ID numbers:

ZA id numbers are validated by the luhn algorithm, 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_id_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}")

Logging

As its a library logging is off by default. To get a logger for the library you can use the following example:

    from za_id_number.za_id_number import SouthAfricanIdentityValidate
    logger = SouthAfricanIdentityValidate.get_logger(level=logging.DEBUG)
    # logger = logging.getLogger("za_id_number")
    # logger.removeHandler(logging.NullHandler())
    # logger.addHandler(logging.StreamHandler())
    za_validation = SouthAfricanIdentityValidate("9202204720082")
    valid = za_validation.validate()
    za_identity = za_validation.identity()
    logger.info(f"Valid: {valid}, Identity: {za_identity}")
    print(SouthAfricanIdentityValidate("99").identity_length())

Classes:

from za_id_number.za_id_number import (
  SouthAfricanIdentityValidate, SouthAfricanIdentityNumber,SouthAfricanIdentityGenerate)
# Validation class, inherits from SouthAfricanIdentityNumber
validate_id_obj = SouthAfricanIdentityValidate("9001245289086")

# SouthAfricanIdentityNumber class
identity_obj = SouthAfricanIdentityNumber("9001245289086")

# SouthAfricanIdentityGenerate class
generated_id_obj = SouthAfricanIdentityGenerate()

Class Attributes:

from za_id_number.za_id_number import (
  SouthAfricanIdentityValidate, SouthAfricanIdentityNumber,SouthAfricanIdentityGenerate)
# SouthAfricanIdentityValidate
SouthAfricanIdentityValidate("9202204720082").valid

# SouthAfricanIdentityNumber
SouthAfricanIdentityNumber("9202204720082").id_number
SouthAfricanIdentityNumber("9202204720082").birthdate
SouthAfricanIdentityNumber("9202204720082").year
SouthAfricanIdentityNumber("9202204720082").month
SouthAfricanIdentityNumber("9202204720082").day
SouthAfricanIdentityNumber("9202204720082").gender
SouthAfricanIdentityNumber("9202204720082").citizenship
SouthAfricanIdentityNumber("9202204720082").age

Methods:

from za_id_number.za_id_number import (
  SouthAfricanIdentityValidate, SouthAfricanIdentityNumber,SouthAfricanIdentityGenerate, generate_random_id)
# SouthAfricanIdentityNumber class
SouthAfricanIdentityNumber("9202204720082").get_age()
SouthAfricanIdentityNumber("9202204720082").get_citizenship()
SouthAfricanIdentityNumber("9202204720082").get_gender()
SouthAfricanIdentityNumber("9202204720082").calculate_birthday()
SouthAfricanIdentityNumber("9202204720082").get_month()
SouthAfricanIdentityNumber("9202204720082").get_year()
SouthAfricanIdentityNumber("9202204720082").get_day()


# SouthAfricanIdentityValidate class
# Inherits from SouthAfricanIdentityNumber
# All attributes and methods available
SouthAfricanIdentityValidate("9202204720082").valid_birth_date()
SouthAfricanIdentityValidate("9202204720082").validate()
SouthAfricanIdentityValidate("9202204720082").identity()
SouthAfricanIdentityValidate("9202204720082").identity_length()

# SouthAfricanIdentityGenerate class
# Inherits from SouthAfricanIdentityValidate
# All attributes and methods available
# gender and citizenship can be specified for specific random
# id numbers
SouthAfricanIdentityGenerate()
# or
SouthAfricanIdentityGenerate(gender="male", citizenship='citizen')
# or
from za_id_number.constants import Gender, CitizenshipClass
SouthAfricanIdentityGenerate(gender=Gender.FEMALE, citizenship=CitizenshipClass.CITIZEN_BORN)
# generate random ID number without using class obj
generate_random_id()

Questions/Ideas/Feedback

christogoosen@gmail.com christo@anomaloustech.co.za

Future features:

  • Ask for some please

CI/CD

Covers python:

Releases:

  • 0.0.7
    • Upgrade packages idenitified by github security scanning
    • Remove loguru
    • Disable loggin in library by default
    • Fixed some exceptions
    • Removed luhn library for fast-luhn
    • fast-luhn adds generate and complete functions
    • Generate Random ID numbers
    • Generate random luhn numbers of length n
  • 0.0.8
    • Removed fast-luhn library as pyo3 rust implementation not building for Mac or python greater than 3.8
    • Simplified library.
    • Security issues in dependencies updated

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

za-id-number-0.0.8.tar.gz (11.0 kB view details)

Uploaded Source

Built Distribution

za_id_number-0.0.8-py2.py3-none-any.whl (7.3 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file za-id-number-0.0.8.tar.gz.

File metadata

  • Download URL: za-id-number-0.0.8.tar.gz
  • Upload date:
  • Size: 11.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.16

File hashes

Hashes for za-id-number-0.0.8.tar.gz
Algorithm Hash digest
SHA256 7357e3d0ac750badd6c3c8650d810a6f623c89d2b63deb23b32c5b9ce7b31ab4
MD5 bc06292399d56da4fc6ce2da9d5955fa
BLAKE2b-256 c28f9f11de4e35ab4e1471966597b5cedbc137f85562a426694bab9372b413f4

See more details on using hashes here.

File details

Details for the file za_id_number-0.0.8-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for za_id_number-0.0.8-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 c93d79e819fffb905adce9ae19dc3064c406f3e545f4613a14c2939bf9efa837
MD5 243e455993d0299619cae247f071a3ac
BLAKE2b-256 962fe1fccf035c2e541f1beff486cbf187972ff73dbc2ac843d9b80ac128d73a

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page