india-kit 0.1.0__py3-none-any.whl

india_kit/__init__.py

@@ -0,0 +1,19 @@
+from .identity.pan import validate_pan, mask_pan, mock_pan
+from .identity.aadhaar import validate_aadhaar, mock_aadhaar
+from .identity.gstin import validate_gstin, mock_gstin
+from .banking.ifsc import validate_ifsc, lookup_ifsc
+from .banking.upi import validate_upi
+from .address.pincode import validate_pincode, lookup_pincode
+from .finance.gst import split_gst
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "validate_pan", "mask_pan", "mock_pan",
+    "validate_aadhaar", "mock_aadhaar",
+    "validate_gstin", "mock_gstin",
+    "validate_ifsc", "lookup_ifsc",
+    "validate_upi",
+    "validate_pincode", "lookup_pincode",
+    "split_gst",
+]

india_kit/address/__init__.py

@@ -0,0 +1,3 @@
+from .pincode import validate_pincode, lookup_pincode
+
+__all__ = ["validate_pincode", "lookup_pincode"]

india_kit/address/pincode.py

@@ -0,0 +1,29 @@
+import re
+
+_PINCODE_RE = re.compile(r'^[1-9][0-9]{5}$')
+
+_PINCODE_DB = {
+    "110001": {"district": "Central Delhi", "state": "Delhi"},
+    "400001": {"district": "Mumbai City", "state": "Maharashtra"},
+    "560001": {"district": "Bangalore Urban", "state": "Karnataka"},
+    "600001": {"district": "Chennai", "state": "Tamil Nadu"},
+    "500001": {"district": "Hyderabad", "state": "Telangana"},
+    "700001": {"district": "Kolkata", "state": "West Bengal"},
+    "380001": {"district": "Ahmedabad", "state": "Gujarat"},
+    "411001": {"district": "Pune", "state": "Maharashtra"},
+    "302001": {"district": "Jaipur", "state": "Rajasthan"},
+    "226001": {"district": "Lucknow", "state": "Uttar Pradesh"},
+}
+
+
+def validate_pincode(pin: str) -> dict:
+    if not isinstance(pin, str):
+        return {"valid": False, "reason": "must be a string"}
+    p = pin.strip()
+    if not _PINCODE_RE.match(p):
+        return {"valid": False, "reason": "invalid pincode (must be 6 digits, first digit 1-9)"}
+    return {"valid": True}
+
+
+def lookup_pincode(pin: str) -> dict | None:
+    return _PINCODE_DB.get(pin.strip())

india_kit/banking/__init__.py

@@ -0,0 +1,4 @@
+from .ifsc import validate_ifsc, lookup_ifsc
+from .upi import validate_upi
+
+__all__ = ["validate_ifsc", "lookup_ifsc", "validate_upi"]

india_kit/banking/ifsc.py

@@ -0,0 +1,25 @@
+import re
+
+_IFSC_RE = re.compile(r'^[A-Z]{4}0[A-Z0-9]{6}$')
+
+_IFSC_DB = {
+    "SBIN0000001": {"bank": "State Bank of India", "branch": "Mumbai Main", "city": "Mumbai"},
+    "HDFC0000002": {"bank": "HDFC Bank", "branch": "Delhi Main", "city": "Delhi"},
+    "ICIC0000003": {"bank": "ICICI Bank", "branch": "Bangalore Main", "city": "Bangalore"},
+    "AXIS0000004": {"bank": "Axis Bank", "branch": "Chennai Main", "city": "Chennai"},
+    "KKBK0000005": {"bank": "Kotak Mahindra Bank", "branch": "Pune Main", "city": "Pune"},
+}
+
+
+def validate_ifsc(ifsc: str) -> dict:
+    if not isinstance(ifsc, str):
+        return {"valid": False, "reason": "must be a string"}
+    i = ifsc.strip().upper()
+    if not _IFSC_RE.match(i):
+        return {"valid": False, "reason": "invalid IFSC format (expected AAAA0XXXXXX)"}
+    return {"valid": True}
+
+
+def lookup_ifsc(ifsc: str) -> dict | None:
+    i = ifsc.strip().upper()
+    return _IFSC_DB.get(i)

india_kit/banking/upi.py

@@ -0,0 +1,11 @@
+import re
+
+_UPI_RE = re.compile(r'^[a-zA-Z0-9._+%\-]{2,}@[a-zA-Z]{2,}$')
+
+
+def validate_upi(vpa: str) -> dict:
+    if not isinstance(vpa, str):
+        return {"valid": False, "reason": "must be a string"}
+    if not _UPI_RE.match(vpa.strip()):
+        return {"valid": False, "reason": "invalid UPI VPA format (expected localpart@bank)"}
+    return {"valid": True}

india_kit/finance/__init__.py

@@ -0,0 +1,3 @@
+from .gst import split_gst
+
+__all__ = ["split_gst"]

india_kit/finance/gst.py

@@ -0,0 +1,6 @@
+def split_gst(amount: float, rate_percent: float, intra_state: bool = True) -> dict:
+    total_tax = round(amount * rate_percent / 100, 2)
+    if intra_state:
+        half = round(total_tax / 2, 2)
+        return {"cgst": half, "sgst": half, "igst": 0.0, "total_tax": total_tax}
+    return {"cgst": 0.0, "sgst": 0.0, "igst": total_tax, "total_tax": total_tax}

india_kit/identity/__init__.py

@@ -0,0 +1,9 @@
+from .pan import validate_pan, mask_pan, mock_pan
+from .aadhaar import validate_aadhaar, mock_aadhaar
+from .gstin import validate_gstin, mock_gstin
+
+__all__ = [
+    "validate_pan", "mask_pan", "mock_pan",
+    "validate_aadhaar", "mock_aadhaar",
+    "validate_gstin", "mock_gstin",
+]

india_kit/identity/aadhaar.py

@@ -0,0 +1,66 @@
+import random
+
+_D = [
+    [0, 1, 2, 3, 4, 5, 6, 7, 8, 9],
+    [1, 2, 3, 4, 0, 6, 7, 8, 9, 5],
+    [2, 3, 4, 0, 1, 7, 8, 9, 5, 6],
+    [3, 4, 0, 1, 2, 8, 9, 5, 6, 7],
+    [4, 0, 1, 2, 3, 9, 5, 6, 7, 8],
+    [5, 9, 8, 7, 6, 0, 4, 3, 2, 1],
+    [6, 5, 9, 8, 7, 1, 0, 4, 3, 2],
+    [7, 6, 5, 9, 8, 2, 1, 0, 4, 3],
+    [8, 7, 6, 5, 9, 3, 2, 1, 0, 4],
+    [9, 8, 7, 6, 5, 4, 3, 2, 1, 0],
+]
+
+_P = [
+    [0, 1, 2, 3, 4, 5, 6, 7, 8, 9],
+    [1, 5, 7, 6, 2, 8, 3, 0, 9, 4],
+    [5, 8, 0, 3, 7, 9, 6, 1, 4, 2],
+    [8, 9, 1, 6, 0, 4, 3, 5, 2, 7],
+    [9, 4, 5, 3, 1, 2, 6, 8, 7, 0],
+    [4, 2, 8, 6, 5, 7, 3, 9, 0, 1],
+    [2, 7, 9, 3, 8, 0, 6, 4, 1, 5],
+    [7, 0, 4, 6, 9, 1, 3, 2, 5, 8],
+]
+
+_INV = [0, 4, 3, 2, 1, 5, 6, 7, 8, 9]
+
+
+def _verhoeff_check(number: str) -> bool:
+    c = 0
+    for i, ch in enumerate(reversed(number)):
+        c = _D[c][_P[i % 8][int(ch)]]
+    return c == 0
+
+
+def _verhoeff_checksum(number: str) -> int:
+    c = 0
+    padded = number + "0"
+    for i, ch in enumerate(reversed(padded)):
+        c = _D[c][_P[i % 8][int(ch)]]
+    return _INV[c]
+
+
+def validate_aadhaar(aadhaar: str) -> dict:
+    if not isinstance(aadhaar, str):
+        return {"valid": False, "reason": "must be a string"}
+    a = aadhaar.strip().replace(" ", "")
+    if not a.isdigit() or len(a) != 12:
+        return {"valid": False, "reason": "must be exactly 12 digits"}
+    if a[0] in "01":
+        return {"valid": False, "reason": "first digit cannot be 0 or 1"}
+    if not _verhoeff_check(a):
+        return {"valid": False, "reason": "invalid Verhoeff checksum"}
+    return {"valid": True}
+
+
+def mock_aadhaar() -> str:
+    while True:
+        first = str(random.randint(2, 9))
+        rest = ''.join([str(random.randint(0, 9)) for _ in range(10)])
+        base = first + rest
+        check = _verhoeff_checksum(base)
+        candidate = base + str(check)
+        if _verhoeff_check(candidate):
+            return candidate

india_kit/identity/gstin.py

@@ -0,0 +1,35 @@
+import re
+import random
+import string
+from .pan import validate_pan, mock_pan
+
+
+_GSTIN_RE = re.compile(r'^[0-9]{2}[A-Z]{5}[0-9]{4}[A-Z][1-9A-Z]Z[0-9A-Z]$')
+
+_STATE_CODES = [
+    "01","02","03","04","05","06","07","08","09","10",
+    "11","12","13","14","15","16","17","18","19","20",
+    "21","22","23","24","25","26","27","28","29","30",
+    "31","32","33","34","35","36","37",
+]
+
+
+def validate_gstin(gstin: str) -> dict:
+    if not isinstance(gstin, str):
+        return {"valid": False, "reason": "must be a string"}
+    g = gstin.strip().upper()
+    if not _GSTIN_RE.match(g):
+        return {"valid": False, "reason": "invalid GSTIN format"}
+    embedded_pan = g[2:12]
+    result = validate_pan(embedded_pan)
+    if not result["valid"]:
+        return {"valid": False, "reason": "embedded PAN is invalid"}
+    return {"valid": True}
+
+
+def mock_gstin() -> str:
+    state = random.choice(_STATE_CODES)
+    pan = mock_pan()
+    entity = str(random.randint(1, 9))
+    checksum = random.choice(string.digits + string.ascii_uppercase)
+    return state + pan + entity + "Z" + checksum

india_kit/identity/pan.py

@@ -0,0 +1,30 @@
+import re
+import random
+import string
+
+
+_PAN_RE = re.compile(r'^[A-Z]{5}[0-9]{4}[A-Z]$')
+
+_ENTITY_CHARS = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ'
+
+
+def validate_pan(pan: str) -> dict:
+    if not isinstance(pan, str):
+        return {"valid": False, "reason": "must be a string"}
+    p = pan.strip().upper()
+    if not _PAN_RE.match(p):
+        return {"valid": False, "reason": "invalid PAN format (expected AAAAA9999A)"}
+    return {"valid": True}
+
+
+def mask_pan(pan: str) -> str:
+    p = pan.strip().upper()
+    return p[:3] + "XX" + p[5:]
+
+
+def mock_pan() -> str:
+    letters = string.ascii_uppercase
+    part1 = ''.join(random.choices(letters, k=5))
+    part2 = ''.join(random.choices(string.digits, k=4))
+    part3 = random.choice(letters)
+    return part1 + part2 + part3

india_kit-0.1.0.dist-info/METADATA

@@ -0,0 +1,65 @@
+Metadata-Version: 2.4
+Name: india-kit
+Version: 0.1.0
+Summary: The definitive Indian developer toolkit — validate Aadhaar, PAN, GSTIN, IFSC, UPI, pincode and more
+Project-URL: Homepage, https://github.com/Inreal-Solutions/India-kit
+Project-URL: Repository, https://github.com/Inreal-Solutions/India-kit
+Project-URL: Issues, https://github.com/Inreal-Solutions/India-kit/issues
+Author-email: Inreal Solutions <aryan23062001@gmail.com>
+License: MIT
+Keywords: aadhaar,fintech,gst,gstin,ifsc,india,indian,pan,pincode,upi,validate,validator
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# india-kit
+
+The definitive Indian developer toolkit for Python. Validate Aadhaar, PAN, GSTIN, IFSC, UPI, pincode and more — zero dependencies, fully typed.
+
+## Install
+
+```bash
+pip install india-kit
+```
+
+## Usage
+
+```python
+from india_kit import (
+    validate_pan, mask_pan, mock_pan,
+    validate_aadhaar, mock_aadhaar,
+    validate_gstin, mock_gstin,
+    validate_ifsc, lookup_ifsc,
+    validate_upi,
+    validate_pincode, lookup_pincode,
+    split_gst,
+)
+
+validate_pan("ABCDE1234F")      # {"valid": True}
+validate_aadhaar("234123412346") # {"valid": True/False}
+validate_gstin("27ABCDE1234F1Z5") # {"valid": True/False}
+validate_ifsc("SBIN0000001")    # {"valid": True}
+validate_upi("alice@icici")     # {"valid": True}
+validate_pincode("110001")      # {"valid": True}
+
+lookup_ifsc("SBIN0000001")      # {"bank": "State Bank of India", ...}
+lookup_pincode("110001")        # {"district": "Central Delhi", "state": "Delhi"}
+
+split_gst(1000, 18)             # {"cgst": 90.0, "sgst": 90.0, "igst": 0.0, "total_tax": 180.0}
+split_gst(1000, 18, intra_state=False)  # {"cgst": 0.0, "sgst": 0.0, "igst": 180.0, ...}
+
+mask_pan("ABCDE1234F")          # "ABCXX1234F"
+mock_pan()                      # random valid PAN
+mock_aadhaar()                  # random valid Aadhaar
+```
+
+## License
+
+MIT

india_kit-0.1.0.dist-info/RECORD

@@ -0,0 +1,15 @@
+india_kit/__init__.py,sha256=RCsZq-uQCWtr3SDe7syRmc5CqCIQ4k-jaidURCD-FJ0,636
+india_kit/address/__init__.py,sha256=X7aAV4xzR7W0ctGyR_7IE4ICUD7QVXyftTIjx_VkxkI,104
+india_kit/address/pincode.py,sha256=wF15bwHWtSHGdvK64Y097CN_3eRy7V_gg2baEdpkck4,1109
+india_kit/banking/__init__.py,sha256=4pNZYIqzdSae8w3J6_ZsnPQgaRdGrdlYdb-8NQgdE4E,135
+india_kit/banking/ifsc.py,sha256=KXESkZt-eaWb4Hyx2jZVwvpvxcKdgpqBcYEA0Y7bVkw,935
+india_kit/banking/upi.py,sha256=7StJa9lvlr4VyDboTZMBEhyiM0ROt2AJ1E3X8ooqpEY,366
+india_kit/finance/__init__.py,sha256=tkl1nS2CfTBbyhCApJZ7aW3iA0rEhIK3ca8YGOJBE44,52
+india_kit/finance/gst.py,sha256=PbAoo-mT1D8N9zkMmjL5JE55wBOlouaImwlNGJQ__Ms,360
+india_kit/identity/__init__.py,sha256=Iv0WF5vBHv_SH6j9YC-vzYDrvpK5rF3td93FR8XdfNc,283
+india_kit/identity/aadhaar.py,sha256=7-_CkYEIaODD3L-L509FHZaVnWhsQKzb5r_UmMYZ6H8,1916
+india_kit/identity/gstin.py,sha256=jOTXqYoVu-iVC7G4UFUFkSU_B2-RwlYDyi5CwBiaHPA,1083
+india_kit/identity/pan.py,sha256=4xgBFirJUP-6Hgp7EdD2R7i0_kMD39NnsEjiN9zt-Vo,767
+india_kit-0.1.0.dist-info/METADATA,sha256=zmCVfdreqKPI9H5WAIxZtw_K9bfWQ-c144_vJeN09lM,2289
+india_kit-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+india_kit-0.1.0.dist-info/RECORD,,

india_kit-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any