pysequence-client 0.1.0__tar.gz

pysequence_client-0.1.0/PKG-INFO

@@ -0,0 +1,16 @@
+Metadata-Version: 2.4
+Name: pysequence-client
+Version: 0.1.0
+Summary: Unofficial Python client for the GetSequence API server
+License: MIT
+Author: Christian De Leon
+Author-email: christian@deleon.me
+Requires-Python: >=3.11
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: httpx (>=0.28.1,<0.29.0)
+Requires-Dist: pydantic (>=2.12.5,<3.0.0)

pysequence_client-0.1.0/pyproject.toml

@@ -0,0 +1,20 @@
+[project]
+name = "pysequence-client"
+version = "0.1.0"
+description = "Unofficial Python client for the GetSequence API server"
+authors = [
+    {name = "Christian De Leon", email = "christian@deleon.me"}
+]
+license = {text = "MIT"}
+requires-python = ">=3.11"
+dependencies = [
+    "httpx (>=0.28.1,<0.29.0)",
+    "pydantic (>=2.12.5,<3.0.0)",
+]
+
+[tool.poetry]
+packages = [{include = "pysequence_client", from = "src"}]
+
+[build-system]
+requires = ["poetry-core>=2.0.0,<3.0.0"]
+build-backend = "poetry.core.masonry.api"

pysequence_client-0.1.0/src/pysequence_client/__init__.py

@@ -0,0 +1,2 @@
+from pysequence_client.client import SequenceApiClient
+from pysequence_client.exceptions import ApiError

pysequence_client-0.1.0/src/pysequence_client/client.py

@@ -0,0 +1,113 @@
+"""HTTP client for the GetSequence API server."""
+
+import logging
+from typing import Any
+
+import httpx
+from pysequence_client.exceptions import ApiError
+
+
+log = logging.getLogger(__name__)
+
+
+class SequenceApiClient:
+    """Client for the GetSequence REST API server."""
+
+    def __init__(self, base_url: str, api_key: str, timeout: float = 30.0) -> None:
+        self._client = httpx.Client(
+            base_url=base_url,
+            headers={"X-API-Key": api_key},
+            timeout=timeout,
+        )
+
+    def _request(self, method: str, path: str, **kwargs: Any) -> Any:
+        resp = self._client.request(method, path, **kwargs)
+
+        if resp.status_code >= 400:
+            content_type = resp.headers.get("content-type", "")
+
+            if content_type.startswith("application/json"):
+                detail = resp.json().get("detail", resp.text)
+            else:
+                detail = resp.text
+
+            raise ApiError(resp.status_code, detail)
+        
+        return resp.json()
+
+    # -- Pod operations --
+
+    def get_pods(self) -> list[dict[str, Any]]:
+        return self._request("GET", "/api/pods")
+
+    def get_total_balance(self) -> dict[str, Any]:
+        return self._request("GET", "/api/pods/balance")
+
+    def get_pod_balance(self, pod_name: str) -> dict[str, Any] | None:
+        try:
+            return self._request("GET", f"/api/pods/{pod_name}/balance")
+        
+        except ApiError as e:
+            if e.status_code == 404:
+                return None
+            
+            raise
+
+    def get_pod_detail(self, pod_id: str) -> dict[str, Any]:
+        return self._request("GET", f"/api/pods/detail/{pod_id}")
+
+    # -- Account operations --
+
+    def get_all_accounts(self) -> dict[str, Any]:
+        return self._request("GET", "/api/accounts")
+
+    # -- Activity operations --
+
+    def get_activity_summary(self) -> dict[str, Any]:
+        return self._request("GET", "/api/activity/summary")
+
+    def get_activity(
+        self,
+        first: int = 10,
+        statuses: list[str] | None = None,
+        directions: list[str] | None = None,
+        activity_types: list[str] | None = None,
+    ) -> dict[str, Any]:
+        params: dict[str, Any] = {"first": first}
+
+        if statuses:
+            params["statuses"] = ",".join(statuses)
+
+        if directions:
+            params["directions"] = ",".join(directions)
+
+        if activity_types:
+            params["activity_types"] = ",".join(activity_types)
+            
+        return self._request("GET", "/api/activity", params=params)
+
+    def get_transfer_detail(self, transfer_id: str) -> dict[str, Any]:
+        return self._request("GET", f"/api/transfers/{transfer_id}")
+
+    # -- Transfer operations --
+
+    def transfer(
+        self,
+        source_id: str,
+        destination_id: str,
+        amount_cents: int,
+        description: str = "",
+    ) -> dict[str, Any]:
+        return self._request(
+            "POST",
+            "/api/transfers",
+            json={
+                "source_id": source_id,
+                "destination_id": destination_id,
+                "amount_cents": amount_cents,
+                "description": description,
+            },
+        )
+
+    def close(self) -> None:
+        self._client.close()

pysequence_client-0.1.0/src/pysequence_client/exceptions.py

@@ -0,0 +1,8 @@
+
+class ApiError(Exception):
+    """HTTP error from the GetSequence API server."""
+
+    def __init__(self, status_code: int, detail: str):
+        self.status_code = status_code
+        self.detail = detail
+        super().__init__(f"API error {status_code}: {detail}")

pysequence_client-0.1.0/src/pysequence_client/models.py

@@ -0,0 +1,70 @@
+from pydantic import BaseModel
+
+
+class Pod(BaseModel):
+    id: str
+    name: str
+    organization_id: str
+    balance_cents: int
+    balance: str
+
+
+class Port(BaseModel):
+    id: str
+    name: str
+    organization_id: str
+    balance_cents: int
+    balance: str
+
+
+class ExternalAccount(BaseModel):
+    id: str
+    name: str
+    organization_id: str
+    balance_cents: int
+    balance: str
+
+
+class TotalBalance(BaseModel):
+    total_balance_cents: int
+    total_balance: str
+    pod_count: int
+
+
+class TransferParty(BaseModel):
+    name: str
+
+
+class Transfer(BaseModel):
+    id: str
+    status: str
+    amount: str
+    amount_cents: int
+    source: TransferParty
+    destination: TransferParty
+    direction: str
+    activity_type: str
+    created_at: str | None = None
+
+
+class PageInfo(BaseModel):
+    end_cursor: str
+    has_next_page: bool
+
+
+class ActivityPage(BaseModel):
+    transfers: list[Transfer]
+    page_info: PageInfo
+
+
+class ActivitySummary(BaseModel):
+    transfer_count: int
+    rule_executions: int
+    total_incoming_cents: int
+    total_incoming: str
+
+
+class AllAccounts(BaseModel):
+    pods: list[Pod]
+    ports: list[Port]
+    accounts: list[ExternalAccount]