gentic-sdk 0.1.0__tar.gz

gentic_sdk-0.1.0/.gitignore

@@ -0,0 +1,4 @@
+.venv
+dist
+__pycache__
+*.egg-info

gentic_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,24 @@
+Metadata-Version: 2.5
+Name: gentic-sdk
+Version: 0.1.0
+Summary: Python SDK for the GenticHub API
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic[email]>=2.7
+Description-Content-Type: text/markdown
+
+# gentic-sdk
+
+Python client for the GenticHub API.
+
+```python
+from gentic_sdk import GenticHub
+
+hub = GenticHub("http://localhost:8000/api")
+hub.sign_in("ana@example.com", "a-password")
+
+skill = hub.skills.get_public("pdf-processing")
+print(skill.skill.name)
+```
+
+Every call returns a model from `gentic_sdk.models`. A call that the API refuses raises `GenticHubError` with the `status` and the `detail` the API sent (for example `invalid_credentials`). Over the API's rate limit the status is 429 and the `detail` is `too_many_requests` (see `docs/rate-limiting.md`); wait before trying again.

gentic_sdk-0.1.0/README.md

@@ -0,0 +1,15 @@
+# gentic-sdk
+
+Python client for the GenticHub API.
+
+```python
+from gentic_sdk import GenticHub
+
+hub = GenticHub("http://localhost:8000/api")
+hub.sign_in("ana@example.com", "a-password")
+
+skill = hub.skills.get_public("pdf-processing")
+print(skill.skill.name)
+```
+
+Every call returns a model from `gentic_sdk.models`. A call that the API refuses raises `GenticHubError` with the `status` and the `detail` the API sent (for example `invalid_credentials`). Over the API's rate limit the status is 429 and the `detail` is `too_many_requests` (see `docs/rate-limiting.md`); wait before trying again.

gentic_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,26 @@
+[project]
+name = "gentic-sdk"
+version = "0.1.0"
+description = "Python SDK for the GenticHub API"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+    "httpx>=0.27",
+    "pydantic[email]>=2.7",
+]
+
+[dependency-groups]
+dev = [
+    "datamodel-code-generator>=0.25",
+    "pytest>=8",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/gentic_sdk"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

gentic_sdk-0.1.0/scripts/generate-models.sh

@@ -0,0 +1,16 @@
+#!/usr/bin/env bash
+# Regenerates src/gentic_sdk/models.py from the API description. Run it after api/openapi.yaml changes.
+set -euo pipefail
+
+cd "$(dirname "$0")/.."
+
+uv run datamodel-codegen \
+  --input ../../api/openapi.yaml \
+  --input-file-type openapi \
+  --output src/gentic_sdk/models.py \
+  --output-model-type pydantic_v2.BaseModel \
+  --target-python-version 3.11 \
+  --use-annotated \
+  --use-standard-collections \
+  --use-union-operator \
+  --disable-timestamp

gentic_sdk-0.1.0/scripts/publish.sh

@@ -0,0 +1,59 @@
+#!/usr/bin/env bash
+# Publishes the SDK. Usage: scripts/publish.sh [--public] [--dry-run]
+# By default it uploads to TestPyPI (https://test.pypi.org), for trying a release; with --public it uploads to the real PyPI.
+# SDK_PUBLISH_URL, when set, replaces both with the upload URL of another index (a private one, for example).
+# SDK_CHECK_URL (optional) is the index URL to look in, to skip files that are already published; PyPI and TestPyPI set it themselves.
+# Credentials: UV_PUBLISH_TOKEN, or UV_PUBLISH_USERNAME and UV_PUBLISH_PASSWORD. When they are not set the script asks for a token.
+# TestPyPI and PyPI are separate sites: each needs its own account and token.
+set -euo pipefail
+
+cd "$(dirname "$0")/.."
+
+dry_run_flag=()
+public=false
+for argument in "$@"; do
+  if [[ "$argument" == "--dry-run" ]]; then
+    dry_run_flag=(--dry-run)
+  elif [[ "$argument" == "--public" ]]; then
+    public=true
+  fi
+done
+
+if [[ "$public" == true ]]; then
+  default_publish_url="https://upload.pypi.org/legacy/"
+  default_check_url="https://pypi.org/simple/"
+else
+  default_publish_url="https://test.pypi.org/legacy/"
+  default_check_url="https://test.pypi.org/simple/"
+fi
+if [[ -z "${SDK_PUBLISH_URL:-}" ]]; then
+  SDK_PUBLISH_URL="$default_publish_url"
+  SDK_CHECK_URL="${SDK_CHECK_URL:-$default_check_url}"
+fi
+
+check_url_flag=()
+if [[ -n "${SDK_CHECK_URL:-}" ]]; then
+  check_url_flag=(--check-url "$SDK_CHECK_URL")
+fi
+
+if [[ -z "${UV_PUBLISH_TOKEN:-}" && -z "${UV_PUBLISH_PASSWORD:-}" ]]; then
+  if [[ ! -t 0 ]]; then
+    echo "No credentials for the index, and there is no terminal to ask for them. Set UV_PUBLISH_TOKEN." >&2
+    exit 1
+  fi
+  read -r -s -p "Token for ${SDK_PUBLISH_URL}: " UV_PUBLISH_TOKEN
+  echo
+  if [[ -z "$UV_PUBLISH_TOKEN" ]]; then
+    echo "No token entered." >&2
+    exit 1
+  fi
+  export UV_PUBLISH_TOKEN
+fi
+
+echo "Publishing to $SDK_PUBLISH_URL"
+
+uv run pytest -q
+rm -rf dist
+uv build --out-dir dist
+
+uv publish --publish-url "$SDK_PUBLISH_URL" ${check_url_flag[@]+"${check_url_flag[@]}"} ${dry_run_flag[@]+"${dry_run_flag[@]}"} dist/*

gentic_sdk-0.1.0/src/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-0.1.0/src/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-0.1.0/src/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