automated-actions-client 0.1.0__tar.gz

automated_actions_client-0.1.0/PKG-INFO

@@ -0,0 +1,122 @@
+Metadata-Version: 2.4
+Name: automated-actions-client
+Version: 0.1.0
+Summary: Automated Actions Client
+Project-URL: homepage, https://github.com/app-sre/automated-actions
+Project-URL: repository, https://github.com/app-sre/automated-actions
+Project-URL: documentation, https://github.com/app-sre/automated-actions
+Author-email: AppSRE <sd-app-sre@redhat.com>
+License: Apache 2.0
+Requires-Python: ~=3.12.0
+Requires-Dist: attrs
+Requires-Dist: httpx
+Requires-Dist: python-dateutil
+Requires-Dist: typer
+Description-Content-Type: text/markdown
+
+# `automated_actions_client` Package 🤖🐍
+
+Welcome, developer, to the `automated_actions_client` package! This package provides a Python client library for interacting with the `automated_actions` API server.
+
+## 🎯 Overview
+
+The primary purpose of this client is to offer a convenient, type-safe, and Pythonic way to make API calls to the `automated_actions` service. It is **auto-generated** based on the OpenAPI (formerly Swagger) specification provided by the `automated_actions` server.
+
+This package includes:
+
+* A Python module that maps API operations to Python methods.
+* Pydantic models for API request and response bodies, ensuring data validation and providing editor auto-completion.
+* Auto-generated [CLI](../automated_actions_cli/) commands using Typer, built from the same OpenAPI specification.
+
+## 🛠️ Generation Process
+
+### Based on OpenAPI Schema
+
+The client code is not manually written but **generated automatically** from the OpenAPI 3.x schema. This schema is typically exposed by the `automated_actions` FastAPI server (e.g., at `/openapi.json`). This ensures that the client stays in sync with the API's capabilities.
+
+### `openapi-python-client`
+
+We use the [openapi-python-client](https://github.com/openapi-generators/openapi-python-client) tool to perform the generation. This tool takes the OpenAPI schema as input and outputs the Python client code.
+
+### `make generate-client`
+
+To regenerate the client (e.g., after the `automated_actions` API has changed), you can use the following command from the **project root**:
+
+```bash
+make generate-client
+```
+
+This command typically performs the following steps:
+
+1. Ensures the `automated_actions` server is running and its OpenAPI schema is accessible (or fetches a static schema file).
+2. Invokes `openapi-python-client` with the appropriate configuration (input schema URL/file, output directory, custom templates).
+3. Overwrites the existing client code in this package with the newly generated version.
+
+**Important:** After regenerating the client, always review the changes and run tests to ensure compatibility.
+
+## ✨ Key Features & Structure
+
+### Client Class
+
+The core of the generated client is usually a class (e.g., `AuthenticatedClient` or `Client`) that provides methods for each API endpoint.
+
+```python
+# Example Usage (conceptual)
+from automated_actions_client import AuthenticatedClient
+from automated_actions_client.models import ActionRequest, ActionStatus
+from automated_actions_client.api.actions import submit_action, get_action_status
+from automated_actions_client.types import Response
+
+# Assuming client is initialized and authenticated
+client = AuthenticatedClient(base_url="http://localhost:8080", token="your-auth-token")
+
+# Submit an action
+action_data = ActionRequest(action_name="restart_pod", parameters={"pod_name": "my-app-123"})
+response: Response[ActionStatus] = submit_action.sync(client=client, json_body=action_data)
+
+if response.status_code == 202 and response.parsed:
+    task_id = response.parsed.task_id
+    print(f"Action submitted, task ID: {task_id}")
+```
+
+See our [integration tests](../integration_tests/tests/test_views_user.py) for more examples.
+
+### Pydantic Models
+
+All request and response bodies, as well as complex parameters, are represented by Pydantic models. These are typically found in `automated_actions_client/models/`. This provides:
+
+* Data validation.
+* Type hints for better static analysis and auto-completion.
+* Easy serialization and deserialization.
+
+### API Modules
+
+API operations are often grouped into modules corresponding to their tags in the OpenAPI specification (e.g., `automated_actions_client/api/actions.py`, `automated_actions_client/api/users.py`). Each module contains functions for synchronous and asynchronous calls to the endpoints.
+
+### CLI Commands (via Custom Templates) 💻
+
+This client package might also generate Command Line Interface (CLI) commands using [Typer](https://typer.tiangolo.com/). This is achieved by using **custom templates** with `openapi-python-client`.
+
+* **Custom Templates:** These templates are located in a directory like `openapi_python_client_templates/` (often at the project root or within this package's parent). They instruct `openapi-python-client` on how to generate Typer app structures and commands based on the OpenAPI paths and operations.
+* **Functionality:** This allows users to interact with the API directly from the command line using a familiar CLI structure, with arguments and options derived from the API parameters.
+* **Entry Point:** The generated CLI might have an entry point defined in `pyproject.toml` (e.g., `automated-actions-client ...`) or be part of a larger CLI tool.
+
+The `make generate-client` command should also handle the generation of these CLI components if custom templates are configured.
+
+## 🚀 Development & Contribution
+
+### When to Regenerate
+
+You should regenerate the client whenever:
+
+* The `automated_actions` API's OpenAPI schema changes (e.g., new endpoints, modified models, changed parameters).
+* The version of `openapi-python-client` is updated, and you want to leverage new features or bug fixes from the generator.
+* The custom templates for CLI generation are modified.
+
+### Testing
+
+See [tests](./tests/) for unit tests and [integration tests](../integration_tests/) that validate the generated client against the actual API. These tests ensure that the client behaves as expected and that any changes in the API are reflected correctly in the client.
+
+### Release Process
+
+Please refer to the main project [README.md](/README.md) for the release process, as it typically includes steps for versioning, changelogs, and deployment.

automated_actions_client-0.1.0/README.md

@@ -0,0 +1,106 @@
+# `automated_actions_client` Package 🤖🐍
+
+Welcome, developer, to the `automated_actions_client` package! This package provides a Python client library for interacting with the `automated_actions` API server.
+
+## 🎯 Overview
+
+The primary purpose of this client is to offer a convenient, type-safe, and Pythonic way to make API calls to the `automated_actions` service. It is **auto-generated** based on the OpenAPI (formerly Swagger) specification provided by the `automated_actions` server.
+
+This package includes:
+
+* A Python module that maps API operations to Python methods.
+* Pydantic models for API request and response bodies, ensuring data validation and providing editor auto-completion.
+* Auto-generated [CLI](../automated_actions_cli/) commands using Typer, built from the same OpenAPI specification.
+
+## 🛠️ Generation Process
+
+### Based on OpenAPI Schema
+
+The client code is not manually written but **generated automatically** from the OpenAPI 3.x schema. This schema is typically exposed by the `automated_actions` FastAPI server (e.g., at `/openapi.json`). This ensures that the client stays in sync with the API's capabilities.
+
+### `openapi-python-client`
+
+We use the [openapi-python-client](https://github.com/openapi-generators/openapi-python-client) tool to perform the generation. This tool takes the OpenAPI schema as input and outputs the Python client code.
+
+### `make generate-client`
+
+To regenerate the client (e.g., after the `automated_actions` API has changed), you can use the following command from the **project root**:
+
+```bash
+make generate-client
+```
+
+This command typically performs the following steps:
+
+1. Ensures the `automated_actions` server is running and its OpenAPI schema is accessible (or fetches a static schema file).
+2. Invokes `openapi-python-client` with the appropriate configuration (input schema URL/file, output directory, custom templates).
+3. Overwrites the existing client code in this package with the newly generated version.
+
+**Important:** After regenerating the client, always review the changes and run tests to ensure compatibility.
+
+## ✨ Key Features & Structure
+
+### Client Class
+
+The core of the generated client is usually a class (e.g., `AuthenticatedClient` or `Client`) that provides methods for each API endpoint.
+
+```python
+# Example Usage (conceptual)
+from automated_actions_client import AuthenticatedClient
+from automated_actions_client.models import ActionRequest, ActionStatus
+from automated_actions_client.api.actions import submit_action, get_action_status
+from automated_actions_client.types import Response
+
+# Assuming client is initialized and authenticated
+client = AuthenticatedClient(base_url="http://localhost:8080", token="your-auth-token")
+
+# Submit an action
+action_data = ActionRequest(action_name="restart_pod", parameters={"pod_name": "my-app-123"})
+response: Response[ActionStatus] = submit_action.sync(client=client, json_body=action_data)
+
+if response.status_code == 202 and response.parsed:
+    task_id = response.parsed.task_id
+    print(f"Action submitted, task ID: {task_id}")
+```
+
+See our [integration tests](../integration_tests/tests/test_views_user.py) for more examples.
+
+### Pydantic Models
+
+All request and response bodies, as well as complex parameters, are represented by Pydantic models. These are typically found in `automated_actions_client/models/`. This provides:
+
+* Data validation.
+* Type hints for better static analysis and auto-completion.
+* Easy serialization and deserialization.
+
+### API Modules
+
+API operations are often grouped into modules corresponding to their tags in the OpenAPI specification (e.g., `automated_actions_client/api/actions.py`, `automated_actions_client/api/users.py`). Each module contains functions for synchronous and asynchronous calls to the endpoints.
+
+### CLI Commands (via Custom Templates) 💻
+
+This client package might also generate Command Line Interface (CLI) commands using [Typer](https://typer.tiangolo.com/). This is achieved by using **custom templates** with `openapi-python-client`.
+
+* **Custom Templates:** These templates are located in a directory like `openapi_python_client_templates/` (often at the project root or within this package's parent). They instruct `openapi-python-client` on how to generate Typer app structures and commands based on the OpenAPI paths and operations.
+* **Functionality:** This allows users to interact with the API directly from the command line using a familiar CLI structure, with arguments and options derived from the API parameters.
+* **Entry Point:** The generated CLI might have an entry point defined in `pyproject.toml` (e.g., `automated-actions-client ...`) or be part of a larger CLI tool.
+
+The `make generate-client` command should also handle the generation of these CLI components if custom templates are configured.
+
+## 🚀 Development & Contribution
+
+### When to Regenerate
+
+You should regenerate the client whenever:
+
+* The `automated_actions` API's OpenAPI schema changes (e.g., new endpoints, modified models, changed parameters).
+* The version of `openapi-python-client` is updated, and you want to leverage new features or bug fixes from the generator.
+* The custom templates for CLI generation are modified.
+
+### Testing
+
+See [tests](./tests/) for unit tests and [integration tests](../integration_tests/) that validate the generated client against the actual API. These tests ensure that the client behaves as expected and that any changes in the API are reflected correctly in the client.
+
+### Release Process
+
+Please refer to the main project [README.md](/README.md) for the release process, as it typically includes steps for versioning, changelogs, and deployment.

automated_actions_client-0.1.0/automated_actions_client/__init__.py

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

automated_actions_client-0.1.0/automated_actions_client/api/__init__.py

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

automated_actions_client-0.1.0/automated_actions_client/api/v1/__init__.py

@@ -0,0 +1,24 @@
+# This file is auto-generated by OpenAPI Python Client.
+# Do not edit manually.
+
+from . import (
+    action_cancel,
+    action_detail,
+    action_list,
+    create_token,
+    external_resource_rds_reboot,
+    me,
+    no_op,
+    openshift_workload_restart,
+)
+
+__all__ = [
+    "action_cancel",
+    "action_detail",
+    "action_list",
+    "create_token",
+    "external_resource_rds_reboot",
+    "me",
+    "no_op",
+    "openshift_workload_restart",
+]

automated_actions_client-0.1.0/automated_actions_client/api/v1/action_cancel.py

@@ -0,0 +1,194 @@
+# This file is auto-generated by OpenAPI Python Client.
+# Do not edit manually.
+
+from http import HTTPStatus
+from typing import Any
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.action_schema_out import ActionSchemaOut
+from ...models.http_validation_error import HTTPValidationError
+from ...types import Response
+
+
+def _get_kwargs(
+    action_id: str,
+) -> dict[str, Any]:
+    _kwargs: dict[str, Any] = {
+        "method": "post",
+        "url": f"/api/v1/actions/{action_id}",
+    }
+
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> ActionSchemaOut | HTTPValidationError | None:
+    if response.status_code == 202:
+        response_202 = ActionSchemaOut.from_dict(response.json())
+
+        return response_202
+    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[ActionSchemaOut | 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(
+    action_id: str,
+    *,
+    client: AuthenticatedClient | Client,
+) -> Response[ActionSchemaOut | HTTPValidationError]:
+    """Action Cancel
+
+     Cancels a pending or running action by its ID.
+
+    Args:
+        action_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[Union[ActionSchemaOut, HTTPValidationError]]
+    """
+
+    kwargs = _get_kwargs(
+        action_id=action_id,
+    )
+
+    with client as _client:
+        response = _client.request(
+            **kwargs,
+        )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    action_id: str,
+    *,
+    client: AuthenticatedClient | Client,
+) -> ActionSchemaOut | HTTPValidationError | None:
+    """Action Cancel
+
+     Cancels a pending or running action by its ID.
+
+    Args:
+        action_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:
+        Union[ActionSchemaOut, HTTPValidationError]
+    """
+
+    return sync_detailed(
+        action_id=action_id,
+        client=client,
+    ).parsed
+
+
+async def asyncio_detailed(
+    action_id: str,
+    *,
+    client: AuthenticatedClient | Client,
+) -> Response[ActionSchemaOut | HTTPValidationError]:
+    """Action Cancel
+
+     Cancels a pending or running action by its ID.
+
+    Args:
+        action_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[Union[ActionSchemaOut, HTTPValidationError]]
+    """
+
+    kwargs = _get_kwargs(
+        action_id=action_id,
+    )
+
+    async with client as _client:
+        response = await _client.request(
+            **kwargs,
+        )
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    action_id: str,
+    *,
+    client: AuthenticatedClient | Client,
+) -> ActionSchemaOut | HTTPValidationError | None:
+    """Action Cancel
+
+     Cancels a pending or running action by its ID.
+
+    Args:
+        action_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:
+        Union[ActionSchemaOut, HTTPValidationError]
+    """
+
+    return (
+        await asyncio_detailed(
+            action_id=action_id,
+            client=client,
+        )
+    ).parsed
+
+
+from typing import Annotated
+
+import typer
+
+app = typer.Typer()
+
+
+@app.command(help="""Cancels a pending or running action by its ID.""")
+def action_cancel(
+    ctx: typer.Context,
+    action_id: Annotated[str, typer.Option(help="", show_default=False)],
+) -> None:
+    result = sync(action_id=action_id, client=ctx.obj["client"])
+    if "formatter" in ctx.obj and result:
+        output: Any = result
+        if isinstance(result, list):
+            output = [
+                item.to_dict() if hasattr(item, "to_dict") else item for item in result
+            ]
+        elif hasattr(result, "to_dict"):
+            output = result.to_dict()
+        ctx.obj["formatter"](output)

automated_actions_client-0.1.0/automated_actions_client/api/v1/action_detail.py

@@ -0,0 +1,194 @@
+# This file is auto-generated by OpenAPI Python Client.
+# Do not edit manually.
+
+from http import HTTPStatus
+from typing import Any
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.action_schema_out import ActionSchemaOut
+from ...models.http_validation_error import HTTPValidationError
+from ...types import Response
+
+
+def _get_kwargs(
+    action_id: str,
+) -> dict[str, Any]:
+    _kwargs: dict[str, Any] = {
+        "method": "get",
+        "url": f"/api/v1/actions/{action_id}",
+    }
+
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> ActionSchemaOut | HTTPValidationError | None:
+    if response.status_code == 200:
+        response_200 = ActionSchemaOut.from_dict(response.json())
+
+        return response_200
+    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[ActionSchemaOut | 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(
+    action_id: str,
+    *,
+    client: AuthenticatedClient | Client,
+) -> Response[ActionSchemaOut | HTTPValidationError]:
+    """Action Detail
+
+     Retrieves the details of a specific action by its ID.
+
+    Args:
+        action_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[Union[ActionSchemaOut, HTTPValidationError]]
+    """
+
+    kwargs = _get_kwargs(
+        action_id=action_id,
+    )
+
+    with client as _client:
+        response = _client.request(
+            **kwargs,
+        )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    action_id: str,
+    *,
+    client: AuthenticatedClient | Client,
+) -> ActionSchemaOut | HTTPValidationError | None:
+    """Action Detail
+
+     Retrieves the details of a specific action by its ID.
+
+    Args:
+        action_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:
+        Union[ActionSchemaOut, HTTPValidationError]
+    """
+
+    return sync_detailed(
+        action_id=action_id,
+        client=client,
+    ).parsed
+
+
+async def asyncio_detailed(
+    action_id: str,
+    *,
+    client: AuthenticatedClient | Client,
+) -> Response[ActionSchemaOut | HTTPValidationError]:
+    """Action Detail
+
+     Retrieves the details of a specific action by its ID.
+
+    Args:
+        action_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[Union[ActionSchemaOut, HTTPValidationError]]
+    """
+
+    kwargs = _get_kwargs(
+        action_id=action_id,
+    )
+
+    async with client as _client:
+        response = await _client.request(
+            **kwargs,
+        )
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    action_id: str,
+    *,
+    client: AuthenticatedClient | Client,
+) -> ActionSchemaOut | HTTPValidationError | None:
+    """Action Detail
+
+     Retrieves the details of a specific action by its ID.
+
+    Args:
+        action_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:
+        Union[ActionSchemaOut, HTTPValidationError]
+    """
+
+    return (
+        await asyncio_detailed(
+            action_id=action_id,
+            client=client,
+        )
+    ).parsed
+
+
+from typing import Annotated
+
+import typer
+
+app = typer.Typer()
+
+
+@app.command(help="""Retrieves the details of a specific action by its ID.""")
+def action_detail(
+    ctx: typer.Context,
+    action_id: Annotated[str, typer.Option(help="", show_default=False)],
+) -> None:
+    result = sync(action_id=action_id, client=ctx.obj["client"])
+    if "formatter" in ctx.obj and result:
+        output: Any = result
+        if isinstance(result, list):
+            output = [
+                item.to_dict() if hasattr(item, "to_dict") else item for item in result
+            ]
+        elif hasattr(result, "to_dict"):
+            output = result.to_dict()
+        ctx.obj["formatter"](output)