identify-sdk 0.1.0__tar.gz

identify_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,53 @@
+Metadata-Version: 2.4
+Name: identify-sdk
+Version: 0.1.0
+Summary: Python client for the Identify auth service
+License: MIT
+Project-URL: Homepage, https://github.com/1909-pramod/identify-sdk
+Project-URL: Repository, https://github.com/1909-pramod/identify-sdk
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.31
+Provides-Extra: dev
+Requires-Dist: mypy; extra == "dev"
+Requires-Dist: types-requests; extra == "dev"
+
+# identify-sdk (Python)
+
+Python client for [identify](https://github.com/1909-pramod/identify-sdk) — a self-hosted modular authentication service.
+
+## Installation
+
+```bash
+pip install identify-sdk
+```
+
+## Usage
+
+```python
+from identify_sdk import IdentifyClient, IdentifyError
+
+client = IdentifyClient(base_url="http://localhost:8080")
+
+# Exchange username + password for a JWT
+resp = client.login_with_password("user@example.com", "secret")
+token = resp.token
+
+# Validate a JWT
+result = client.validate_token(token)
+print(result.valid, result.identity.primary_identifier)
+
+# Get identity for an authenticated token
+identity = client.get_me(token)
+```
+
+## Error handling
+
+```python
+try:
+    resp = client.login_with_password("user@example.com", "wrong")
+except IdentifyError as e:
+    print(e.status_code, str(e))  # 401, "HTTP 401: ..."
+```
+
+Full documentation: [github.com/1909-pramod/identify-sdk](https://github.com/1909-pramod/identify-sdk)

identify_sdk-0.1.0/README.md

@@ -0,0 +1,39 @@
+# identify-sdk (Python)
+
+Python client for [identify](https://github.com/1909-pramod/identify-sdk) — a self-hosted modular authentication service.
+
+## Installation
+
+```bash
+pip install identify-sdk
+```
+
+## Usage
+
+```python
+from identify_sdk import IdentifyClient, IdentifyError
+
+client = IdentifyClient(base_url="http://localhost:8080")
+
+# Exchange username + password for a JWT
+resp = client.login_with_password("user@example.com", "secret")
+token = resp.token
+
+# Validate a JWT
+result = client.validate_token(token)
+print(result.valid, result.identity.primary_identifier)
+
+# Get identity for an authenticated token
+identity = client.get_me(token)
+```
+
+## Error handling
+
+```python
+try:
+    resp = client.login_with_password("user@example.com", "wrong")
+except IdentifyError as e:
+    print(e.status_code, str(e))  # 401, "HTTP 401: ..."
+```
+
+Full documentation: [github.com/1909-pramod/identify-sdk](https://github.com/1909-pramod/identify-sdk)

identify_sdk-0.1.0/identify_sdk/__init__.py

@@ -0,0 +1,10 @@
+from .client import IdentifyClient, IdentifyError
+from .types import Identity, TokenResponse, ValidateResponse
+
+__all__ = [
+    "IdentifyClient",
+    "IdentifyError",
+    "Identity",
+    "TokenResponse",
+    "ValidateResponse",
+]

identify_sdk-0.1.0/identify_sdk/client.py

@@ -0,0 +1,86 @@
+import base64
+from typing import Any
+
+import requests
+
+from .types import Identity, TokenResponse, ValidateResponse
+
+
+class IdentifyError(Exception):
+    def __init__(self, status_code: int, message: str) -> None:
+        super().__init__(f"HTTP {status_code}: {message}")
+        self.status_code = status_code
+
+
+class IdentifyClient:
+    def __init__(self, base_url: str) -> None:
+        self._base_url = base_url.rstrip("/")
+
+    def _post(self, path: str, auth_header: str) -> dict[str, Any]:
+        resp = requests.post(
+            f"{self._base_url}{path}",
+            headers={"Authorization": auth_header},
+        )
+        body: dict[str, Any] = resp.json()
+        if not resp.ok:
+            raise IdentifyError(resp.status_code, body.get("error", "request failed"))
+        return body
+
+    def _get(self, path: str, token: str) -> dict[str, Any]:
+        resp = requests.get(
+            f"{self._base_url}{path}",
+            headers={"Authorization": f"Bearer {token}"},
+        )
+        body: dict[str, Any] = resp.json()
+        if not resp.ok:
+            raise IdentifyError(resp.status_code, body.get("error", "request failed"))
+        return body
+
+    @staticmethod
+    def _parse_identity(data: dict[str, Any]) -> Identity:
+        return Identity(
+            id=data["id"],
+            primary_identifier=data["primary_identifier"],
+            identifier_group_name=data.get("identifier_group_name"),
+            identifier_group_type=data.get("identifier_group_type"),
+            user_type=data.get("user_type"),
+            expiry_at=data.get("expiry_at"),
+            roles=data.get("roles"),
+            is_super_admin=data.get("is_super_admin", False),
+        )
+
+    @staticmethod
+    def _parse_token_response(data: dict[str, Any]) -> TokenResponse:
+        return TokenResponse(
+            token=data["token"],
+            token_type=data["token_type"],
+            expires_in=data["expires_in"],
+        )
+
+    def login_with_password(self, username: str, password: str) -> TokenResponse:
+        """Exchange username/password for a JWT."""
+        encoded = base64.b64encode(f"{username}:{password}".encode()).decode()
+        return self._parse_token_response(self._post("/auth", f"Basic {encoded}"))
+
+    def login_with_google(self, google_id_token: str) -> TokenResponse:
+        """Exchange a Google ID token for an internal JWT."""
+        return self._parse_token_response(
+            self._post("/auth", f"Bearer {google_id_token}")
+        )
+
+    def refresh_token(self, token: str) -> TokenResponse:
+        """Exchange an existing internal JWT for a fresh one."""
+        return self._parse_token_response(self._post("/auth", f"Bearer {token}"))
+
+    def validate_token(self, token: str) -> ValidateResponse:
+        """Validate a JWT and return the resolved identity."""
+        data = self._post("/token", f"Bearer {token}")
+        return ValidateResponse(
+            valid=data["valid"],
+            identity=self._parse_identity(data["identity"]),
+            expires_at=data.get("expires_at"),
+        )
+
+    def get_me(self, token: str) -> Identity:
+        """Return the identity for the authenticated token."""
+        return self._parse_identity(self._get("/me", token))

identify_sdk-0.1.0/identify_sdk/types.py

@@ -0,0 +1,28 @@
+from dataclasses import dataclass, field
+from typing import Optional
+
+
+@dataclass
+class Identity:
+    id: int
+    primary_identifier: str
+    identifier_group_name: Optional[str] = None
+    identifier_group_type: Optional[str] = None
+    user_type: Optional[str] = None
+    expiry_at: Optional[str] = None
+    roles: Optional[list[str]] = None
+    is_super_admin: bool = False
+
+
+@dataclass
+class TokenResponse:
+    token: str
+    token_type: str
+    expires_in: int
+
+
+@dataclass
+class ValidateResponse:
+    valid: bool
+    identity: Identity
+    expires_at: Optional[str] = None

identify_sdk-0.1.0/identify_sdk.egg-info/PKG-INFO

@@ -0,0 +1,53 @@
+Metadata-Version: 2.4
+Name: identify-sdk
+Version: 0.1.0
+Summary: Python client for the Identify auth service
+License: MIT
+Project-URL: Homepage, https://github.com/1909-pramod/identify-sdk
+Project-URL: Repository, https://github.com/1909-pramod/identify-sdk
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.31
+Provides-Extra: dev
+Requires-Dist: mypy; extra == "dev"
+Requires-Dist: types-requests; extra == "dev"
+
+# identify-sdk (Python)
+
+Python client for [identify](https://github.com/1909-pramod/identify-sdk) — a self-hosted modular authentication service.
+
+## Installation
+
+```bash
+pip install identify-sdk
+```
+
+## Usage
+
+```python
+from identify_sdk import IdentifyClient, IdentifyError
+
+client = IdentifyClient(base_url="http://localhost:8080")
+
+# Exchange username + password for a JWT
+resp = client.login_with_password("user@example.com", "secret")
+token = resp.token
+
+# Validate a JWT
+result = client.validate_token(token)
+print(result.valid, result.identity.primary_identifier)
+
+# Get identity for an authenticated token
+identity = client.get_me(token)
+```
+
+## Error handling
+
+```python
+try:
+    resp = client.login_with_password("user@example.com", "wrong")
+except IdentifyError as e:
+    print(e.status_code, str(e))  # 401, "HTTP 401: ..."
+```
+
+Full documentation: [github.com/1909-pramod/identify-sdk](https://github.com/1909-pramod/identify-sdk)

identify_sdk-0.1.0/identify_sdk.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+README.md
+pyproject.toml
+identify_sdk/__init__.py
+identify_sdk/client.py
+identify_sdk/types.py
+identify_sdk.egg-info/PKG-INFO
+identify_sdk.egg-info/SOURCES.txt
+identify_sdk.egg-info/dependency_links.txt
+identify_sdk.egg-info/requires.txt
+identify_sdk.egg-info/top_level.txt

identify_sdk-0.1.0/identify_sdk.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

identify_sdk-0.1.0/identify_sdk.egg-info/requires.txt

@@ -0,0 +1,5 @@
+requests>=2.31
+
+[dev]
+mypy
+types-requests

identify_sdk-0.1.0/identify_sdk.egg-info/top_level.txt

@@ -0,0 +1 @@
+identify_sdk

identify_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "identify-sdk"
+version = "0.1.0"
+description = "Python client for the Identify auth service"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+dependencies = ["requests>=2.31"]
+
+[project.urls]
+Homepage = "https://github.com/1909-pramod/identify-sdk"
+Repository = "https://github.com/1909-pramod/identify-sdk"
+
+[project.optional-dependencies]
+dev = ["mypy", "types-requests"]
+
+[tool.mypy]
+strict = true

identify_sdk-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+