fourtheorem-tempo-client 0.0.1__tar.gz

fourtheorem_tempo_client-0.0.1/PKG-INFO

@@ -0,0 +1,64 @@
+Metadata-Version: 2.3
+Name: fourtheorem-tempo-client
+Version: 0.0.1
+Summary: A client library for accessing Tempo API
+Author: fourTheorem
+Requires-Dist: httpx>=0.23.1,<0.29.0
+Requires-Dist: attrs>=22.2.0
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# fourtheorem-tempo-client
+
+Python client for the [Tempo](https://github.com/fourTheorem/tempo) public API, generated from its OpenAPI specification. Tempo is a high-throughput compute platform for massive-scale modelling workloads.
+
+> **Status: early development.** The API surface is small and evolving, and authentication is not implemented yet — use `Client`; the generated `AuthenticatedClient` is boilerplate for a Bearer scheme the API does not support yet. Expect breaking changes until 1.0.
+
+## Install
+
+```bash
+pip install fourtheorem-tempo-client
+# or
+uv add fourtheorem-tempo-client
+```
+
+Requires Python 3.11+. Fully typed (`py.typed`); httpx-based, with sync and async variants for every operation.
+
+## Quickstart
+
+```python
+from tempo_client import Client
+from tempo_client.api.public import get_workload_status, health_check, submit_workload
+from tempo_client.models import WorkloadSubmission
+
+client = Client(base_url="https://your-tempo-host/api")
+
+health_check.sync(client=client)
+
+submitted = submit_workload.sync(
+    client=client,
+    body=WorkloadSubmission.from_dict(
+        {
+            "name": "demo",
+            "jobs": [{"id": "j-1", "name": "Job 1", "work_type": "default", "predecessors": []}],
+        }
+    ),
+)
+
+status = get_workload_status.sync(client=client, workload_id=submitted.workload_id)
+print(status.state)
+```
+
+Every operation also has an async variant:
+
+```python
+status = await get_workload_status.asyncio(client=client, workload_id=submitted.workload_id)
+```
+
+## What's covered
+
+Workload submission (inline or via presigned uploads for large job graphs), workload lifecycle (status, cancel, delete, audit trail), job and attempt inspection, the resource-class catalog, and worker-artifact registry uploads — the full public API surface.
+
+## Documentation
+
+The API reference (Scalar, with try-it-out) and narrative guides are served by your Tempo deployment at `/docs/`. The client is regenerated from the spec on every API change; see the [repository](https://github.com/fourTheorem/tempo/tree/main/sdks) for how the SDKs are produced.

fourtheorem_tempo_client-0.0.1/README.md

@@ -0,0 +1,54 @@
+# fourtheorem-tempo-client
+
+Python client for the [Tempo](https://github.com/fourTheorem/tempo) public API, generated from its OpenAPI specification. Tempo is a high-throughput compute platform for massive-scale modelling workloads.
+
+> **Status: early development.** The API surface is small and evolving, and authentication is not implemented yet — use `Client`; the generated `AuthenticatedClient` is boilerplate for a Bearer scheme the API does not support yet. Expect breaking changes until 1.0.
+
+## Install
+
+```bash
+pip install fourtheorem-tempo-client
+# or
+uv add fourtheorem-tempo-client
+```
+
+Requires Python 3.11+. Fully typed (`py.typed`); httpx-based, with sync and async variants for every operation.
+
+## Quickstart
+
+```python
+from tempo_client import Client
+from tempo_client.api.public import get_workload_status, health_check, submit_workload
+from tempo_client.models import WorkloadSubmission
+
+client = Client(base_url="https://your-tempo-host/api")
+
+health_check.sync(client=client)
+
+submitted = submit_workload.sync(
+    client=client,
+    body=WorkloadSubmission.from_dict(
+        {
+            "name": "demo",
+            "jobs": [{"id": "j-1", "name": "Job 1", "work_type": "default", "predecessors": []}],
+        }
+    ),
+)
+
+status = get_workload_status.sync(client=client, workload_id=submitted.workload_id)
+print(status.state)
+```
+
+Every operation also has an async variant:
+
+```python
+status = await get_workload_status.asyncio(client=client, workload_id=submitted.workload_id)
+```
+
+## What's covered
+
+Workload submission (inline or via presigned uploads for large job graphs), workload lifecycle (status, cancel, delete, audit trail), job and attempt inspection, the resource-class catalog, and worker-artifact registry uploads — the full public API surface.
+
+## Documentation
+
+The API reference (Scalar, with try-it-out) and narrative guides are served by your Tempo deployment at `/docs/`. The client is regenerated from the spec on every API change; see the [repository](https://github.com/fourTheorem/tempo/tree/main/sdks) for how the SDKs are produced.

fourtheorem_tempo_client-0.0.1/pyproject.toml

@@ -0,0 +1,25 @@
+[project]
+name = "fourtheorem-tempo-client"
+version = "0.0.1"
+description = "A client library for accessing Tempo API"
+authors = [{ name = "fourTheorem" }]
+requires-python = ">=3.11"
+readme = "README.md"
+dependencies = [
+    "httpx>=0.23.1,<0.29.0",
+    "attrs>=22.2.0",
+]
+
+[tool.uv.build-backend]
+module-name = "tempo_client"
+module-root = ""
+
+[build-system]
+requires = ["uv_build>=0.11.0,<0.12.0"]
+build-backend = "uv_build"
+
+[tool.ruff]
+line-length = 120
+
+[tool.ruff.lint]
+select = ["F", "I", "UP"]

fourtheorem_tempo_client-0.0.1/tempo_client/__init__.py

@@ -0,0 +1,8 @@
+"""A client library for accessing Tempo API"""
+
+from .client import AuthenticatedClient, Client
+
+__all__ = (
+    "AuthenticatedClient",
+    "Client",
+)

fourtheorem_tempo_client-0.0.1/tempo_client/api/__init__.py

@@ -0,0 +1 @@
+"""Contains methods for accessing the API"""

fourtheorem_tempo_client-0.0.1/tempo_client/api/public/__init__.py

@@ -0,0 +1 @@
+"""Contains endpoint functions for accessing the API"""

fourtheorem_tempo_client-0.0.1/tempo_client/api/public/cancel_workload.py

@@ -0,0 +1,180 @@
+from http import HTTPStatus
+from typing import Any
+from urllib.parse import quote
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.cancel_workload_response_cancel_workload import CancelWorkloadResponseCancelWorkload
+from ...models.error_response import ErrorResponse
+from ...models.http_validation_error import HTTPValidationError
+from ...types import Response
+
+
+def _get_kwargs(
+    workload_id: str,
+) -> dict[str, Any]:
+
+    _kwargs: dict[str, Any] = {
+        "method": "post",
+        "url": "/workloads/{workload_id}/cancel".format(
+            workload_id=quote(str(workload_id), safe=""),
+        ),
+    }
+
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> CancelWorkloadResponseCancelWorkload | ErrorResponse | HTTPValidationError | None:
+    if response.status_code == 200:
+        response_200 = CancelWorkloadResponseCancelWorkload.from_dict(response.json())
+
+        return response_200
+
+    if response.status_code == 404:
+        response_404 = ErrorResponse.from_dict(response.json())
+
+        return response_404
+
+    if response.status_code == 409:
+        response_409 = ErrorResponse.from_dict(response.json())
+
+        return response_409
+
+    if response.status_code == 422:
+        response_422 = HTTPValidationError.from_dict(response.json())
+
+        return response_422
+
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Response[CancelWorkloadResponseCancelWorkload | ErrorResponse | HTTPValidationError]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    workload_id: str,
+    *,
+    client: AuthenticatedClient | Client,
+) -> Response[CancelWorkloadResponseCancelWorkload | ErrorResponse | HTTPValidationError]:
+    """Cancel Workload
+
+     Cancel a running workload.
+
+    Args:
+        workload_id (str):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[CancelWorkloadResponseCancelWorkload | ErrorResponse | HTTPValidationError]
+    """
+
+    kwargs = _get_kwargs(
+        workload_id=workload_id,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    workload_id: str,
+    *,
+    client: AuthenticatedClient | Client,
+) -> CancelWorkloadResponseCancelWorkload | ErrorResponse | HTTPValidationError | None:
+    """Cancel Workload
+
+     Cancel a running workload.
+
+    Args:
+        workload_id (str):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        CancelWorkloadResponseCancelWorkload | ErrorResponse | HTTPValidationError
+    """
+
+    return sync_detailed(
+        workload_id=workload_id,
+        client=client,
+    ).parsed
+
+
+async def asyncio_detailed(
+    workload_id: str,
+    *,
+    client: AuthenticatedClient | Client,
+) -> Response[CancelWorkloadResponseCancelWorkload | ErrorResponse | HTTPValidationError]:
+    """Cancel Workload
+
+     Cancel a running workload.
+
+    Args:
+        workload_id (str):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[CancelWorkloadResponseCancelWorkload | ErrorResponse | HTTPValidationError]
+    """
+
+    kwargs = _get_kwargs(
+        workload_id=workload_id,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    workload_id: str,
+    *,
+    client: AuthenticatedClient | Client,
+) -> CancelWorkloadResponseCancelWorkload | ErrorResponse | HTTPValidationError | None:
+    """Cancel Workload
+
+     Cancel a running workload.
+
+    Args:
+        workload_id (str):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        CancelWorkloadResponseCancelWorkload | ErrorResponse | HTTPValidationError
+    """
+
+    return (
+        await asyncio_detailed(
+            workload_id=workload_id,
+            client=client,
+        )
+    ).parsed

fourtheorem_tempo_client-0.0.1/tempo_client/api/public/create_registry_upload.py

@@ -0,0 +1,189 @@
+from http import HTTPStatus
+from typing import Any
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.error_response import ErrorResponse
+from ...models.http_validation_error import HTTPValidationError
+from ...models.registry_upload_request import RegistryUploadRequest
+from ...models.registry_upload_response import RegistryUploadResponse
+from ...types import Response
+
+
+def _get_kwargs(
+    *,
+    body: RegistryUploadRequest,
+) -> dict[str, Any]:
+    headers: dict[str, Any] = {}
+
+    _kwargs: dict[str, Any] = {
+        "method": "post",
+        "url": "/registry/uploads",
+    }
+
+    _kwargs["json"] = body.to_dict()
+
+    headers["Content-Type"] = "application/json"
+
+    _kwargs["headers"] = headers
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> ErrorResponse | HTTPValidationError | RegistryUploadResponse | None:
+    if response.status_code == 201:
+        response_201 = RegistryUploadResponse.from_dict(response.json())
+
+        return response_201
+
+    if response.status_code == 400:
+        response_400 = ErrorResponse.from_dict(response.json())
+
+        return response_400
+
+    if response.status_code == 422:
+        response_422 = HTTPValidationError.from_dict(response.json())
+
+        return response_422
+
+    if response.status_code == 503:
+        response_503 = ErrorResponse.from_dict(response.json())
+
+        return response_503
+
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Response[ErrorResponse | HTTPValidationError | RegistryUploadResponse]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    *,
+    client: AuthenticatedClient | Client,
+    body: RegistryUploadRequest,
+) -> Response[ErrorResponse | HTTPValidationError | RegistryUploadResponse]:
+    """Create Registry Upload
+
+     Create a presigned upload URL for a dynamic worker ZIP artifact.
+
+    Args:
+        body (RegistryUploadRequest): Request body for creating a presigned code registry ZIP
+            upload.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[ErrorResponse | HTTPValidationError | RegistryUploadResponse]
+    """
+
+    kwargs = _get_kwargs(
+        body=body,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    *,
+    client: AuthenticatedClient | Client,
+    body: RegistryUploadRequest,
+) -> ErrorResponse | HTTPValidationError | RegistryUploadResponse | None:
+    """Create Registry Upload
+
+     Create a presigned upload URL for a dynamic worker ZIP artifact.
+
+    Args:
+        body (RegistryUploadRequest): Request body for creating a presigned code registry ZIP
+            upload.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        ErrorResponse | HTTPValidationError | RegistryUploadResponse
+    """
+
+    return sync_detailed(
+        client=client,
+        body=body,
+    ).parsed
+
+
+async def asyncio_detailed(
+    *,
+    client: AuthenticatedClient | Client,
+    body: RegistryUploadRequest,
+) -> Response[ErrorResponse | HTTPValidationError | RegistryUploadResponse]:
+    """Create Registry Upload
+
+     Create a presigned upload URL for a dynamic worker ZIP artifact.
+
+    Args:
+        body (RegistryUploadRequest): Request body for creating a presigned code registry ZIP
+            upload.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[ErrorResponse | HTTPValidationError | RegistryUploadResponse]
+    """
+
+    kwargs = _get_kwargs(
+        body=body,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    *,
+    client: AuthenticatedClient | Client,
+    body: RegistryUploadRequest,
+) -> ErrorResponse | HTTPValidationError | RegistryUploadResponse | None:
+    """Create Registry Upload
+
+     Create a presigned upload URL for a dynamic worker ZIP artifact.
+
+    Args:
+        body (RegistryUploadRequest): Request body for creating a presigned code registry ZIP
+            upload.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        ErrorResponse | HTTPValidationError | RegistryUploadResponse
+    """
+
+    return (
+        await asyncio_detailed(
+            client=client,
+            body=body,
+        )
+    ).parsed