gentic-sdk 0.1.0__py3-none-any.whl

gentic_sdk/__init__.py

@@ -0,0 +1,4 @@
+from gentic_sdk.client import GenticHub
+from gentic_sdk.exceptions import GenticHubError
+
+__all__ = ["GenticHub", "GenticHubError"]

gentic_sdk/client.py

@@ -0,0 +1,116 @@
+import json
+from collections.abc import Callable
+from functools import lru_cache
+from typing import Any, TypeVar
+from urllib.parse import quote
+
+import httpx
+from pydantic import BaseModel, TypeAdapter
+
+from gentic_sdk import models
+from gentic_sdk.exceptions import GenticHubError
+from gentic_sdk.resources.account import AccountApi
+from gentic_sdk.resources.activity import ActivityApi
+from gentic_sdk.resources.auth import AuthApi
+from gentic_sdk.resources.categories import CategoriesApi
+from gentic_sdk.resources.cli import CliApi
+from gentic_sdk.resources.health import HealthApi
+from gentic_sdk.resources.library import LibraryApi
+from gentic_sdk.resources.oauth import OauthApi
+from gentic_sdk.resources.notifications import NotificationsApi
+from gentic_sdk.resources.profiles import ProfilesApi
+from gentic_sdk.resources.projects import ProjectsApi
+from gentic_sdk.resources.recommend import RecommendApi
+from gentic_sdk.resources.skills import SkillsApi
+from gentic_sdk.resources.subscriptions import SubscriptionsApi
+
+Result = TypeVar("Result")
+TokenSource = str | Callable[[], str | None]
+
+
+@lru_cache
+def adapter_for(result_type: Any) -> TypeAdapter[Any]:
+    return TypeAdapter(result_type)
+
+
+class GenticHub:
+    def __init__(self, base_url: str, token: TokenSource | None = None, timeout: float = 30.0, http_client: httpx.Client | None = None) -> None:
+        self.token = token
+        self.http_client = http_client or httpx.Client(base_url=base_url.rstrip("/"), timeout=timeout)
+        self.health = HealthApi(self)
+        self.auth = AuthApi(self)
+        self.skills = SkillsApi(self)
+        self.categories = CategoriesApi(self)
+        self.cli = CliApi(self)
+        self.library = LibraryApi(self)
+        self.account = AccountApi(self)
+        self.activity = ActivityApi(self)
+        self.notifications = NotificationsApi(self)
+        self.profiles = ProfilesApi(self)
+        self.projects = ProjectsApi(self)
+        self.oauth = OauthApi(self)
+        self.subscriptions = SubscriptionsApi(self)
+        self.recommend = RecommendApi(self)
+
+    def __enter__(self) -> "GenticHub":
+        return self
+
+    def __exit__(self, *_exception: object) -> None:
+        self.close()
+
+    def close(self) -> None:
+        self.http_client.close()
+
+    def sign_in(self, email: str, password: str) -> models.TokenResponse:
+        token = self.auth.token(models.TokenRequest(email=email, password=password))
+        if not isinstance(token, models.TokenResponse):
+            raise GenticHubError(500, "unexpected_answer")
+        self.token = token.access_token
+        return token
+
+    def sign_out(self) -> None:
+        self.auth.sign_out()
+        self.token = None
+
+    def request(
+        self,
+        method: str,
+        path: str,
+        result_type: type[Result] | Any = None,
+        *,
+        path_parameters: dict[str, Any] | None = None,
+        query: dict[str, Any] | None = None,
+        body: BaseModel | dict[str, Any] | None = None,
+    ) -> Any:
+        headers = {"accept": "application/json"}
+        token = self.token() if callable(self.token) else self.token
+        if token:
+            headers["authorization"] = f"Bearer {token}"
+        filled_path = path.format(**{name: quote(str(value), safe="") for name, value in (path_parameters or {}).items()})
+        content = None
+        if body is not None:
+            headers["content-type"] = "application/json"
+            payload = body.model_dump(mode="json", exclude_unset=True) if isinstance(body, BaseModel) else body
+            content = json.dumps(payload)
+        response = self.http_client.request(
+            method,
+            filled_path,
+            params={name: value for name, value in (query or {}).items() if value is not None},
+            headers=headers,
+            content=content,
+        )
+        if response.is_error:
+            raise GenticHubError(response.status_code, self.error_detail(response))
+        if response.status_code == 204 or result_type is None:
+            return None
+        return adapter_for(result_type).validate_python(response.json())
+
+    @staticmethod
+    def error_detail(response: httpx.Response) -> str:
+        try:
+            detail = response.json().get("detail")
+        except (ValueError, AttributeError):
+            detail = None
+        if detail is None:
+            return response.reason_phrase
+        return detail if isinstance(detail, str) else json.dumps(detail)

gentic_sdk/exceptions.py

@@ -0,0 +1,5 @@
+class GenticHubError(Exception):
+    def __init__(self, status: int, detail: str) -> None:
+        super().__init__(detail)
+        self.status = status
+        self.detail = detail