matrx-api 0.1.0__tar.gz → 0.1.2__tar.gz

{matrx_api-0.1.0 → matrx_api-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: matrx-api
-Version: 0.1.0
+Version: 0.1.2
 Summary: Python client for every AI Matrx server, generated from the language-neutral server contract (sister of @ai-matrx/api)
 Author-email: Matrx <admin@aimatrx.com>
 License: MIT
@@ -9,8 +9,9 @@ Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.13
-Requires-Python: >=3.13
+Requires-Python: >=3.11
 Requires-Dist: httpx>=0.27
 Description-Content-Type: text/markdown
 
@@ -40,6 +41,11 @@ before the wire; exempt never sends one); unique `X-Request-Id`; GET/HEAD retry
 failure, writes never; one `MatrxApiError(status, code, message)`; NDJSON/SSE/bytes streams as async
 iterators (`*_or_json` operations return `JsonOrStream`).
 
+Per-schema types: every generated domain module exports the contract's request/response schemas as
+`TypedDict`s (`files.TYPES`) and annotates `body=` / the return with them. `route_prefix=` (a string for
+every deployment, or `{deployment: prefix}`) is prepended to every path for callers that mount under a prefix.
+Installs on Python >=3.11.
+
 ## Regenerate
 
 ```

{matrx_api-0.1.0 → matrx_api-0.1.2}/README.md

@@ -24,6 +24,11 @@ before the wire; exempt never sends one); unique `X-Request-Id`; GET/HEAD retry
 failure, writes never; one `MatrxApiError(status, code, message)`; NDJSON/SSE/bytes streams as async
 iterators (`*_or_json` operations return `JsonOrStream`).
 
+Per-schema types: every generated domain module exports the contract's request/response schemas as
+`TypedDict`s (`files.TYPES`) and annotates `body=` / the return with them. `route_prefix=` (a string for
+every deployment, or `{deployment: prefix}`) is prepended to every path for callers that mount under a prefix.
+Installs on Python >=3.11.
+
 ## Regenerate
 
 ```

{matrx_api-0.1.0 → matrx_api-0.1.2}/matrx_api/client.py

@@ -182,6 +182,7 @@ class MatrxApi:
         environment: Environment = "production",
         base_urls: Mapping[str, str] | None = None,
         resolve_base_url: Callable[[str, OperationDescriptor], str | None] | None = None,
+        route_prefix: str | Mapping[str, str] | None = None,
         http_client: httpx.AsyncClient | None = None,
         transport: httpx.AsyncBaseTransport | None = None,
         connect_timeout: float = DEFAULT_CONNECT_TIMEOUT,
@@ -198,6 +199,7 @@ class MatrxApi:
         self._environment = environment
         self._base_urls = dict(base_urls or {})
         self._resolve_base_url = resolve_base_url
+        self._route_prefix = route_prefix
         self._owns_client = http_client is None
         self._client = http_client or httpx.AsyncClient(transport=transport, follow_redirects=False)
         self._connect_timeout = connect_timeout
@@ -239,8 +241,15 @@ class MatrxApi:
             )
         return fallback
 
+    def prefix(self, op: OperationDescriptor) -> str:
+        """The path prefix for ``op``'s deployment: one string for every deployment, or a per-deployment map."""
+        rp = self._route_prefix
+        raw = rp.get(op.deployment) if isinstance(rp, Mapping) else rp
+        raw = (raw or "").strip().strip("/")
+        return f"/{raw}" if raw else ""
+
     def url(self, op: OperationDescriptor, *, path: Mapping[str, Any] | None = None) -> str:
-        return f"{self.base_url(op)}{_interpolate(op.path, path)}"
+        return f"{self.base_url(op)}{self.prefix(op)}{_interpolate(op.path, path)}"
 
     def _organization_for(self, op: OperationDescriptor, options: CallOptions | None) -> str | None:
         if op.org == "exempt":
@@ -329,7 +338,9 @@ class MatrxApi:
         except ValueError:
             detail = text or None
         await response.aclose()
-        return MatrxApiError(status=response.status_code, path=_interpolate(op.path, path), server_detail=detail)
+        return MatrxApiError(
+            status=response.status_code, path=_interpolate(op.path, path), server_detail=detail, response=response
+        )
 
     async def send(
         self,

{matrx_api-0.1.0 → matrx_api-0.1.2}/matrx_api/deployments.py

@@ -1,6 +1,6 @@
 """GENERATED by matrx-api scripts/generate.py from aidream/api-contract - never edit by hand."""
 
-CONTRACT_SHA256 = '7a09c07daad8cd41c7ae301d9ce90aace006a8f2d3a21dde98885807e5881da5'
+CONTRACT_SHA256 = '605c060bacf38697b876c603bf0260b9b2941fe22b1da1722810724c3d0c39be'
 
 # Which deployment answers (api-deployments.json): default base URLs and the env names that override them.
 DEPLOYMENTS: dict[str, dict] = {

{matrx_api-0.1.0 → matrx_api-0.1.2}/matrx_api/errors.py

@@ -70,7 +70,9 @@ class MatrxApiError(Exception):
         server_detail: Any = None,
         message: str | None = None,
         code: str | None = None,
+        response: Any = None,
     ) -> None:
+        self.response = response  # the (already read) httpx.Response of an HTTP failure; None for a transport failure
         self.status = status
         self.path = path
         self.server_detail = server_detail