kramank 0.1.0__tar.gz

kramank-0.1.0/.gitignore

@@ -0,0 +1,18 @@
+node_modules/
+dist/
+.wrangler/
+.dev.vars
+.env
+*.log
+.DS_Store
+._*
+
+# Python (packages/validators-py)
+.venv/
+__pycache__/
+*.egg-info/
+.pytest_cache/
+
+# Manually-downloaded source datasets for local-only imports (e.g. the
+# pincode directory CSV) — never committed, never distributed.
+data/

kramank-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Karndev Jhala
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

kramank-0.1.0/PKG-INFO

@@ -0,0 +1,100 @@
+Metadata-Version: 2.5
+Name: kramank
+Version: 0.1.0
+Summary: Zero-dependency validators for Indian GSTIN, PAN, IFSC, and pincode formats — checksum-verified, type-hinted.
+Project-URL: Homepage, https://kramank.pages.dev
+Project-URL: Repository, https://github.com/planbcreator365/IndianAPI
+Project-URL: Issues, https://github.com/planbcreator365/IndianAPI/issues
+Author: Karndev Jhala
+License-Expression: MIT
+License-File: LICENSE
+Keywords: checksum,gst,gstin,ifsc,india,pan,pincode,validation
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# kramank
+
+Zero-dependency validators for Indian identifiers: **GSTIN**, **PAN**, **IFSC**, and **pincode**.
+Checksum-verified where a checksum exists (GSTIN), fully type-hinted, pure Python (no runtime dependencies).
+
+This is a line-for-line Python port of the [TypeScript `kramank` package](https://www.npmjs.com/package/kramank) — same error codes, same decoded fields, tested against the exact same fixture files.
+
+> **Format validation only.** These functions check that a string is a well-formed GSTIN/PAN/IFSC/pincode. They do **not** confirm the value is real, active, or currently registered with GSTN, the Income Tax Department, or a bank — that requires a live lookup against those systems, which this package does not do.
+
+## Install
+
+```bash
+pip install kramank
+```
+
+## Usage
+
+```python
+from kramank import validate_gstin, validate_pan, validate_ifsc, validate_pincode
+
+validate_gstin("27AAPFU0939F1ZV")
+# {
+#   "valid": True,
+#   "input": "27AAPFU0939F1ZV",
+#   "errors": [],
+#   "warnings": [],
+#   "stateCode": "27",
+#   "state": "Maharashtra",
+#   "category": "REGULAR",
+#   "pan": "AAPFU0939F",
+#   "panEntityType": "Firm",
+#   "note": "Format check only — does not confirm this value is real, active, or currently registered.",
+#   ...
+# }
+
+validate_pan("ABCPD1234E")
+# {"valid": True, "entityType": "Individual", ...}
+
+validate_ifsc("HDFC0001234")
+# {"valid": True, "bankCode": "HDFC", ...}
+
+validate_pincode("110001")
+# {"valid": True, "zoneDigit": "1", "zone": "Northern Region — ...", ...}
+```
+
+Every validator returns the same shape — never a bare boolean — so a failed validation always tells you *why* (`errors[0]["code"]`), not just that it failed:
+
+```python
+{
+    "valid": bool,
+    "input": str,            # trimmed, normalized
+    "errors": [{"code": str, "message": str}],
+    "warnings": [{"code": str, "message": str}],
+    # ...plus decoded fields specific to each identifier
+}
+```
+
+Result keys are `camelCase` (matching the JSON wire format of the hosted API and the TypeScript package) rather than `snake_case`, so a result dict can be serialized straight to JSON and match the API's response shape.
+
+## What this package does *not* do
+
+- No network calls, no live registry lookups, no "is this GSTIN actually registered" check.
+- No maintained reference data for IFSC branches or pincode post offices — just the structural/zone rules encoded in the formats themselves.
+
+## The hosted Kramank API
+
+[**Kramank**](https://kramank.pages.dev) (क्रमांक, "number") is a hosted API that builds on these same validators and adds what a pure format check can't give you:
+
+- **IFSC lookup** — real bank, branch, and address data for a given IFSC code, kept up to date.
+- **Pincode lookup** — real post office, district, and state data for a given pincode.
+- The same GSTIN/PAN/IFSC/pincode format validation as this package, as a hosted endpoint — useful if you'd rather not vendor the logic at all (or aren't on Python/JS).
+
+See the [API reference](https://kramank.pages.dev) for endpoints and free-tier limits, or get a key directly on [RapidAPI](https://rapidapi.com/planbcreator365/api/kramank-india-bank-pincode-gst-data1) — **BASIC** (free, 500 requests/month) and **PRO** ($9/month, 50,000 requests/month) are both live.
+
+## License
+
+MIT

kramank-0.1.0/README.md

@@ -0,0 +1,77 @@
+# kramank
+
+Zero-dependency validators for Indian identifiers: **GSTIN**, **PAN**, **IFSC**, and **pincode**.
+Checksum-verified where a checksum exists (GSTIN), fully type-hinted, pure Python (no runtime dependencies).
+
+This is a line-for-line Python port of the [TypeScript `kramank` package](https://www.npmjs.com/package/kramank) — same error codes, same decoded fields, tested against the exact same fixture files.
+
+> **Format validation only.** These functions check that a string is a well-formed GSTIN/PAN/IFSC/pincode. They do **not** confirm the value is real, active, or currently registered with GSTN, the Income Tax Department, or a bank — that requires a live lookup against those systems, which this package does not do.
+
+## Install
+
+```bash
+pip install kramank
+```
+
+## Usage
+
+```python
+from kramank import validate_gstin, validate_pan, validate_ifsc, validate_pincode
+
+validate_gstin("27AAPFU0939F1ZV")
+# {
+#   "valid": True,
+#   "input": "27AAPFU0939F1ZV",
+#   "errors": [],
+#   "warnings": [],
+#   "stateCode": "27",
+#   "state": "Maharashtra",
+#   "category": "REGULAR",
+#   "pan": "AAPFU0939F",
+#   "panEntityType": "Firm",
+#   "note": "Format check only — does not confirm this value is real, active, or currently registered.",
+#   ...
+# }
+
+validate_pan("ABCPD1234E")
+# {"valid": True, "entityType": "Individual", ...}
+
+validate_ifsc("HDFC0001234")
+# {"valid": True, "bankCode": "HDFC", ...}
+
+validate_pincode("110001")
+# {"valid": True, "zoneDigit": "1", "zone": "Northern Region — ...", ...}
+```
+
+Every validator returns the same shape — never a bare boolean — so a failed validation always tells you *why* (`errors[0]["code"]`), not just that it failed:
+
+```python
+{
+    "valid": bool,
+    "input": str,            # trimmed, normalized
+    "errors": [{"code": str, "message": str}],
+    "warnings": [{"code": str, "message": str}],
+    # ...plus decoded fields specific to each identifier
+}
+```
+
+Result keys are `camelCase` (matching the JSON wire format of the hosted API and the TypeScript package) rather than `snake_case`, so a result dict can be serialized straight to JSON and match the API's response shape.
+
+## What this package does *not* do
+
+- No network calls, no live registry lookups, no "is this GSTIN actually registered" check.
+- No maintained reference data for IFSC branches or pincode post offices — just the structural/zone rules encoded in the formats themselves.
+
+## The hosted Kramank API
+
+[**Kramank**](https://kramank.pages.dev) (क्रमांक, "number") is a hosted API that builds on these same validators and adds what a pure format check can't give you:
+
+- **IFSC lookup** — real bank, branch, and address data for a given IFSC code, kept up to date.
+- **Pincode lookup** — real post office, district, and state data for a given pincode.
+- The same GSTIN/PAN/IFSC/pincode format validation as this package, as a hosted endpoint — useful if you'd rather not vendor the logic at all (or aren't on Python/JS).
+
+See the [API reference](https://kramank.pages.dev) for endpoints and free-tier limits, or get a key directly on [RapidAPI](https://rapidapi.com/planbcreator365/api/kramank-india-bank-pincode-gst-data1) — **BASIC** (free, 500 requests/month) and **PRO** ($9/month, 50,000 requests/month) are both live.
+
+## License
+
+MIT

kramank-0.1.0/pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "kramank"
+version = "0.1.0"
+description = "Zero-dependency validators for Indian GSTIN, PAN, IFSC, and pincode formats — checksum-verified, type-hinted."
+readme = "README.md"
+license = "MIT"
+authors = [{ name = "Karndev Jhala" }]
+requires-python = ">=3.9"
+keywords = ["gstin", "gst", "pan", "ifsc", "pincode", "india", "validation", "checksum"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Typing :: Typed",
+]
+
+[project.urls]
+Homepage = "https://kramank.pages.dev"
+Repository = "https://github.com/planbcreator365/IndianAPI"
+Issues = "https://github.com/planbcreator365/IndianAPI/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/kramank"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[dependency-groups]
+dev = ["pytest>=8"]

kramank-0.1.0/src/kramank/__init__.py

@@ -0,0 +1,20 @@
+"""kramank: zero-dependency validators for Indian GSTIN, PAN, IFSC, and pincode formats."""
+
+from .checksum import compute_gstin_check_digit
+from .gstin import GSTIN_STATE_CODES, validate_gstin
+from .ifsc import validate_ifsc
+from .pan import PAN_ENTITY_TYPES, validate_pan
+from .pincode import PINCODE_ZONES, validate_pincode
+from .types import FORMAT_ONLY_NOTICE
+
+__all__ = [
+    "compute_gstin_check_digit",
+    "GSTIN_STATE_CODES",
+    "validate_gstin",
+    "validate_ifsc",
+    "PAN_ENTITY_TYPES",
+    "validate_pan",
+    "PINCODE_ZONES",
+    "validate_pincode",
+    "FORMAT_ONLY_NOTICE",
+]

kramank-0.1.0/src/kramank/checksum.py

@@ -0,0 +1,19 @@
+"""GSTIN check-digit algorithm. Mirrors packages/validators/src/checksum.ts."""
+
+_BASE36_CHARS = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ"
+
+
+def compute_gstin_check_digit(first_14_chars: str) -> str:
+    """Base-36 weighted-modulus checksum over the first 14 characters of a
+    GSTIN, processed right to left with a factor alternating 2/1. Verified
+    against the widely-published real example GSTIN 27AAPFU0939F1ZV."""
+    factor = 2
+    total = 0
+    for char in reversed(first_14_chars):
+        code_point = _BASE36_CHARS.index(char)
+        digit = factor * code_point
+        factor = 1 if factor == 2 else 2
+        digit = digit // 36 + digit % 36
+        total += digit
+    check_code_point = (36 - (total % 36)) % 36
+    return _BASE36_CHARS[check_code_point]

kramank-0.1.0/src/kramank/gstin.py

@@ -0,0 +1,225 @@
+"""GSTIN format validation. Mirrors packages/validators/src/gstin.ts."""
+
+import re
+from typing import Any, Dict, List, Optional
+
+from .checksum import compute_gstin_check_digit
+from .pan import PAN_ENTITY_TYPES
+from .types import FORMAT_ONLY_NOTICE, ValidationError, ValidationWarning
+
+# GST state/UT code table.
+#
+# Codes 25 and 28 are "legacy": both were genuinely issued (Daman and Diu
+# before merging into 26 in Jan 2020; undivided Andhra Pradesh before the
+# 2014 Telangana split) and both still appear on real historical invoices.
+# Rejecting them outright would be wrong, so they're kept as valid with
+# status "legacy" — validate_gstin surfaces this as a LEGACY_STATE_CODE
+# *warning*, never an error.
+#
+# Codes 97 ("Other Territory") and 99 ("Centre Jurisdiction") are special
+# jurisdiction codes, not states, but state code alone isn't a reliable
+# signal for UIN/non-resident-OIDAR category detection — see the
+# category-detection gap noted on validate_gstin below.
+GSTIN_STATE_CODES: Dict[str, Dict[str, str]] = {
+    "01": {"name": "Jammu and Kashmir", "status": "active"},
+    "02": {"name": "Himachal Pradesh", "status": "active"},
+    "03": {"name": "Punjab", "status": "active"},
+    "04": {"name": "Chandigarh", "status": "active"},
+    "05": {"name": "Uttarakhand", "status": "active"},
+    "06": {"name": "Haryana", "status": "active"},
+    "07": {"name": "Delhi", "status": "active"},
+    "08": {"name": "Rajasthan", "status": "active"},
+    "09": {"name": "Uttar Pradesh", "status": "active"},
+    "10": {"name": "Bihar", "status": "active"},
+    "11": {"name": "Sikkim", "status": "active"},
+    "12": {"name": "Arunachal Pradesh", "status": "active"},
+    "13": {"name": "Nagaland", "status": "active"},
+    "14": {"name": "Manipur", "status": "active"},
+    "15": {"name": "Mizoram", "status": "active"},
+    "16": {"name": "Tripura", "status": "active"},
+    "17": {"name": "Meghalaya", "status": "active"},
+    "18": {"name": "Assam", "status": "active"},
+    "19": {"name": "West Bengal", "status": "active"},
+    "20": {"name": "Jharkhand", "status": "active"},
+    "21": {"name": "Odisha", "status": "active"},
+    "22": {"name": "Chhattisgarh", "status": "active"},
+    "23": {"name": "Madhya Pradesh", "status": "active"},
+    "24": {"name": "Gujarat", "status": "active"},
+    "25": {"name": "Daman and Diu", "status": "legacy"},
+    "26": {"name": "Dadra and Nagar Haveli and Daman and Diu", "status": "active"},
+    "27": {"name": "Maharashtra", "status": "active"},
+    "28": {"name": "Andhra Pradesh (Before Division)", "status": "legacy"},
+    "29": {"name": "Karnataka", "status": "active"},
+    "30": {"name": "Goa", "status": "active"},
+    "31": {"name": "Lakshadweep", "status": "active"},
+    "32": {"name": "Kerala", "status": "active"},
+    "33": {"name": "Tamil Nadu", "status": "active"},
+    "34": {"name": "Puducherry", "status": "active"},
+    "35": {"name": "Andaman and Nicobar Islands", "status": "active"},
+    "36": {"name": "Telangana", "status": "active"},
+    "37": {"name": "Andhra Pradesh", "status": "active"},
+    "38": {"name": "Ladakh", "status": "active"},
+    "97": {"name": "Other Territory", "status": "active"},
+    "99": {"name": "Centre Jurisdiction", "status": "active"},
+}
+
+_PAN_SLOT_REGEX = re.compile(r"^[A-Z]{5}[0-9]{4}[A-Z]$")
+_TAN_SLOT_REGEX = re.compile(r"^[A-Z]{4}[0-9]{5}[A-Z]$")
+_GSTIN_CHARSET_REGEX = re.compile(r"^[0-9A-Z]{15}$")
+
+
+def validate_gstin(raw_input: str) -> Dict[str, Any]:
+    """FORMAT validation only. Does not confirm the GSTIN is real, active, or
+    actually registered with GSTN.
+
+    A GSTIN whose middle segment (characters 3-12) matches neither a PAN nor
+    a TAN pattern is NOT treated as malformed on that basis alone:
+    `category` becomes `'UNKNOWN'` with an `UNRECOGNIZED_STRUCTURE` warning,
+    and `valid` stays `True` as long as the length, character set, state
+    code, and checksum are all otherwise correct. GSTINs in categories this
+    validator can't structurally identify (UIN, OIDAR, and any other
+    special-registration category) fall into exactly this shape, and
+    treating "we don't recognize this structure" the same as "this is wrong"
+    would reject real GSTINs.
+
+    Known gaps:
+    - UIN (state code 97) and non-resident/OIDAR (state code 99) registrant
+      categories cannot be structurally detected; `category` is decided
+      purely by whether characters 3-12 match a PAN or TAN pattern.
+    - TCS (e-commerce operators collecting tax at source) is not
+      structurally distinguishable from a REGULAR PAN-based GSTIN either.
+    """
+    input_ = raw_input.strip().upper()
+
+    if len(input_) == 0:
+        return {
+            "valid": False,
+            "input": input_,
+            "errors": [{"code": "GSTIN_EMPTY", "message": "GSTIN is empty."}],
+            "warnings": [],
+            "note": FORMAT_ONLY_NOTICE,
+        }
+    if len(input_) != 15:
+        return {
+            "valid": False,
+            "input": input_,
+            "errors": [
+                {
+                    "code": "GSTIN_INVALID_LENGTH",
+                    "message": f"GSTIN must be exactly 15 characters (found {len(input_)}).",
+                }
+            ],
+            "warnings": [],
+            "note": FORMAT_ONLY_NOTICE,
+        }
+    if not _GSTIN_CHARSET_REGEX.match(input_):
+        return {
+            "valid": False,
+            "input": input_,
+            "errors": [
+                {
+                    "code": "GSTIN_INVALID_CHARACTERS",
+                    "message": "GSTIN must contain only digits and uppercase letters.",
+                }
+            ],
+            "warnings": [],
+            "note": FORMAT_ONLY_NOTICE,
+        }
+
+    errors: List[ValidationError] = []
+    warnings: List[ValidationWarning] = []
+
+    state_code = input_[0:2]
+    pan_or_tan_slot = input_[2:12]
+    entity_code = input_[12]
+    default_character = input_[13]
+    check_digit = input_[14]
+
+    state_info = GSTIN_STATE_CODES.get(state_code)
+    if state_info is None:
+        errors.append(
+            {
+                "code": "GSTIN_INVALID_STATE_CODE",
+                "message": f'"{state_code}" is not a recognized GST state/UT code.',
+            }
+        )
+    elif state_info["status"] == "legacy":
+        warnings.append(
+            {
+                "code": "LEGACY_STATE_CODE",
+                "message": (
+                    f'State code "{state_code}" ({state_info["name"]}) is no longer issued '
+                    "for new registrations, but GSTINs issued under it before the change "
+                    "remain valid."
+                ),
+            }
+        )
+
+    category: str
+    pan: Optional[str] = None
+    pan_entity_type_code: Optional[str] = None
+    pan_entity_type: Optional[str] = None
+    tan: Optional[str] = None
+
+    if _PAN_SLOT_REGEX.match(pan_or_tan_slot):
+        category = "REGULAR"
+        pan = pan_or_tan_slot
+        pan_entity_type_code = pan[3]
+        pan_entity_type = PAN_ENTITY_TYPES.get(pan_entity_type_code)
+        if pan_entity_type is None:
+            errors.append(
+                {
+                    "code": "GSTIN_UNKNOWN_PAN_ENTITY_TYPE",
+                    "message": f'"{pan_entity_type_code}" is not a recognized PAN entity-type character.',
+                }
+            )
+    elif _TAN_SLOT_REGEX.match(pan_or_tan_slot):
+        category = "TDS"
+        tan = pan_or_tan_slot
+    else:
+        category = "UNKNOWN"
+        warnings.append(
+            {
+                "code": "UNRECOGNIZED_STRUCTURE",
+                "message": (
+                    "Characters 3-12 do not match a known PAN (AAAAA9999A) or TAN "
+                    "(AAAA99999A) pattern. This does not make the GSTIN invalid — it may "
+                    "be a UIN, OIDAR, or other special-category registration this "
+                    "validator cannot yet structurally identify."
+                ),
+            }
+        )
+
+    if category in ("REGULAR", "TDS") and default_character != "Z":
+        errors.append(
+            {
+                "code": "GSTIN_INVALID_DEFAULT_CHARACTER",
+                "message": f'Character 14 must be "Z" (found "{default_character}").',
+            }
+        )
+
+    expected_check_digit = compute_gstin_check_digit(input_[0:14])
+    if check_digit != expected_check_digit:
+        errors.append(
+            {
+                "code": "GSTIN_CHECKSUM_MISMATCH",
+                "message": f'Checksum character does not match (expected "{expected_check_digit}", found "{check_digit}").',
+            }
+        )
+
+    return {
+        "valid": len(errors) == 0,
+        "input": input_,
+        "errors": errors,
+        "warnings": warnings,
+        "stateCode": state_code,
+        "state": state_info["name"] if state_info else None,
+        "stateCodeStatus": state_info["status"] if state_info else None,
+        "category": category,
+        "pan": pan,
+        "panEntityTypeCode": pan_entity_type_code,
+        "panEntityType": pan_entity_type,
+        "tan": tan,
+        "entityCode": entity_code,
+        "note": FORMAT_ONLY_NOTICE,
+    }

kramank-0.1.0/src/kramank/ifsc.py

@@ -0,0 +1,50 @@
+"""IFSC format validation. Mirrors packages/validators/src/ifsc.ts."""
+
+import re
+from typing import Any, Dict
+
+_IFSC_REGEX = re.compile(r"^[A-Z]{4}0[A-Z0-9]{6}$")
+
+
+def validate_ifsc(raw_input: str) -> Dict[str, Any]:
+    input_ = raw_input.strip().upper()
+
+    if len(input_) == 0:
+        return {
+            "valid": False,
+            "input": input_,
+            "errors": [{"code": "IFSC_EMPTY", "message": "IFSC is empty."}],
+            "warnings": [],
+        }
+    if len(input_) != 11:
+        return {
+            "valid": False,
+            "input": input_,
+            "errors": [
+                {
+                    "code": "IFSC_INVALID_LENGTH",
+                    "message": f"IFSC must be exactly 11 characters (found {len(input_)}).",
+                }
+            ],
+            "warnings": [],
+        }
+    if not _IFSC_REGEX.match(input_):
+        return {
+            "valid": False,
+            "input": input_,
+            "errors": [
+                {
+                    "code": "IFSC_INVALID_FORMAT",
+                    "message": 'IFSC must match AAAA0XXXXXX (4 letters, then "0", then 6 alphanumerics).',
+                }
+            ],
+            "warnings": [],
+        }
+
+    return {
+        "valid": True,
+        "input": input_,
+        "errors": [],
+        "warnings": [],
+        "bankCode": input_[:4],
+    }

kramank-0.1.0/src/kramank/pan.py

@@ -0,0 +1,87 @@
+"""PAN format validation. Mirrors packages/validators/src/pan.ts."""
+
+import re
+from typing import Any, Dict, List
+
+from .types import FORMAT_ONLY_NOTICE, ValidationError
+
+# The 4th character of a PAN identifies the holder's entity type. This is
+# the complete, official 10-code list. There is no separate code for LLP:
+# PAN allotment has no distinct LLP category, so an LLP's PAN carries the
+# same 'F' (Firm) code as a partnership firm.
+PAN_ENTITY_TYPES: Dict[str, str] = {
+    "A": "Association of Persons (AOP)",
+    "B": "Body of Individuals (BOI)",
+    "C": "Company",
+    "F": "Firm",
+    "G": "Government",
+    "H": "Hindu Undivided Family (HUF)",
+    "J": "Artificial Juridical Person",
+    "L": "Local Authority",
+    "P": "Individual",
+    "T": "Trust",
+}
+
+_PAN_REGEX = re.compile(r"^[A-Z]{5}[0-9]{4}[A-Z]$")
+
+
+def validate_pan(raw_input: str) -> Dict[str, Any]:
+    """FORMAT validation only. Does not confirm the PAN is real, active, or
+    actually allotted by the Income Tax Department."""
+    input_ = raw_input.strip().upper()
+
+    if len(input_) == 0:
+        return {
+            "valid": False,
+            "input": input_,
+            "errors": [{"code": "PAN_EMPTY", "message": "PAN is empty."}],
+            "warnings": [],
+            "note": FORMAT_ONLY_NOTICE,
+        }
+    if len(input_) != 10:
+        return {
+            "valid": False,
+            "input": input_,
+            "errors": [
+                {
+                    "code": "PAN_INVALID_LENGTH",
+                    "message": f"PAN must be exactly 10 characters (found {len(input_)}).",
+                }
+            ],
+            "warnings": [],
+            "note": FORMAT_ONLY_NOTICE,
+        }
+    if not _PAN_REGEX.match(input_):
+        return {
+            "valid": False,
+            "input": input_,
+            "errors": [
+                {
+                    "code": "PAN_INVALID_FORMAT",
+                    "message": "PAN must match AAAAA9999A (5 letters, 4 digits, 1 letter).",
+                }
+            ],
+            "warnings": [],
+            "note": FORMAT_ONLY_NOTICE,
+        }
+
+    errors: List[ValidationError] = []
+    entity_type_code = input_[3]
+    entity_type = PAN_ENTITY_TYPES.get(entity_type_code)
+    if entity_type is None:
+        errors.append(
+            {
+                "code": "PAN_UNKNOWN_ENTITY_TYPE",
+                "message": f'"{entity_type_code}" is not a recognized PAN entity-type character.',
+            }
+        )
+
+    return {
+        "valid": len(errors) == 0,
+        "input": input_,
+        "errors": errors,
+        "warnings": [],
+        "entityTypeCode": entity_type_code,
+        "entityType": entity_type,
+        "note": FORMAT_ONLY_NOTICE,
+    }

kramank-0.1.0/src/kramank/pincode.py

@@ -0,0 +1,74 @@
+"""Pincode format validation. Mirrors packages/validators/src/pincode.ts."""
+
+import re
+from typing import Any, Dict
+
+# First-digit postal zone table.
+PINCODE_ZONES: Dict[str, str] = {
+    "1": "Northern Region — Delhi, Haryana, Himachal Pradesh, Punjab, Chandigarh, Jammu & Kashmir, Ladakh",
+    "2": "Northern Region — Uttarakhand, Uttar Pradesh",
+    "3": "Western Region — Gujarat, Rajasthan, Dadra and Nagar Haveli and Daman and Diu",
+    "4": "Western Region — Chhattisgarh, Goa, Madhya Pradesh, Maharashtra",
+    "5": "Southern Region — Andhra Pradesh, Karnataka, Telangana",
+    "6": "Southern Region — Kerala, Tamil Nadu, Puducherry, Lakshadweep",
+    "7": "Eastern Region — Arunachal Pradesh, Assam, Manipur, Meghalaya, Mizoram, Nagaland, Odisha, Sikkim, Tripura, West Bengal, Andaman and Nicobar Islands",
+    "8": "Eastern Region — Bihar, Jharkhand",
+    "9": "Army Postal Service (APS) / Field Post Office (FPO)",
+}
+
+_PINCODE_REGEX = re.compile(r"^[0-9]{6}$")
+
+
+def validate_pincode(raw_input: str) -> Dict[str, Any]:
+    input_ = raw_input.strip()
+
+    if len(input_) == 0:
+        return {
+            "valid": False,
+            "input": input_,
+            "errors": [{"code": "PINCODE_EMPTY", "message": "Pincode is empty."}],
+            "warnings": [],
+        }
+    if len(input_) != 6:
+        return {
+            "valid": False,
+            "input": input_,
+            "errors": [
+                {
+                    "code": "PINCODE_INVALID_LENGTH",
+                    "message": f"Pincode must be exactly 6 digits (found {len(input_)}).",
+                }
+            ],
+            "warnings": [],
+        }
+    if not _PINCODE_REGEX.match(input_):
+        return {
+            "valid": False,
+            "input": input_,
+            "errors": [{"code": "PINCODE_INVALID_CHARACTERS", "message": "Pincode must contain only digits."}],
+            "warnings": [],
+        }
+
+    zone_digit = input_[0]
+    if zone_digit == "0":
+        return {
+            "valid": False,
+            "input": input_,
+            "errors": [
+                {
+                    "code": "PINCODE_INVALID_FIRST_DIGIT",
+                    "message": "The first digit of a pincode must be 1-9, not 0.",
+                }
+            ],
+            "warnings": [],
+            "zoneDigit": zone_digit,
+        }
+
+    return {
+        "valid": True,
+        "input": input_,
+        "errors": [],
+        "warnings": [],
+        "zoneDigit": zone_digit,
+        "zone": PINCODE_ZONES.get(zone_digit),
+    }

kramank-0.1.0/src/kramank/types.py

@@ -0,0 +1,30 @@
+"""Shared result shapes. Mirrors packages/validators/src/types.ts."""
+
+from typing import List, TypedDict
+
+
+class ValidationError(TypedDict):
+    code: str
+    message: str
+
+
+# Same shape as an error, but never affects `valid` — used for facts worth
+# surfacing (e.g. a legacy-but-still-real state code) that aren't defects.
+ValidationWarning = ValidationError
+
+
+class ValidationResult(TypedDict):
+    valid: bool
+    input: str
+    errors: List[ValidationError]
+    warnings: List[ValidationWarning]
+
+
+# Attached to GSTIN and PAN results only — these are tax identifiers where
+# "format is well-formed" is easily misread as "this is a real, registered
+# taxpayer." IFSC/pincode don't carry that same real-world-registration
+# ambiguity, so they don't need this notice.
+FORMAT_ONLY_NOTICE = (
+    "Format check only — does not confirm this value is real, active, or "
+    "currently registered."
+)

kramank-0.1.0/tests/conftest.py

@@ -0,0 +1,10 @@
+import json
+from pathlib import Path
+
+FIXTURES_DIR = Path(__file__).parent.parent.parent / "validators" / "fixtures"
+
+
+def load_fixtures(name: str) -> dict:
+    """Loads the SAME fixtures the TypeScript package tests against —
+    single source of truth in packages/validators/fixtures/."""
+    return json.loads((FIXTURES_DIR / f"{name}.json").read_text())

kramank-0.1.0/tests/test_gstin.py

@@ -0,0 +1,32 @@
+import re
+
+import pytest
+from conftest import load_fixtures
+
+from kramank import validate_gstin
+
+FIXTURES = load_fixtures("gstin")
+
+
+@pytest.mark.parametrize("fixture", FIXTURES["valid"], ids=lambda f: f["description"])
+def test_valid(fixture):
+    result = validate_gstin(fixture["input"])
+    assert result["valid"] is True
+    assert result["errors"] == []
+    assert result["input"] == fixture["input"].strip().upper()
+    for key, value in fixture["expected"].items():
+        assert result[key] == value
+    expected_warning_codes = fixture.get("expectedWarningCodes", [])
+    assert sorted(w["code"] for w in result["warnings"]) == sorted(expected_warning_codes)
+
+
+@pytest.mark.parametrize("fixture", FIXTURES["invalid"], ids=lambda f: f["description"])
+def test_invalid(fixture):
+    result = validate_gstin(fixture["input"])
+    assert result["valid"] is False
+    assert sorted(e["code"] for e in result["errors"]) == sorted(fixture["expectedErrorCodes"])
+
+
+def test_format_only_notice():
+    assert re.search(r"does not confirm", validate_gstin("27AAPFU0939F1ZV")["note"], re.IGNORECASE)
+    assert re.search(r"does not confirm", validate_gstin("")["note"], re.IGNORECASE)

kramank-0.1.0/tests/test_ifsc.py

@@ -0,0 +1,23 @@
+import pytest
+from conftest import load_fixtures
+
+from kramank import validate_ifsc
+
+FIXTURES = load_fixtures("ifsc")
+
+
+@pytest.mark.parametrize("fixture", FIXTURES["valid"], ids=lambda f: f["description"])
+def test_valid(fixture):
+    result = validate_ifsc(fixture["input"])
+    assert result["valid"] is True
+    assert result["errors"] == []
+    assert result["input"] == fixture["input"].strip().upper()
+    for key, value in fixture["expected"].items():
+        assert result[key] == value
+
+
+@pytest.mark.parametrize("fixture", FIXTURES["invalid"], ids=lambda f: f["description"])
+def test_invalid(fixture):
+    result = validate_ifsc(fixture["input"])
+    assert result["valid"] is False
+    assert sorted(e["code"] for e in result["errors"]) == sorted(fixture["expectedErrorCodes"])

kramank-0.1.0/tests/test_pan.py

@@ -0,0 +1,30 @@
+import re
+
+import pytest
+from conftest import load_fixtures
+
+from kramank import validate_pan
+
+FIXTURES = load_fixtures("pan")
+
+
+@pytest.mark.parametrize("fixture", FIXTURES["valid"], ids=lambda f: f["description"])
+def test_valid(fixture):
+    result = validate_pan(fixture["input"])
+    assert result["valid"] is True
+    assert result["errors"] == []
+    assert result["input"] == fixture["input"].strip().upper()
+    for key, value in fixture["expected"].items():
+        assert result[key] == value
+
+
+@pytest.mark.parametrize("fixture", FIXTURES["invalid"], ids=lambda f: f["description"])
+def test_invalid(fixture):
+    result = validate_pan(fixture["input"])
+    assert result["valid"] is False
+    assert sorted(e["code"] for e in result["errors"]) == sorted(fixture["expectedErrorCodes"])
+
+
+def test_format_only_notice():
+    assert re.search(r"does not confirm", validate_pan("ABCPD1234E")["note"], re.IGNORECASE)
+    assert re.search(r"does not confirm", validate_pan("")["note"], re.IGNORECASE)

kramank-0.1.0/tests/test_pincode.py

@@ -0,0 +1,23 @@
+import pytest
+from conftest import load_fixtures
+
+from kramank import validate_pincode
+
+FIXTURES = load_fixtures("pincode")
+
+
+@pytest.mark.parametrize("fixture", FIXTURES["valid"], ids=lambda f: f["description"])
+def test_valid(fixture):
+    result = validate_pincode(fixture["input"])
+    assert result["valid"] is True
+    assert result["errors"] == []
+    assert result["input"] == fixture["input"].strip()
+    for key, value in fixture["expected"].items():
+        assert result[key] == value
+
+
+@pytest.mark.parametrize("fixture", FIXTURES["invalid"], ids=lambda f: f["description"])
+def test_invalid(fixture):
+    result = validate_pincode(fixture["input"])
+    assert result["valid"] is False
+    assert sorted(e["code"] for e in result["errors"]) == sorted(fixture["expectedErrorCodes"])

kramank-0.1.0/uv.lock

@@ -0,0 +1,200 @@
+version = 1
+revision = 3
+requires-python = ">=3.9"
+resolution-markers = [
+    "python_full_version >= '3.10'",
+    "python_full_version < '3.10'",
+]
+
+[[package]]
+name = "colorama"
+version = "0.4.6"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697, upload-time = "2022-10-25T02:36:22.414Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" },
+]
+
+[[package]]
+name = "exceptiongroup"
+version = "1.3.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/50/79/66800aadf48771f6b62f7eb014e352e5d06856655206165d775e675a02c9/exceptiongroup-1.3.1.tar.gz", hash = "sha256:8b412432c6055b0b7d14c310000ae93352ed6754f70fa8f7c34141f91c4e3219", size = 30371, upload-time = "2025-11-21T23:01:54.787Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/8a/0e/97c33bf5009bdbac74fd2beace167cab3f978feb69cc36f1ef79360d6c4e/exceptiongroup-1.3.1-py3-none-any.whl", hash = "sha256:a7a39a3bd276781e98394987d3a5701d0c4edffb633bb7a5144577f82c773598", size = 16740, upload-time = "2025-11-21T23:01:53.443Z" },
+]
+
+[[package]]
+name = "iniconfig"
+version = "2.1.0"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version < '3.10'",
+]
+sdist = { url = "https://files.pythonhosted.org/packages/f2/97/ebf4da567aa6827c909642694d71c9fcf53e5b504f2d96afea02718862f3/iniconfig-2.1.0.tar.gz", hash = "sha256:3abbd2e30b36733fee78f9c7f7308f2d0050e88f0087fd25c2645f63c773e1c7", size = 4793, upload-time = "2025-03-19T20:09:59.721Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/2c/e1/e6716421ea10d38022b952c159d5161ca1193197fb744506875fbb87ea7b/iniconfig-2.1.0-py3-none-any.whl", hash = "sha256:9deba5723312380e77435581c6bf4935c94cbfab9b1ed33ef8d238ea168eb760", size = 6050, upload-time = "2025-03-19T20:10:01.071Z" },
+]
+
+[[package]]
+name = "iniconfig"
+version = "2.3.0"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version >= '3.10'",
+]
+sdist = { url = "https://files.pythonhosted.org/packages/72/34/14ca021ce8e5dfedc35312d08ba8bf51fdd999c576889fc2c24cb97f4f10/iniconfig-2.3.0.tar.gz", hash = "sha256:c76315c77db068650d49c5b56314774a7804df16fee4402c1f19d6d15d8c4730", size = 20503, upload-time = "2025-10-18T21:55:43.219Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/cb/b1/3846dd7f199d53cb17f49cba7e651e9ce294d8497c8c150530ed11865bb8/iniconfig-2.3.0-py3-none-any.whl", hash = "sha256:f631c04d2c48c52b84d0d0549c99ff3859c98df65b3101406327ecc7d53fbf12", size = 7484, upload-time = "2025-10-18T21:55:41.639Z" },
+]
+
+[[package]]
+name = "kramank"
+version = "0.1.0"
+source = { editable = "." }
+
+[package.dev-dependencies]
+dev = [
+    { name = "pytest", version = "8.4.2", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.10'" },
+    { name = "pytest", version = "9.1.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.10'" },
+]
+
+[package.metadata]
+
+[package.metadata.requires-dev]
+dev = [{ name = "pytest", specifier = ">=8" }]
+
+[[package]]
+name = "packaging"
+version = "26.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/7d/fa/3944b40b07da9ce895c0e6303a5ab7d53da063554f534556b134a54d6093/packaging-26.3.tar.gz", hash = "sha256:94edc256424af38762eb31306eed28beb9f0efc50a8837492c9d6fd6004aed79", size = 313412, upload-time = "2026-08-04T18:15:28.737Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/63/34/ba1c580383c9eada3711951fef0795c80b829a078d72188184bcab9dd527/packaging-26.3-py3-none-any.whl", hash = "sha256:d7193f7c8e4e93f444fde0262bf90af30e16fa0ad0ad44cb553c87339b23cd1c", size = 129956, upload-time = "2026-08-04T18:15:27.159Z" },
+]
+
+[[package]]
+name = "pluggy"
+version = "1.6.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f9/e2/3e91f31a7d2b083fe6ef3fa267035b518369d9511ffab804f839851d2779/pluggy-1.6.0.tar.gz", hash = "sha256:7dcc130b76258d33b90f61b658791dede3486c3e6bfb003ee5c9bfb396dd22f3", size = 69412, upload-time = "2025-05-15T12:30:07.975Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746", size = 20538, upload-time = "2025-05-15T12:30:06.134Z" },
+]
+
+[[package]]
+name = "pygments"
+version = "2.21.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/49/2e/ced460408999b33da6b31b0021b0f37d329e202d4169aeb164493778f25b/pygments-2.21.0.tar.gz", hash = "sha256:610ca751c9bc2492b38eb9a38a7fbc93edbbb2d7182edaf34e66ae493dee5c8c", size = 5005329, upload-time = "2026-08-17T08:02:48.824Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/71/46/17f022dd3e953bf20a04a028a21ec746d942f8d2af30fa0f124fa0e6a684/pygments-2.21.0-py3-none-any.whl", hash = "sha256:2363c69b61c4a97c838da3b130dcd6468f4848992b21a82f2a63ec34377137d9", size = 1250147, upload-time = "2026-08-17T08:02:44.912Z" },
+]
+
+[[package]]
+name = "pytest"
+version = "8.4.2"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version < '3.10'",
+]
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "exceptiongroup" },
+    { name = "iniconfig", version = "2.1.0", source = { registry = "https://pypi.org/simple" } },
+    { name = "packaging" },
+    { name = "pluggy" },
+    { name = "pygments" },
+    { name = "tomli" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/a3/5c/00a0e072241553e1a7496d638deababa67c5058571567b92a7eaa258397c/pytest-8.4.2.tar.gz", hash = "sha256:86c0d0b93306b961d58d62a4db4879f27fe25513d4b969df351abdddb3c30e01", size = 1519618, upload-time = "2025-09-04T14:34:22.711Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/a8/a4/20da314d277121d6534b3a980b29035dcd51e6744bd79075a6ce8fa4eb8d/pytest-8.4.2-py3-none-any.whl", hash = "sha256:872f880de3fc3a5bdc88a11b39c9710c3497a547cfa9320bc3c5e62fbf272e79", size = 365750, upload-time = "2025-09-04T14:34:20.226Z" },
+]
+
+[[package]]
+name = "pytest"
+version = "9.1.1"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version >= '3.10'",
+]
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "exceptiongroup", marker = "python_full_version < '3.11'" },
+    { name = "iniconfig", version = "2.3.0", source = { registry = "https://pypi.org/simple" } },
+    { name = "packaging" },
+    { name = "pluggy" },
+    { name = "pygments" },
+    { name = "tomli", marker = "python_full_version < '3.11'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/e4/47/b9efed96c114afcfa3c9d3fe98a76a1d14c74a9e266d397cf6eb64be5e01/pytest-9.1.1.tar.gz", hash = "sha256:1088fbde8f2b49d95a549a195707afa7a76a3ce9bcadc26b6d71f0ffda5fe313", size = 1636369, upload-time = "2026-06-19T10:58:32.857Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/24/25/1de2678b631f5a49215c6c96fff41ba892b0a34df68d6d80292b1b48aa7f/pytest-9.1.1-py3-none-any.whl", hash = "sha256:37a86b45efb9a47a61a36449063e8e18d0cab3161329fc099eb21783169c4f0c", size = 386536, upload-time = "2026-06-19T10:58:31.347Z" },
+]
+
+[[package]]
+name = "tomli"
+version = "2.4.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/22/de/48c59722572767841493b26183a0d1cc411d54fd759c5607c4590b6563a6/tomli-2.4.1.tar.gz", hash = "sha256:7c7e1a961a0b2f2472c1ac5b69affa0ae1132c39adcb67aba98568702b9cc23f", size = 17543, upload-time = "2026-03-25T20:22:03.828Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f4/11/db3d5885d8528263d8adc260bb2d28ebf1270b96e98f0e0268d32b8d9900/tomli-2.4.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:f8f0fc26ec2cc2b965b7a3b87cd19c5c6b8c5e5f436b984e85f486d652285c30", size = 154704, upload-time = "2026-03-25T20:21:10.473Z" },
+    { url = "https://files.pythonhosted.org/packages/6d/f7/675db52c7e46064a9aa928885a9b20f4124ecb9bc2e1ce74c9106648d202/tomli-2.4.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:4ab97e64ccda8756376892c53a72bd1f964e519c77236368527f758fbc36a53a", size = 149454, upload-time = "2026-03-25T20:21:12.036Z" },
+    { url = "https://files.pythonhosted.org/packages/61/71/81c50943cf953efa35bce7646caab3cf457a7d8c030b27cfb40d7235f9ee/tomli-2.4.1-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:96481a5786729fd470164b47cdb3e0e58062a496f455ee41b4403be77cb5a076", size = 237561, upload-time = "2026-03-25T20:21:13.098Z" },
+    { url = "https://files.pythonhosted.org/packages/48/c1/f41d9cb618acccca7df82aaf682f9b49013c9397212cb9f53219e3abac37/tomli-2.4.1-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:5a881ab208c0baf688221f8cecc5401bd291d67e38a1ac884d6736cbcd8247e9", size = 243824, upload-time = "2026-03-25T20:21:14.569Z" },
+    { url = "https://files.pythonhosted.org/packages/22/e4/5a816ecdd1f8ca51fb756ef684b90f2780afc52fc67f987e3c61d800a46d/tomli-2.4.1-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:47149d5bd38761ac8be13a84864bf0b7b70bc051806bc3669ab1cbc56216b23c", size = 242227, upload-time = "2026-03-25T20:21:15.712Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/49/2b2a0ef529aa6eec245d25f0c703e020a73955ad7edf73e7f54ddc608aa5/tomli-2.4.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:ec9bfaf3ad2df51ace80688143a6a4ebc09a248f6ff781a9945e51937008fcbc", size = 247859, upload-time = "2026-03-25T20:21:17.001Z" },
+    { url = "https://files.pythonhosted.org/packages/83/bd/6c1a630eaca337e1e78c5903104f831bda934c426f9231429396ce3c3467/tomli-2.4.1-cp311-cp311-win32.whl", hash = "sha256:ff2983983d34813c1aeb0fa89091e76c3a22889ee83ab27c5eeb45100560c049", size = 97204, upload-time = "2026-03-25T20:21:18.079Z" },
+    { url = "https://files.pythonhosted.org/packages/42/59/71461df1a885647e10b6bb7802d0b8e66480c61f3f43079e0dcd315b3954/tomli-2.4.1-cp311-cp311-win_amd64.whl", hash = "sha256:5ee18d9ebdb417e384b58fe414e8d6af9f4e7a0ae761519fb50f721de398dd4e", size = 108084, upload-time = "2026-03-25T20:21:18.978Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/83/dceca96142499c069475b790e7913b1044c1a4337e700751f48ed723f883/tomli-2.4.1-cp311-cp311-win_arm64.whl", hash = "sha256:c2541745709bad0264b7d4705ad453b76ccd191e64aa6f0fc66b69a293a45ece", size = 95285, upload-time = "2026-03-25T20:21:20.309Z" },
+    { url = "https://files.pythonhosted.org/packages/c1/ba/42f134a3fe2b370f555f44b1d72feebb94debcab01676bf918d0cb70e9aa/tomli-2.4.1-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:c742f741d58a28940ce01d58f0ab2ea3ced8b12402f162f4d534dfe18ba1cd6a", size = 155924, upload-time = "2026-03-25T20:21:21.626Z" },
+    { url = "https://files.pythonhosted.org/packages/dc/c7/62d7a17c26487ade21c5422b646110f2162f1fcc95980ef7f63e73c68f14/tomli-2.4.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:7f86fd587c4ed9dd76f318225e7d9b29cfc5a9d43de44e5754db8d1128487085", size = 150018, upload-time = "2026-03-25T20:21:23.002Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/05/79d13d7c15f13bdef410bdd49a6485b1c37d28968314eabee452c22a7fda/tomli-2.4.1-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ff18e6a727ee0ab0388507b89d1bc6a22b138d1e2fa56d1ad494586d61d2eae9", size = 244948, upload-time = "2026-03-25T20:21:24.04Z" },
+    { url = "https://files.pythonhosted.org/packages/10/90/d62ce007a1c80d0b2c93e02cab211224756240884751b94ca72df8a875ca/tomli-2.4.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:136443dbd7e1dee43c68ac2694fde36b2849865fa258d39bf822c10e8068eac5", size = 253341, upload-time = "2026-03-25T20:21:25.177Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/7e/caf6496d60152ad4ed09282c1885cca4eea150bfd007da84aea07bcc0a3e/tomli-2.4.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:5e262d41726bc187e69af7825504c933b6794dc3fbd5945e41a79bb14c31f585", size = 248159, upload-time = "2026-03-25T20:21:26.364Z" },
+    { url = "https://files.pythonhosted.org/packages/99/e7/c6f69c3120de34bbd882c6fba7975f3d7a746e9218e56ab46a1bc4b42552/tomli-2.4.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:5cb41aa38891e073ee49d55fbc7839cfdb2bc0e600add13874d048c94aadddd1", size = 253290, upload-time = "2026-03-25T20:21:27.46Z" },
+    { url = "https://files.pythonhosted.org/packages/d6/2f/4a3c322f22c5c66c4b836ec58211641a4067364f5dcdd7b974b4c5da300c/tomli-2.4.1-cp312-cp312-win32.whl", hash = "sha256:da25dc3563bff5965356133435b757a795a17b17d01dbc0f42fb32447ddfd917", size = 98141, upload-time = "2026-03-25T20:21:28.492Z" },
+    { url = "https://files.pythonhosted.org/packages/24/22/4daacd05391b92c55759d55eaee21e1dfaea86ce5c571f10083360adf534/tomli-2.4.1-cp312-cp312-win_amd64.whl", hash = "sha256:52c8ef851d9a240f11a88c003eacb03c31fc1c9c4ec64a99a0f922b93874fda9", size = 108847, upload-time = "2026-03-25T20:21:29.386Z" },
+    { url = "https://files.pythonhosted.org/packages/68/fd/70e768887666ddd9e9f5d85129e84910f2db2796f9096aa02b721a53098d/tomli-2.4.1-cp312-cp312-win_arm64.whl", hash = "sha256:f758f1b9299d059cc3f6546ae2af89670cb1c4d48ea29c3cacc4fe7de3058257", size = 95088, upload-time = "2026-03-25T20:21:30.677Z" },
+    { url = "https://files.pythonhosted.org/packages/07/06/b823a7e818c756d9a7123ba2cda7d07bc2dd32835648d1a7b7b7a05d848d/tomli-2.4.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:36d2bd2ad5fb9eaddba5226aa02c8ec3fa4f192631e347b3ed28186d43be6b54", size = 155866, upload-time = "2026-03-25T20:21:31.65Z" },
+    { url = "https://files.pythonhosted.org/packages/14/6f/12645cf7f08e1a20c7eb8c297c6f11d31c1b50f316a7e7e1e1de6e2e7b7e/tomli-2.4.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:eb0dc4e38e6a1fd579e5d50369aa2e10acfc9cace504579b2faabb478e76941a", size = 149887, upload-time = "2026-03-25T20:21:33.028Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/e0/90637574e5e7212c09099c67ad349b04ec4d6020324539297b634a0192b0/tomli-2.4.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c7f2c7f2b9ca6bdeef8f0fa897f8e05085923eb091721675170254cbc5b02897", size = 243704, upload-time = "2026-03-25T20:21:34.51Z" },
+    { url = "https://files.pythonhosted.org/packages/10/8f/d3ddb16c5a4befdf31a23307f72828686ab2096f068eaf56631e136c1fdd/tomli-2.4.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f3c6818a1a86dd6dca7ddcaaf76947d5ba31aecc28cb1b67009a5877c9a64f3f", size = 251628, upload-time = "2026-03-25T20:21:36.012Z" },
+    { url = "https://files.pythonhosted.org/packages/e3/f1/dbeeb9116715abee2485bf0a12d07a8f31af94d71608c171c45f64c0469d/tomli-2.4.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:d312ef37c91508b0ab2cee7da26ec0b3ed2f03ce12bd87a588d771ae15dcf82d", size = 247180, upload-time = "2026-03-25T20:21:37.136Z" },
+    { url = "https://files.pythonhosted.org/packages/d3/74/16336ffd19ed4da28a70959f92f506233bd7cfc2332b20bdb01591e8b1d1/tomli-2.4.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:51529d40e3ca50046d7606fa99ce3956a617f9b36380da3b7f0dd3dd28e68cb5", size = 251674, upload-time = "2026-03-25T20:21:38.298Z" },
+    { url = "https://files.pythonhosted.org/packages/16/f9/229fa3434c590ddf6c0aa9af64d3af4b752540686cace29e6281e3458469/tomli-2.4.1-cp313-cp313-win32.whl", hash = "sha256:2190f2e9dd7508d2a90ded5ed369255980a1bcdd58e52f7fe24b8162bf9fedbd", size = 97976, upload-time = "2026-03-25T20:21:39.316Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/1e/71dfd96bcc1c775420cb8befe7a9d35f2e5b1309798f009dca17b7708c1e/tomli-2.4.1-cp313-cp313-win_amd64.whl", hash = "sha256:8d65a2fbf9d2f8352685bc1364177ee3923d6baf5e7f43ea4959d7d8bc326a36", size = 108755, upload-time = "2026-03-25T20:21:40.248Z" },
+    { url = "https://files.pythonhosted.org/packages/83/7a/d34f422a021d62420b78f5c538e5b102f62bea616d1d75a13f0a88acb04a/tomli-2.4.1-cp313-cp313-win_arm64.whl", hash = "sha256:4b605484e43cdc43f0954ddae319fb75f04cc10dd80d830540060ee7cd0243cd", size = 95265, upload-time = "2026-03-25T20:21:41.219Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/fb/9a5c8d27dbab540869f7c1f8eb0abb3244189ce780ba9cd73f3770662072/tomli-2.4.1-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:fd0409a3653af6c147209d267a0e4243f0ae46b011aa978b1080359fddc9b6cf", size = 155726, upload-time = "2026-03-25T20:21:42.23Z" },
+    { url = "https://files.pythonhosted.org/packages/62/05/d2f816630cc771ad836af54f5001f47a6f611d2d39535364f148b6a92d6b/tomli-2.4.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:a120733b01c45e9a0c34aeef92bf0cf1d56cfe81ed9d47d562f9ed591a9828ac", size = 149859, upload-time = "2026-03-25T20:21:43.386Z" },
+    { url = "https://files.pythonhosted.org/packages/ce/48/66341bdb858ad9bd0ceab5a86f90eddab127cf8b046418009f2125630ecb/tomli-2.4.1-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:559db847dc486944896521f68d8190be1c9e719fced785720d2216fe7022b662", size = 244713, upload-time = "2026-03-25T20:21:44.474Z" },
+    { url = "https://files.pythonhosted.org/packages/df/6d/c5fad00d82b3c7a3ab6189bd4b10e60466f22cfe8a08a9394185c8a8111c/tomli-2.4.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:01f520d4f53ef97964a240a035ec2a869fe1a37dde002b57ebc4417a27ccd853", size = 252084, upload-time = "2026-03-25T20:21:45.62Z" },
+    { url = "https://files.pythonhosted.org/packages/00/71/3a69e86f3eafe8c7a59d008d245888051005bd657760e96d5fbfb0b740c2/tomli-2.4.1-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:7f94b27a62cfad8496c8d2513e1a222dd446f095fca8987fceef261225538a15", size = 247973, upload-time = "2026-03-25T20:21:46.937Z" },
+    { url = "https://files.pythonhosted.org/packages/67/50/361e986652847fec4bd5e4a0208752fbe64689c603c7ae5ea7cb16b1c0ca/tomli-2.4.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:ede3e6487c5ef5d28634ba3f31f989030ad6af71edfb0055cbbd14189ff240ba", size = 256223, upload-time = "2026-03-25T20:21:48.467Z" },
+    { url = "https://files.pythonhosted.org/packages/8c/9a/b4173689a9203472e5467217e0154b00e260621caa227b6fa01feab16998/tomli-2.4.1-cp314-cp314-win32.whl", hash = "sha256:3d48a93ee1c9b79c04bb38772ee1b64dcf18ff43085896ea460ca8dec96f35f6", size = 98973, upload-time = "2026-03-25T20:21:49.526Z" },
+    { url = "https://files.pythonhosted.org/packages/14/58/640ac93bf230cd27d002462c9af0d837779f8773bc03dee06b5835208214/tomli-2.4.1-cp314-cp314-win_amd64.whl", hash = "sha256:88dceee75c2c63af144e456745e10101eb67361050196b0b6af5d717254dddf7", size = 109082, upload-time = "2026-03-25T20:21:50.506Z" },
+    { url = "https://files.pythonhosted.org/packages/d5/2f/702d5e05b227401c1068f0d386d79a589bb12bf64c3d2c72ce0631e3bc49/tomli-2.4.1-cp314-cp314-win_arm64.whl", hash = "sha256:b8c198f8c1805dc42708689ed6864951fd2494f924149d3e4bce7710f8eb5232", size = 96490, upload-time = "2026-03-25T20:21:51.474Z" },
+    { url = "https://files.pythonhosted.org/packages/45/4b/b877b05c8ba62927d9865dd980e34a755de541eb65fffba52b4cc495d4d2/tomli-2.4.1-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:d4d8fe59808a54658fcc0160ecfb1b30f9089906c50b23bcb4c69eddc19ec2b4", size = 164263, upload-time = "2026-03-25T20:21:52.543Z" },
+    { url = "https://files.pythonhosted.org/packages/24/79/6ab420d37a270b89f7195dec5448f79400d9e9c1826df982f3f8e97b24fd/tomli-2.4.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:7008df2e7655c495dd12d2a4ad038ff878d4ca4b81fccaf82b714e07eae4402c", size = 160736, upload-time = "2026-03-25T20:21:53.674Z" },
+    { url = "https://files.pythonhosted.org/packages/02/e0/3630057d8eb170310785723ed5adcdfb7d50cb7e6455f85ba8a3deed642b/tomli-2.4.1-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1d8591993e228b0c930c4bb0db464bdad97b3289fb981255d6c9a41aedc84b2d", size = 270717, upload-time = "2026-03-25T20:21:55.129Z" },
+    { url = "https://files.pythonhosted.org/packages/7a/b4/1613716072e544d1a7891f548d8f9ec6ce2faf42ca65acae01d76ea06bb0/tomli-2.4.1-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:734e20b57ba95624ecf1841e72b53f6e186355e216e5412de414e3c51e5e3c41", size = 278461, upload-time = "2026-03-25T20:21:56.228Z" },
+    { url = "https://files.pythonhosted.org/packages/05/38/30f541baf6a3f6df77b3df16b01ba319221389e2da59427e221ef417ac0c/tomli-2.4.1-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:8a650c2dbafa08d42e51ba0b62740dae4ecb9338eefa093aa5c78ceb546fcd5c", size = 274855, upload-time = "2026-03-25T20:21:57.653Z" },
+    { url = "https://files.pythonhosted.org/packages/77/a3/ec9dd4fd2c38e98de34223b995a3b34813e6bdadf86c75314c928350ed14/tomli-2.4.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:504aa796fe0569bb43171066009ead363de03675276d2d121ac1a4572397870f", size = 283144, upload-time = "2026-03-25T20:21:59.089Z" },
+    { url = "https://files.pythonhosted.org/packages/ef/be/605a6261cac79fba2ec0c9827e986e00323a1945700969b8ee0b30d85453/tomli-2.4.1-cp314-cp314t-win32.whl", hash = "sha256:b1d22e6e9387bf4739fbe23bfa80e93f6b0373a7f1b96c6227c32bef95a4d7a8", size = 108683, upload-time = "2026-03-25T20:22:00.214Z" },
+    { url = "https://files.pythonhosted.org/packages/12/64/da524626d3b9cc40c168a13da8335fe1c51be12c0a63685cc6db7308daae/tomli-2.4.1-cp314-cp314t-win_amd64.whl", hash = "sha256:2c1c351919aca02858f740c6d33adea0c5deea37f9ecca1cc1ef9e884a619d26", size = 121196, upload-time = "2026-03-25T20:22:01.169Z" },
+    { url = "https://files.pythonhosted.org/packages/5a/cd/e80b62269fc78fc36c9af5a6b89c835baa8af28ff5ad28c7028d60860320/tomli-2.4.1-cp314-cp314t-win_arm64.whl", hash = "sha256:eab21f45c7f66c13f2a9e0e1535309cee140182a9cdae1e041d02e47291e8396", size = 100393, upload-time = "2026-03-25T20:22:02.137Z" },
+    { url = "https://files.pythonhosted.org/packages/7b/61/cceae43728b7de99d9b847560c262873a1f6c98202171fd5ed62640b494b/tomli-2.4.1-py3-none-any.whl", hash = "sha256:0d85819802132122da43cb86656f8d1f8c6587d54ae7dcaf30e90533028b49fe", size = 14583, upload-time = "2026-03-25T20:22:03.012Z" },
+]
+
+[[package]]
+name = "typing-extensions"
+version = "4.16.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f6/cc/6253133b5bb138fc3306cebfbda2c520f545d36b5be2c7255cc528bb45d6/typing_extensions-4.16.0.tar.gz", hash = "sha256:dc983d19a509c94dba722ee6abd33940f7c05a89e243c47e907eb4db6f1a43e5", size = 113555, upload-time = "2026-07-02T08:40:05.92Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/49/d3/b8441a820a491ddfc024b0b0cf0393375b75ea13866d9c66727e54c2fc80/typing_extensions-4.16.0-py3-none-any.whl", hash = "sha256:481caa481374e813c1b176ada14e97f1f67a4539ce9cfeb3f350d78d6370c2e8", size = 45571, upload-time = "2026-07-02T08:40:04.659Z" },
+]