gstaccelerator 0.1.0__py3-none-any.whl

gstaccelerator/__init__.py

@@ -0,0 +1,20 @@
+from .client import GSTAccelerator
+from .exceptions import (
+    GSTAcceleratorError, AuthenticationError, RateLimitError,
+    NotFoundError, ValidationError, ServerError
+)
+from .models import HSNResult, GSTINResult, TaxRates, ApplicableRate
+
+__all__ = [
+    "GSTAccelerator",
+    "GSTAcceleratorError",
+    "AuthenticationError",
+    "RateLimitError",
+    "NotFoundError",
+    "ValidationError",
+    "ServerError",
+    "HSNResult",
+    "GSTINResult",
+    "TaxRates",
+    "ApplicableRate"
+]

gstaccelerator/client.py

@@ -0,0 +1,147 @@
+import httpx
+import time
+from typing import List, Dict, Optional, Any
+from .exceptions import (
+    GSTAcceleratorError, AuthenticationError, RateLimitError,
+    NotFoundError, ValidationError, ServerError
+)
+
+class _BaseClient:
+    def __init__(self, client: httpx.Client):
+        self._client = client
+
+    def _request(self, method: str, path: str, **kwargs) -> Any:
+        max_retries = self._client._gsta_max_retries
+        retry_delay = self._client._gsta_retry_delay
+        
+        for attempt in range(max_retries + 1):
+            try:
+                response = self._client.request(method, path, **kwargs)
+                
+                if response.status_code < 400:
+                    return response.json() if response.content else {}
+                    
+                resp_json = response.json() if response.content else {}
+                
+                if response.status_code == 401:
+                    raise AuthenticationError("Authentication failed", 401, resp_json)
+                elif response.status_code == 404:
+                    raise NotFoundError("Resource not found", 404, resp_json)
+                elif response.status_code in (400, 422):
+                    raise ValidationError("Validation error", response.status_code, resp_json)
+                elif response.status_code == 429:
+                    if attempt < max_retries:
+                        retry_after = response.headers.get("Retry-After")
+                        sleep_time = float(retry_after) if retry_after else retry_delay * (2 ** attempt)
+                        time.sleep(sleep_time)
+                        continue
+                    raise RateLimitError("Rate limit exceeded", 429, resp_json)
+                elif response.status_code >= 500:
+                    if attempt < max_retries:
+                        time.sleep(retry_delay * (2 ** attempt))
+                        continue
+                    raise ServerError(f"Server error: {response.status_code}", response.status_code, resp_json)
+                
+                response.raise_for_status()
+                
+            except httpx.RequestError as e:
+                if attempt < max_retries:
+                    time.sleep(retry_delay * (2 ** attempt))
+                    continue
+                raise GSTAcceleratorError(f"Request failed: {str(e)}")
+        
+        return {}
+
+class HSNClient(_BaseClient):
+    def get(self, code: str) -> dict:
+        return self._request("GET", f"/api/v1/hsn/{code}")
+
+class SACClient(_BaseClient):
+    def get(self, code: str) -> dict:
+        return self._request("GET", f"/api/v1/sac/{code}")
+
+class GSTINClient(_BaseClient):
+    def validate(self, gstin: str) -> dict:
+        return self._request("GET", f"/api/v1/gstin/{gstin}/validate")
+        
+    def state(self, gstin: str) -> dict:
+        return self._request("GET", f"/api/v1/gstin/{gstin}/state")
+        
+    def pan(self, gstin: str) -> dict:
+        return self._request("GET", f"/api/v1/gstin/{gstin}/pan")
+
+class GSTAccelerator:
+    def __init__(
+        self,
+        api_key: str = "",
+        base_url: str = "https://gstaccelerator.in",
+        timeout: int = 30,
+        max_retries: int = 3,
+        retry_delay: float = 1.0
+    ):
+        from importlib.metadata import version, PackageNotFoundError
+        try:
+            pkg_version = version("gstaccelerator")
+        except PackageNotFoundError:
+            pkg_version = "0.1.0"
+            
+        headers = {
+            "User-Agent": f"gstaccelerator-python/{pkg_version}",
+            "Content-Type": "application/json"
+        }
+        if api_key:
+            headers["Authorization"] = f"Bearer {api_key}"
+            
+        self._client = httpx.Client(
+            base_url=base_url,
+            timeout=timeout,
+            headers=headers
+        )
+        self._client._gsta_max_retries = max_retries
+        self._client._gsta_retry_delay = retry_delay
+        
+        self.hsn = HSNClient(self._client)
+        self.sac = SACClient(self._client)
+        self.gstin = GSTINClient(self._client)
+
+    def lookup(
+        self,
+        description: str,
+        supply_type: Optional[str] = None,
+        branded: Optional[bool] = None,
+        sale_value_inr: Optional[float] = None,
+        state_of_supply: Optional[str] = None
+    ) -> List[Dict]:
+        payload = {"description": description}
+        if supply_type is not None: payload["supply_type"] = supply_type
+        if branded is not None: payload["branded"] = branded
+        if sale_value_inr is not None: payload["sale_value_inr"] = sale_value_inr
+        if state_of_supply is not None: payload["state_of_supply"] = state_of_supply
+        
+        base = _BaseClient(self._client)
+        return base._request("POST", "/api/v1/lookup", json=payload)
+
+    def autocomplete(self, query: str) -> List[str]:
+        base = _BaseClient(self._client)
+        return base._request("GET", "/api/v1/autocomplete", params={"q": query})
+
+    def bulk(self, descriptions: List[str]) -> List[List[Dict]]:
+        base = _BaseClient(self._client)
+        return base._request("POST", "/api/v1/bulk", json={"descriptions": descriptions})
+        
+    def health(self) -> dict:
+        base = _BaseClient(self._client)
+        return base._request("GET", "/api/v1/health")
+        
+    def meta(self) -> dict:
+        base = _BaseClient(self._client)
+        return base._request("GET", "/api/v1/meta")
+        
+    def close(self):
+        self._client.close()
+        
+    def __enter__(self):
+        return self
+        
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        self.close()

gstaccelerator/exceptions.py

@@ -0,0 +1,14 @@
+from typing import Optional, Dict, Any
+
+class GSTAcceleratorError(Exception):
+    def __init__(self, message: str, status_code: Optional[int] = None, response_body: Optional[Dict[str, Any]] = None):
+        super().__init__(message)
+        self.message = message
+        self.status_code = status_code
+        self.response_body = response_body or {}
+
+class AuthenticationError(GSTAcceleratorError): pass
+class RateLimitError(GSTAcceleratorError): pass
+class NotFoundError(GSTAcceleratorError): pass
+class ValidationError(GSTAcceleratorError): pass
+class ServerError(GSTAcceleratorError): pass

gstaccelerator/models.py

@@ -0,0 +1,37 @@
+from dataclasses import dataclass
+from typing import Optional
+
+@dataclass
+class TaxRates:
+    igst: float
+    cgst: float
+    sgst: float
+    cess: float
+
+@dataclass
+class ApplicableRate:
+    intrastate: str
+    interstate: str
+
+@dataclass
+class HSNResult:
+    hsn_code: str
+    description: str
+    tax_rates: TaxRates
+    applicable_rate: ApplicableRate
+    notification_ref: str
+    confidence: float
+    needs_review: bool
+    condition_applied: Optional[str] = None
+    condition_warning: Optional[str] = None
+    last_updated: Optional[str] = None
+
+@dataclass
+class GSTINResult:
+    valid: bool
+    gstin: str
+    state_code: Optional[str] = None
+    state_name: Optional[str] = None
+    pan: Optional[str] = None
+    entity_type_code: Optional[str] = None
+    error_reason: Optional[str] = None

gstaccelerator-0.1.0.dist-info/METADATA

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: gstaccelerator
+Version: 0.1.0
+Summary: Python client for the GST Accelerator API — India GST HSN/SAC lookup, GSTIN validation, condition resolver
+Project-URL: Homepage, https://gstaccelerator.in
+Project-URL: Documentation, https://gstaccelerator.in/docs
+Project-URL: Repository, https://github.com/thedivine1/gst-hsn-api
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.24.0
+Dynamic: license-file
+
+# GST Accelerator Python Client
+
+Python client for the GST Accelerator API — India GST HSN/SAC lookup, GSTIN validation, and condition resolver.
+
+## Installation
+
+```bash
+pip install gstaccelerator
+```
+
+## Quickstart
+
+```python
+from gstaccelerator import GSTAccelerator
+
+gst = GSTAccelerator(api_key="your_api_key_here")
+result = gst.hsn.get("84151010")
+print(result)
+```
+
+## Method Reference
+
+| Resource | Method | Description |
+|---|---|---|
+| `gst.hsn` | `get(code: str)` | HSN lookup |
+| `gst.sac` | `get(code: str)` | SAC lookup |
+| `gst` | `lookup(description: str, ...)` | Description search |
+| `gst` | `autocomplete(query: str)` | Autocomplete |
+| `gst` | `bulk(descriptions: list[str])` | Bulk lookup |
+| `gst.gstin` | `validate(gstin: str)` | GSTIN validation |
+| `gst.gstin` | `state(gstin: str)` | Get state info for GSTIN |
+| `gst.gstin` | `pan(gstin: str)` | Get PAN info for GSTIN |
+| `gst` | `health()` | Health check |
+| `gst` | `meta()` | Meta data |
+
+## Exception Handling
+
+```python
+from gstaccelerator import GSTAccelerator, RateLimitError, AuthenticationError
+
+gst = GSTAccelerator(api_key="your_api_key_here")
+
+try:
+    result = gst.hsn.get("84151010")
+except AuthenticationError as e:
+    print(f"Auth failed: {e.message}")
+except RateLimitError as e:
+    print(f"Rate limited: {e.message}")
+```
+
+## Full Documentation
+
+For full documentation, visit: https://gstaccelerator.in/docs

gstaccelerator-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+gstaccelerator/__init__.py,sha256=X7YPPH0X-GdzkjADzgX3Vs4_wR62tgmfGCjt9oLW-rs,491
+gstaccelerator/client.py,sha256=FnXip3Ba26GsFLeFtFSDh98PAU6ryDTNlvbsBabycaA,5631
+gstaccelerator/exceptions.py,sha256=6IECs08CWvLVh1ntU8F1Bguk918xF7CiiEtbVE4WaHE,595
+gstaccelerator/models.py,sha256=ISOuDFnz4y107ryVlUysfVtm0eK95_pPkmz2SCg45SQ,802
+gstaccelerator-0.1.0.dist-info/licenses/LICENSE,sha256=1NtrO7G-Zs_RDmKygBVvd17SvVJe0FWY6kjW-kgcm2A,1072
+gstaccelerator-0.1.0.dist-info/METADATA,sha256=k8zDluzk9JzNriQZAxECzsxoej5u9DGw6x6SwFsEutc,1963
+gstaccelerator-0.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+gstaccelerator-0.1.0.dist-info/top_level.txt,sha256=LRD--2m7tsUj_UBSYDZzFzmrRnujZo2Tf5at0tybje4,15
+gstaccelerator-0.1.0.dist-info/RECORD,,

gstaccelerator-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

gstaccelerator-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 GST Accelerator
+
+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.

gstaccelerator-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+gstaccelerator