qdash-client 0.1.0__py3-none-any.whl

qdash/client/__init__.py

@@ -0,0 +1,46 @@
+"""QDash exporter client package."""
+
+from qdash.client.services.client import QDashClient
+from qdash.client.services.config import (
+    QDashConfig,
+    QDashRetryConfig,
+)
+from qdash.client.services.errors import (
+    QDashApiError,
+    QDashAuthError,
+    QDashClientError,
+    QDashConfigError,
+    QDashNotFoundError,
+    QDashTransportError,
+    QDashValidationError,
+)
+from qdash.client.services.exporter_models import NormalizedMetricRecord
+from qdash.client.services.models import (
+    ChipMetricsResponse,
+    ChipResponse,
+    ListChipsResponse,
+    ParameterModel,
+    TimeSeriesData,
+)
+
+from . import rest
+
+__all__ = [
+    "ChipMetricsResponse",
+    "ChipResponse",
+    "ListChipsResponse",
+    "NormalizedMetricRecord",
+    "ParameterModel",
+    "QDashApiError",
+    "QDashAuthError",
+    "QDashClient",
+    "QDashClientError",
+    "QDashConfig",
+    "QDashConfigError",
+    "QDashNotFoundError",
+    "QDashRetryConfig",
+    "QDashTransportError",
+    "QDashValidationError",
+    "TimeSeriesData",
+    "rest",
+]

qdash/client/rest/__init__.py

@@ -0,0 +1,8 @@
+"""Low-level REST transport layer for qdash client."""
+
+from qdash.client.rest.api_client import ApiClient
+from qdash.client.rest.api_response import ApiResponse
+from qdash.client.rest.configuration import Configuration
+from qdash.client.rest.exceptions import ApiException
+
+__all__ = ["ApiClient", "ApiException", "ApiResponse", "Configuration"]

qdash/client/rest/api_client.py

@@ -0,0 +1,66 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any
+
+import httpx
+
+from qdash.client.rest.api_response import ApiResponse
+from qdash.client.rest.exceptions import ApiException
+
+if TYPE_CHECKING:
+    from qdash.client.rest.configuration import Configuration
+
+
+class ApiClient:
+    """Small synchronous REST client used by service layer."""
+
+    def __init__(
+        self,
+        configuration: Configuration,
+        http_client: httpx.Client | None = None,
+    ) -> None:
+        self.configuration = configuration
+        self._client = http_client or httpx.Client(
+            base_url=configuration.host,
+            timeout=configuration.timeout,
+            verify=configuration.verify_tls,
+            proxy=configuration.proxy,
+        )
+
+    def request(
+        self,
+        method: str,
+        path: str,
+        *,
+        headers: dict[str, str] | None = None,
+        params: dict[str, Any] | None = None,
+        json: dict[str, Any] | None = None,
+        raise_on_status: bool = False,
+    ) -> ApiResponse[Any]:
+        try:
+            response = self._client.request(
+                method,
+                path,
+                headers=headers,
+                params=params,
+                json=json,
+            )
+        except httpx.HTTPError as exc:
+            raise ApiException(None, str(exc)) from exc
+
+        try:
+            payload = response.json()
+        except Exception:
+            payload = response.text
+
+        if raise_on_status and response.status_code >= 400:
+            raise ApiException(response.status_code, response.reason_phrase, payload)
+
+        return ApiResponse(
+            status_code=response.status_code,
+            data=payload,
+            headers=dict(response.headers),
+        )
+
+    def close(self) -> None:
+        self._client.close()

qdash/client/rest/api_response.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Generic, TypeVar
+
+_T = TypeVar("_T")
+
+
+@dataclass(slots=True)
+class ApiResponse(Generic[_T]):
+    """Typed REST response container."""
+
+    status_code: int
+    data: _T
+    headers: dict[str, str]

qdash/client/rest/configuration.py

@@ -0,0 +1,13 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+
+@dataclass(slots=True)
+class Configuration:
+    """Basic REST client configuration."""
+
+    host: str
+    timeout: float = 30.0
+    verify_tls: bool = True
+    proxy: str | None = None

qdash/client/rest/exceptions.py

@@ -0,0 +1,11 @@
+from __future__ import annotations
+
+
+class ApiException(Exception):
+    """Exception raised by low-level REST transport."""
+
+    def __init__(self, status: int | None, reason: str, body: object | None = None) -> None:
+        self.status = status
+        self.reason = reason
+        self.body = body
+        super().__init__(f"HTTP {status}: {reason}" if status is not None else reason)

qdash/client/services/__init__.py

@@ -0,0 +1,43 @@
+"""Service layer for qdash client package."""
+
+from qdash.client.services.client import QDashClient
+from qdash.client.services.config import (
+    QDashConfig,
+    QDashRetryConfig,
+)
+from qdash.client.services.errors import (
+    QDashApiError,
+    QDashAuthError,
+    QDashClientError,
+    QDashConfigError,
+    QDashNotFoundError,
+    QDashTransportError,
+    QDashValidationError,
+)
+from qdash.client.services.exporter_models import NormalizedMetricRecord
+from qdash.client.services.models import (
+    ChipMetricsResponse,
+    ChipResponse,
+    ListChipsResponse,
+    ParameterModel,
+    TimeSeriesData,
+)
+
+__all__ = [
+    "ChipMetricsResponse",
+    "ChipResponse",
+    "ListChipsResponse",
+    "NormalizedMetricRecord",
+    "ParameterModel",
+    "QDashApiError",
+    "QDashAuthError",
+    "QDashClient",
+    "QDashClientError",
+    "QDashConfig",
+    "QDashConfigError",
+    "QDashNotFoundError",
+    "QDashRetryConfig",
+    "QDashTransportError",
+    "QDashValidationError",
+    "TimeSeriesData",
+]