iam-client 0.1.1__tar.gz

iam_client-0.1.1/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: iam-client
+Version: 0.1.1
+Summary: IAM client for services
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.31.0
+Requires-Dist: pydantic>=2.5.0
+
+# iam-client
+
+A lightweight, production-ready **IAM client SDK** for backend services.
+
+This package allows backend services to securely communicate with the
+Identity and Access Management (IAM) system using **service credentials**.
+
+---
+
+## ✨ Features
+
+- Service-to-service authentication
+- Automatic service token retrieval
+- Token introspection
+- Fetch user details by user ID
+- Clean, minimal Python API
+- Designed for FastAPI backends
+
+---
+
+## 📦 Installation
+
+### Install directly from GitHub
+
+```bash
+pip install git+https://github.com/YOUR_ORG/iam-client.git
+```
+
+
+### Install directly from GitHub
+
+```bash
+pip install git+https://github.com/YOUR_ORG/iam-client.git@v0.1.0
+```
+
+
+## ✨ Configuration
+Set the following environment variables in the consuming backend service:
+```
+IAM_BASE_URL=https://iam.xyz.com
+TENANT_SLUG=xyz
+IAM_CLIENT_ID=xyz-backend
+IAM_CLIENT_SECRET=super-secret
+```
+
+## ✨ Usage
+### Create IAM client (once per service)
+```
+from iam_client.client import IAMClient
+
+iam = IAMClient(
+    base_url="https://iam.xyz.com",
+    tenant_slug="xyz",
+    client_id="xyz-backend",
+    client_secret="super-secret",
+)
+```

iam_client-0.1.1/README.md

@@ -0,0 +1,57 @@
+# iam-client
+
+A lightweight, production-ready **IAM client SDK** for backend services.
+
+This package allows backend services to securely communicate with the
+Identity and Access Management (IAM) system using **service credentials**.
+
+---
+
+## ✨ Features
+
+- Service-to-service authentication
+- Automatic service token retrieval
+- Token introspection
+- Fetch user details by user ID
+- Clean, minimal Python API
+- Designed for FastAPI backends
+
+---
+
+## 📦 Installation
+
+### Install directly from GitHub
+
+```bash
+pip install git+https://github.com/YOUR_ORG/iam-client.git
+```
+
+
+### Install directly from GitHub
+
+```bash
+pip install git+https://github.com/YOUR_ORG/iam-client.git@v0.1.0
+```
+
+
+## ✨ Configuration
+Set the following environment variables in the consuming backend service:
+```
+IAM_BASE_URL=https://iam.xyz.com
+TENANT_SLUG=xyz
+IAM_CLIENT_ID=xyz-backend
+IAM_CLIENT_SECRET=super-secret
+```
+
+## ✨ Usage
+### Create IAM client (once per service)
+```
+from iam_client.client import IAMClient
+
+iam = IAMClient(
+    base_url="https://iam.xyz.com",
+    tenant_slug="xyz",
+    client_id="xyz-backend",
+    client_secret="super-secret",
+)
+```

iam_client-0.1.1/iam_client/client.py

@@ -0,0 +1,52 @@
+import requests
+from typing import Optional
+from .schemas import IAMUser, TokenIntrospection
+from .exceptions import IAMUnauthorized, IAMUnavailable
+
+
+class IAMClient:
+    def __init__(
+        self,
+        base_url: str,
+        tenant_slug: str,
+        client_id: str,
+        client_secret: str,
+        timeout: int = 5,
+    ):
+        self.base_url = base_url.rstrip("/")
+        self.tenant_slug = tenant_slug
+        self.client_id = client_id
+        self.client_secret = client_secret
+        self.timeout = timeout
+        self._client_token: Optional[str] = None
+
+    def _get_client_token(self) -> str:
+        resp = requests.post(
+            f"{self.base_url}/auth/client-token",
+            json={
+                "tenant_slug": self.tenant_slug,
+                "client_id": self.client_id,
+                "client_secret": self.client_secret,
+            },
+            timeout=self.timeout,
+        )
+
+        if resp.status_code != 200:
+            raise IAMUnauthorized("Failed to get client token")
+
+        return resp.json()["access_token"]
+
+    def _headers(self):
+        if not self._client_token:
+            self._client_token = self._get_client_token()
+        return {"Authorization": f"Bearer {self._client_token}"}
+
+    def get_user(self, user_id: str) -> IAMUser:
+        resp = requests.get(
+            f"{self.base_url}/users/{user_id}",
+            headers=self._headers(),
+            timeout=self.timeout,
+        )
+        if resp.status_code != 200:
+            raise IAMUnavailable("Failed to fetch user")
+        return IAMUser(**resp.json())

iam_client-0.1.1/iam_client/exceptions.py

@@ -0,0 +1,10 @@
+class IAMError(Exception):
+    pass
+
+
+class IAMUnauthorized(IAMError):
+    pass
+
+
+class IAMUnavailable(IAMError):
+    pass

iam_client-0.1.1/iam_client/schemas.py

@@ -0,0 +1,21 @@
+from pydantic import BaseModel
+from typing import List
+import uuid
+
+
+class IAMUser(BaseModel):
+    id: uuid.UUID
+    tenant_id: uuid.UUID
+    email: str | None
+    phone: str | None
+    roles: List[str]
+    is_active: bool
+
+
+class TokenIntrospection(BaseModel):
+    active: bool
+    sub: uuid.UUID
+    tenant_id: uuid.UUID
+    client_id: uuid.UUID
+    roles: List[str]
+    scopes: List[str]

iam_client-0.1.1/iam_client.egg-info/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: iam-client
+Version: 0.1.1
+Summary: IAM client for services
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.31.0
+Requires-Dist: pydantic>=2.5.0
+
+# iam-client
+
+A lightweight, production-ready **IAM client SDK** for backend services.
+
+This package allows backend services to securely communicate with the
+Identity and Access Management (IAM) system using **service credentials**.
+
+---
+
+## ✨ Features
+
+- Service-to-service authentication
+- Automatic service token retrieval
+- Token introspection
+- Fetch user details by user ID
+- Clean, minimal Python API
+- Designed for FastAPI backends
+
+---
+
+## 📦 Installation
+
+### Install directly from GitHub
+
+```bash
+pip install git+https://github.com/YOUR_ORG/iam-client.git
+```
+
+
+### Install directly from GitHub
+
+```bash
+pip install git+https://github.com/YOUR_ORG/iam-client.git@v0.1.0
+```
+
+
+## ✨ Configuration
+Set the following environment variables in the consuming backend service:
+```
+IAM_BASE_URL=https://iam.xyz.com
+TENANT_SLUG=xyz
+IAM_CLIENT_ID=xyz-backend
+IAM_CLIENT_SECRET=super-secret
+```
+
+## ✨ Usage
+### Create IAM client (once per service)
+```
+from iam_client.client import IAMClient
+
+iam = IAMClient(
+    base_url="https://iam.xyz.com",
+    tenant_slug="xyz",
+    client_id="xyz-backend",
+    client_secret="super-secret",
+)
+```

iam_client-0.1.1/iam_client.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+iam_client/__init__.py
+iam_client/client.py
+iam_client/exceptions.py
+iam_client/schemas.py
+iam_client.egg-info/PKG-INFO
+iam_client.egg-info/SOURCES.txt
+iam_client.egg-info/dependency_links.txt
+iam_client.egg-info/requires.txt
+iam_client.egg-info/top_level.txt

iam_client-0.1.1/iam_client.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

iam_client-0.1.1/iam_client.egg-info/requires.txt

@@ -0,0 +1,2 @@
+requests>=2.31.0
+pydantic>=2.5.0

iam_client-0.1.1/iam_client.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+dist
+iam_client

iam_client-0.1.1/pyproject.toml

@@ -0,0 +1,17 @@
+[build-system]
+requires = ["setuptools>=68.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "iam-client"
+version = "0.1.1"
+description = "IAM client for services"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "requests>=2.31.0",
+    "pydantic>=2.5.0"
+]
+
+[tool.setuptools.packages.find]
+where = ["."]

iam_client-0.1.1/setup.cfg

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