indpy-core 0.1.4

A comprehensive library for Indian Identity and Financial data validation.

indpy 🇮🇳

indpy is a Python library for validating and generating Indian government documents and financial identifiers. It uses the official checksum algorithms (GSTIN Mod-36, Aadhaar Verhoeff) where applicable.

🚀 Features

✅ Validation

• PAN: Structure validation.
• GSTIN: Structure + Mod-36 checksum.
• Aadhaar: Regex + Verhoeff checksum.
• Voter ID (EPIC): 3 letters + 7 digits.
• Passport: 1 letter + 7 digits.
• Mobile: Indian 10-digit format (starts with 6–9).
• IFSC: Bank branch code validation.
• Vehicle (RC): Standard RTO formats (e.g., DL01CA1234).
• UPI: Standard handle validation.

🎲 Data Generation (Mock Data)

• Generate valid PAN numbers.
• Generate valid mobile numbers.
• Generate valid Aadhaar numbers (with Verhoeff checksum).
• Generate Voter ID numbers.
• Generate Passport numbers.
• Generate random vehicle registration numbers.

---

📦 Installation

Install from PyPI:

pip install indpy_core

Note: The package name on PyPI is indpy_core, but you import it in Python as indpy.

Install for local development:

# Clone the repository
git clone https://github.com/harshgupta2125/Indpy.git
cd Indpy
pip install -e .

💻 Usage

1. Python — Validation

from indpy import is_pan, is_gstin, is_vehicle, is_aadhaar, is_voterid, is_passport

# Validate PAN
if is_pan("ABCDE1234F"):
    print("Valid PAN")
else:
    print("Invalid PAN")

# Validate GSTIN (includes checksum)
if is_gstin("29ABCDE1234F1Z5"):
    print("Valid GSTIN")
else:
    print("Invalid GSTIN or checksum mismatch")

# Validate Vehicle registration
print(is_vehicle("UP16Z5555"))  # True or False

# Validate Aadhaar (Regex + Verhoeff)
print(is_aadhaar("379980670385"))  # True or False

# Validate Voter ID
print(is_voterid("ABC1234567"))  # True or False

# Validate Passport
print(is_passport("A1234567"))  # True or False

2. Python — Generating Mock Data

from indpy import Generate

# Random PAN
print(Generate.pan())     # e.g. "BPLPZ5821K"

# Random Mobile
print(Generate.mobile())  # e.g. "9876123450"

# Random Aadhaar (with valid checksum)
print(Generate.aadhaar()) # e.g. "379980670385"

# Random Voter ID
print(Generate.voterid()) # e.g. "ABC1234567"

# Random Passport
print(Generate.passport()) # e.g. "A1234567"

# Random Vehicle
print(Generate.vehicle()) # e.g. "DL04CA9921"

3. Command Line Interface

Check version:

indpy --version

Validate a document:

indpy check pan ABCDE1234F
# Output: ✅ PAN Validation Result: True

indpy check aadhaar 379980670385
# Output: ✅ AADHAAR Validation Result: True

indpy check voterid ABC1234567
# Output: ✅ VOTERID Validation Result: True

indpy check passport A1234567
# Output: ✅ PASSPORT Validation Result: True

Generate fake data:

indpy gen pan
# Output: ABCDE1234F

indpy gen vehicle
# Output: DL04CA9921

indpy gen aadhaar
# Output: 379980670385

indpy gen voterid
# Output: ABC1234567

indpy gen passport
# Output: A1234567

🛠️ Supported Documents

Document	Regex / Logic (approx.)	Checksum implemented?
PAN	^[A-Z]{5}[0-9]{4}[A-Z]$	Structure only
GSTIN	^\d{2}[A-Z]{5}[0-9A-Z]{9}$	Yes (Modulo-36)
Aadhaar	^[2-9]\d{11}$	Yes (Verhoeff)
Voter ID	^[A-Z]{3}[0-9]{7}$	N/A
Passport	^[A-Z][0-9]{7}$	N/A
Mobile	^[6-9]\d{9}$	N/A
IFSC	^[A-Z]{4}0[A-Z0-9]{6}$	N/A
Vehicle	^[A-Z]{2}\d{1,2}[A-Z]{1,2}\d{1,4}$	N/A

Note: Regex shown are illustrative and may be refined in code. GSTIN validation includes official Modulo-36 checksum verification.

🤝 Contributing

Contributions are welcome! Typical workflow:

1. Fork the repository.
2. Create a feature branch:

   git checkout -b feature/NewValidation
   

3. Commit your changes:

   git commit -m "Add Aadhaar support"
   

4. Push and open a pull request.

Please follow the existing code style and include tests for new validations.

📄 License

Distributed under the MIT License. See LICENSE for details.

---

⚠️ Don't forget

1. Replace YOUR_USERNAME in the git clone link with your actual GitHub username.
2. Push this change to GitHub so the front page updates immediately:

git add README.md
git commit -m "Update README formatting"
git push origin main