archil-openapi 0.0.1__tar.gz

archil_openapi-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Archil, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

archil_openapi-0.0.1/PKG-INFO

@@ -0,0 +1,80 @@
+Metadata-Version: 2.3
+Name: archil-openapi
+Version: 0.0.1
+Summary: Generated low-level Python client for the Archil control plane API
+Keywords: archil,openapi
+Author: Archil, Inc.
+Author-email: Archil, Inc. <support@archil.com>
+License: MIT License
+         
+         Copyright (c) 2026 Archil, Inc.
+         
+         Permission is hereby granted, free of charge, to any person obtaining a copy
+         of this software and associated documentation files (the "Software"), to deal
+         in the Software without restriction, including without limitation the rights
+         to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+         copies of the Software, and to permit persons to whom the Software is
+         furnished to do so, subject to the following conditions:
+         
+         The above copyright notice and this permission notice shall be included in all
+         copies or substantial portions of the Software.
+         
+         THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+         IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+         FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+         AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+         LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+         SOFTWARE.
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Typing :: Typed
+Requires-Dist: attrs>=22.2.0
+Requires-Dist: httpx>=0.23.0,<0.29.0
+Requires-Dist: python-dateutil>=2.8.0,<3
+Requires-Dist: pytest>=8 ; extra == 'dev'
+Requires-Dist: ruff>=0.14 ; extra == 'dev'
+Requires-Python: >=3.10
+Project-URL: Documentation, https://docs.archil.com
+Project-URL: Homepage, https://archil.com
+Provides-Extra: dev
+Description-Content-Type: text/markdown
+
+# archil-openapi
+
+Generated low-level Python client for the Archil control plane API.
+
+```sh
+pip install archil-openapi
+```
+
+```python
+from archil_openapi import AuthenticatedClient
+from archil_openapi.api.disks import get_disk
+
+client = AuthenticatedClient(
+    base_url="https://api.archil.com",
+    token="key-...",
+)
+
+disk = get_disk.sync(id="dsk-...", client=client)
+
+async def fetch_disk():
+    return await get_disk.asyncio(id="dsk-...", client=client)
+```
+
+The package is generated from `api/controlplane/openapi.yaml` in this repository.
+Use the high-level [`archil`](https://pypi.org/project/archil/) package for the
+recommended disk, object, workspace, and agent-tool APIs.
+
+## Publishing
+
+Changes to the canonical OpenAPI schema generate and test this package on every
+pull request. After merge, `openapi-release.yml` compares the generated
+client with the latest PyPI wheel and publishes the next patch version only
+when the generated client changed.
+
+PyPI trusted publishing for `archil-openapi` must use repository
+`archil-data/archil`, workflow `openapi-release.yml`, and environment
+`pypi`.

archil_openapi-0.0.1/README.md

@@ -0,0 +1,37 @@
+# archil-openapi
+
+Generated low-level Python client for the Archil control plane API.
+
+```sh
+pip install archil-openapi
+```
+
+```python
+from archil_openapi import AuthenticatedClient
+from archil_openapi.api.disks import get_disk
+
+client = AuthenticatedClient(
+    base_url="https://api.archil.com",
+    token="key-...",
+)
+
+disk = get_disk.sync(id="dsk-...", client=client)
+
+async def fetch_disk():
+    return await get_disk.asyncio(id="dsk-...", client=client)
+```
+
+The package is generated from `api/controlplane/openapi.yaml` in this repository.
+Use the high-level [`archil`](https://pypi.org/project/archil/) package for the
+recommended disk, object, workspace, and agent-tool APIs.
+
+## Publishing
+
+Changes to the canonical OpenAPI schema generate and test this package on every
+pull request. After merge, `openapi-release.yml` compares the generated
+client with the latest PyPI wheel and publishes the next patch version only
+when the generated client changed.
+
+PyPI trusted publishing for `archil-openapi` must use repository
+`archil-data/archil`, workflow `openapi-release.yml`, and environment
+`pypi`.

archil_openapi-0.0.1/pyproject.toml

@@ -0,0 +1,47 @@
+[project]
+name = "archil-openapi"
+version = "0.0.1"
+description = "Generated low-level Python client for the Archil control plane API"
+readme = "README.md"
+license = { file = "LICENSE" }
+requires-python = ">=3.10"
+keywords = ["archil", "openapi"]
+authors = [{ name = "Archil, Inc.", email = "support@archil.com" }]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Typing :: Typed",
+]
+dependencies = [
+    "attrs>=22.2.0",
+    "httpx>=0.23.0,<0.29.0",
+    "python-dateutil>=2.8.0,<3",
+]
+
+[project.urls]
+Homepage = "https://archil.com"
+Documentation = "https://docs.archil.com"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8",
+    "ruff>=0.14",
+]
+
+[tool.uv.build-backend]
+module-name = "archil_openapi"
+module-root = "src"
+
+[build-system]
+requires = ["uv_build>=0.8.0,<0.9.0"]
+build-backend = "uv_build"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 120
+
+[tool.ruff.lint]
+select = ["E4", "E7", "E9", "F"]

archil_openapi-0.0.1/src/archil_openapi/__init__.py

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

archil_openapi-0.0.1/src/archil_openapi/api/__init__.py

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

archil_openapi-0.0.1/src/archil_openapi/api/activity/__init__.py

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

archil_openapi-0.0.1/src/archil_openapi/api/activity/list_activity.py

@@ -0,0 +1,268 @@
+from http import HTTPStatus
+from typing import Any, Optional, Union
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.api_response_activity_list import ApiResponseActivityList
+from ...models.error_response import ErrorResponse
+from ...models.list_activity_level_item import ListActivityLevelItem
+from ...types import UNSET, Response, Unset
+
+
+def _get_kwargs(
+    *,
+    limit: Union[Unset, int] = UNSET,
+    cursor: Union[Unset, str] = UNSET,
+    disk_id: Union[Unset, str] = UNSET,
+    event_type: Union[Unset, list[str]] = UNSET,
+    level: Union[Unset, list[ListActivityLevelItem]] = UNSET,
+) -> dict[str, Any]:
+    params: dict[str, Any] = {}
+
+    params["limit"] = limit
+
+    params["cursor"] = cursor
+
+    params["diskId"] = disk_id
+
+    json_event_type: Union[Unset, list[str]] = UNSET
+    if not isinstance(event_type, Unset):
+        json_event_type = event_type
+
+    params["eventType"] = json_event_type
+
+    json_level: Union[Unset, list[str]] = UNSET
+    if not isinstance(level, Unset):
+        json_level = []
+        for level_item_data in level:
+            level_item = level_item_data.value
+            json_level.append(level_item)
+
+    params["level"] = json_level
+
+    params = {k: v for k, v in params.items() if v is not UNSET and v is not None}
+
+    _kwargs: dict[str, Any] = {
+        "method": "get",
+        "url": "/api/activity",
+        "params": params,
+    }
+
+    return _kwargs
+
+
+def _parse_response(
+    *, client: Union[AuthenticatedClient, Client], response: httpx.Response
+) -> Optional[Union[ApiResponseActivityList, ErrorResponse]]:
+    if response.status_code == 200:
+        response_200 = ApiResponseActivityList.from_dict(response.json())
+
+        return response_200
+
+    if response.status_code == 400:
+        response_400 = ErrorResponse.from_dict(response.json())
+
+        return response_400
+
+    if response.status_code == 401:
+        response_401 = ErrorResponse.from_dict(response.json())
+
+        return response_401
+
+    if response.status_code == 404:
+        response_404 = ErrorResponse.from_dict(response.json())
+
+        return response_404
+
+    if response.status_code == 500:
+        response_500 = ErrorResponse.from_dict(response.json())
+
+        return response_500
+
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(
+    *, client: Union[AuthenticatedClient, Client], response: httpx.Response
+) -> Response[Union[ApiResponseActivityList, ErrorResponse]]:
+    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: Union[AuthenticatedClient, Client],
+    limit: Union[Unset, int] = UNSET,
+    cursor: Union[Unset, str] = UNSET,
+    disk_id: Union[Unset, str] = UNSET,
+    event_type: Union[Unset, list[str]] = UNSET,
+    level: Union[Unset, list[ListActivityLevelItem]] = UNSET,
+) -> Response[Union[ApiResponseActivityList, ErrorResponse]]:
+    """List activity events
+
+     Returns the authenticated account's activity events (disk lifecycle and exec events), newest first.
+    Omitting `limit` returns up to 50 events; pass the response's `nextCursor` back as `cursor` to fetch
+    the next page.
+
+    Args:
+        limit (Union[Unset, int]):
+        cursor (Union[Unset, str]):
+        disk_id (Union[Unset, str]):  Example: dsk-0123456789abcdef.
+        event_type (Union[Unset, list[str]]):
+        level (Union[Unset, list[ListActivityLevelItem]]):
+
+    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[Union[ApiResponseActivityList, ErrorResponse]]
+    """
+
+    kwargs = _get_kwargs(
+        limit=limit,
+        cursor=cursor,
+        disk_id=disk_id,
+        event_type=event_type,
+        level=level,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    *,
+    client: Union[AuthenticatedClient, Client],
+    limit: Union[Unset, int] = UNSET,
+    cursor: Union[Unset, str] = UNSET,
+    disk_id: Union[Unset, str] = UNSET,
+    event_type: Union[Unset, list[str]] = UNSET,
+    level: Union[Unset, list[ListActivityLevelItem]] = UNSET,
+) -> Optional[Union[ApiResponseActivityList, ErrorResponse]]:
+    """List activity events
+
+     Returns the authenticated account's activity events (disk lifecycle and exec events), newest first.
+    Omitting `limit` returns up to 50 events; pass the response's `nextCursor` back as `cursor` to fetch
+    the next page.
+
+    Args:
+        limit (Union[Unset, int]):
+        cursor (Union[Unset, str]):
+        disk_id (Union[Unset, str]):  Example: dsk-0123456789abcdef.
+        event_type (Union[Unset, list[str]]):
+        level (Union[Unset, list[ListActivityLevelItem]]):
+
+    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:
+        Union[ApiResponseActivityList, ErrorResponse]
+    """
+
+    return sync_detailed(
+        client=client,
+        limit=limit,
+        cursor=cursor,
+        disk_id=disk_id,
+        event_type=event_type,
+        level=level,
+    ).parsed
+
+
+async def asyncio_detailed(
+    *,
+    client: Union[AuthenticatedClient, Client],
+    limit: Union[Unset, int] = UNSET,
+    cursor: Union[Unset, str] = UNSET,
+    disk_id: Union[Unset, str] = UNSET,
+    event_type: Union[Unset, list[str]] = UNSET,
+    level: Union[Unset, list[ListActivityLevelItem]] = UNSET,
+) -> Response[Union[ApiResponseActivityList, ErrorResponse]]:
+    """List activity events
+
+     Returns the authenticated account's activity events (disk lifecycle and exec events), newest first.
+    Omitting `limit` returns up to 50 events; pass the response's `nextCursor` back as `cursor` to fetch
+    the next page.
+
+    Args:
+        limit (Union[Unset, int]):
+        cursor (Union[Unset, str]):
+        disk_id (Union[Unset, str]):  Example: dsk-0123456789abcdef.
+        event_type (Union[Unset, list[str]]):
+        level (Union[Unset, list[ListActivityLevelItem]]):
+
+    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[Union[ApiResponseActivityList, ErrorResponse]]
+    """
+
+    kwargs = _get_kwargs(
+        limit=limit,
+        cursor=cursor,
+        disk_id=disk_id,
+        event_type=event_type,
+        level=level,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    *,
+    client: Union[AuthenticatedClient, Client],
+    limit: Union[Unset, int] = UNSET,
+    cursor: Union[Unset, str] = UNSET,
+    disk_id: Union[Unset, str] = UNSET,
+    event_type: Union[Unset, list[str]] = UNSET,
+    level: Union[Unset, list[ListActivityLevelItem]] = UNSET,
+) -> Optional[Union[ApiResponseActivityList, ErrorResponse]]:
+    """List activity events
+
+     Returns the authenticated account's activity events (disk lifecycle and exec events), newest first.
+    Omitting `limit` returns up to 50 events; pass the response's `nextCursor` back as `cursor` to fetch
+    the next page.
+
+    Args:
+        limit (Union[Unset, int]):
+        cursor (Union[Unset, str]):
+        disk_id (Union[Unset, str]):  Example: dsk-0123456789abcdef.
+        event_type (Union[Unset, list[str]]):
+        level (Union[Unset, list[ListActivityLevelItem]]):
+
+    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:
+        Union[ApiResponseActivityList, ErrorResponse]
+    """
+
+    return (
+        await asyncio_detailed(
+            client=client,
+            limit=limit,
+            cursor=cursor,
+            disk_id=disk_id,
+            event_type=event_type,
+            level=level,
+        )
+    ).parsed

archil_openapi-0.0.1/src/archil_openapi/api/api_tokens/__init__.py

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

archil_openapi-0.0.1/src/archil_openapi/api/api_tokens/create_api_token.py

@@ -0,0 +1,188 @@
+from http import HTTPStatus
+from typing import Any, Optional, Union
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.api_response_token_created import ApiResponseTokenCreated
+from ...models.create_api_token_request import CreateApiTokenRequest
+from ...models.error_response import ErrorResponse
+from ...types import Response
+
+
+def _get_kwargs(
+    *,
+    body: CreateApiTokenRequest,
+) -> dict[str, Any]:
+    headers: dict[str, Any] = {}
+
+    _kwargs: dict[str, Any] = {
+        "method": "post",
+        "url": "/api/tokens",
+    }
+
+    _kwargs["json"] = body.to_dict()
+
+    headers["Content-Type"] = "application/json"
+
+    _kwargs["headers"] = headers
+    return _kwargs
+
+
+def _parse_response(
+    *, client: Union[AuthenticatedClient, Client], response: httpx.Response
+) -> Optional[Union[ApiResponseTokenCreated, ErrorResponse]]:
+    if response.status_code == 201:
+        response_201 = ApiResponseTokenCreated.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 == 401:
+        response_401 = ErrorResponse.from_dict(response.json())
+
+        return response_401
+
+    if response.status_code == 500:
+        response_500 = ErrorResponse.from_dict(response.json())
+
+        return response_500
+
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(
+    *, client: Union[AuthenticatedClient, Client], response: httpx.Response
+) -> Response[Union[ApiResponseTokenCreated, ErrorResponse]]:
+    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,
+    body: CreateApiTokenRequest,
+) -> Response[Union[ApiResponseTokenCreated, ErrorResponse]]:
+    """Create API token
+
+     Creates a new API token for programmatic access. The full token value
+    is only returned once at creation time.
+
+    Args:
+        body (CreateApiTokenRequest):
+
+    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[Union[ApiResponseTokenCreated, ErrorResponse]]
+    """
+
+    kwargs = _get_kwargs(
+        body=body,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    *,
+    client: AuthenticatedClient,
+    body: CreateApiTokenRequest,
+) -> Optional[Union[ApiResponseTokenCreated, ErrorResponse]]:
+    """Create API token
+
+     Creates a new API token for programmatic access. The full token value
+    is only returned once at creation time.
+
+    Args:
+        body (CreateApiTokenRequest):
+
+    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:
+        Union[ApiResponseTokenCreated, ErrorResponse]
+    """
+
+    return sync_detailed(
+        client=client,
+        body=body,
+    ).parsed
+
+
+async def asyncio_detailed(
+    *,
+    client: AuthenticatedClient,
+    body: CreateApiTokenRequest,
+) -> Response[Union[ApiResponseTokenCreated, ErrorResponse]]:
+    """Create API token
+
+     Creates a new API token for programmatic access. The full token value
+    is only returned once at creation time.
+
+    Args:
+        body (CreateApiTokenRequest):
+
+    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[Union[ApiResponseTokenCreated, ErrorResponse]]
+    """
+
+    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,
+    body: CreateApiTokenRequest,
+) -> Optional[Union[ApiResponseTokenCreated, ErrorResponse]]:
+    """Create API token
+
+     Creates a new API token for programmatic access. The full token value
+    is only returned once at creation time.
+
+    Args:
+        body (CreateApiTokenRequest):
+
+    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:
+        Union[ApiResponseTokenCreated, ErrorResponse]
+    """
+
+    return (
+        await asyncio_detailed(
+            client=client,
+            body=body,
+        )
+    ).parsed