musubi-client 0.2.0__py3-none-any.whl

musubi/__init__.py

@@ -0,0 +1,43 @@
+"""Musubi Python SDK — client for the Musubi PolicyAI API.
+
+This SDK exposes v2 API surfaces plus v1 resources that have no v2 equivalent
+yet (datasets, evaluations). Superseded v1 endpoints are intentionally excluded.
+See client.py module docstring for the full supersession map.
+"""
+
+from musubi.client import AsyncMusubiClient, MusubiClient
+from musubi.exceptions import (
+    MusubiAPIError,
+    MusubiAuthError,
+    MusubiError,
+    MusubiNotFoundError,
+    MusubiRateLimitError,
+    MusubiValidationError,
+)
+from musubi.labeling import (
+    audio_url_content,
+    image_base64_content,
+    image_url_content,
+    pdf_url_content,
+    policy_labeler,
+    text_content,
+    video_url_content,
+)
+
+__all__ = [
+    "AsyncMusubiClient",
+    "MusubiAPIError",
+    "MusubiAuthError",
+    "MusubiClient",
+    "MusubiError",
+    "MusubiNotFoundError",
+    "MusubiRateLimitError",
+    "MusubiValidationError",
+    "audio_url_content",
+    "image_base64_content",
+    "image_url_content",
+    "pdf_url_content",
+    "policy_labeler",
+    "text_content",
+    "video_url_content",
+]

musubi/_base.py

@@ -0,0 +1,65 @@
+"""Base resource class for SDK resource groups."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any
+
+from musubi.exceptions import raise_for_status
+
+if TYPE_CHECKING:
+    from musubi._generated.policyai.client import AuthenticatedClient
+
+
+class SyncResource:
+    """Base class for sync resource groups."""
+
+    def __init__(self, client: AuthenticatedClient, org_id: str) -> None:
+        self._client = client
+        self._org_id = org_id
+
+    def _request(self, method: str, path: str, *, json: Any = None, params: dict[str, Any] | None = None) -> Any:
+        """Make an authenticated request and return the parsed JSON body."""
+        http_client = self._client.get_httpx_client()
+        response = http_client.request(method, path, json=json, params=_clean_params(params))
+        raise_for_status(response.status_code, response.content)
+        if response.status_code == 204:
+            return None
+        return response.json()
+
+    def _request_data(self, method: str, path: str, *, json: Any = None, params: dict[str, Any] | None = None) -> Any:
+        """Make a request and unwrap the envelope, returning the `data` field."""
+        body = self._request(method, path, json=json, params=params)
+        if isinstance(body, dict) and "data" in body:
+            return body["data"]
+        return body
+
+
+class AsyncResource:
+    """Base class for async resource groups."""
+
+    def __init__(self, client: AuthenticatedClient, org_id: str) -> None:
+        self._client = client
+        self._org_id = org_id
+
+    async def _request(self, method: str, path: str, *, json: Any = None, params: dict[str, Any] | None = None) -> Any:
+        http_client = self._client.get_async_httpx_client()
+        response = await http_client.request(method, path, json=json, params=_clean_params(params))
+        raise_for_status(response.status_code, response.content)
+        if response.status_code == 204:
+            return None
+        return response.json()
+
+    async def _request_data(
+        self, method: str, path: str, *, json: Any = None, params: dict[str, Any] | None = None
+    ) -> Any:
+        body = await self._request(method, path, json=json, params=params)
+        if isinstance(body, dict) and "data" in body:
+            return body["data"]
+        return body
+
+
+def _clean_params(params: dict[str, Any] | None) -> dict[str, Any] | None:
+    """Remove None values from query params."""
+    if params is None:
+        return None
+    return {k: v for k, v in params.items() if v is not None}

musubi/_cli_shared.py

@@ -0,0 +1,39 @@
+"""Tiny CLI helpers shared by `cli.py` and the `commands/` modules.
+
+A leaf module (imports nothing from the package) so both the CLI root and
+the command modules can import from it without the import cycle that forces
+`commands/*` to shim `_out`/`_client_from_ctx` off `cli`.
+"""
+
+from __future__ import annotations
+
+import click
+
+_ID_SHORT_WIDTH = 8
+
+
+def parse_kv_pairs(values: tuple[str, ...], *, what: str = "csv_column=value") -> dict[str, str]:
+    """Parse repeatable `key=value` CLI options into a dict.
+
+    Used for `--content-column csv_col=content_key` and
+    `--content-format csv_col=type`. `what` names the expected shape in the
+    error message.
+    """
+    result: dict[str, str] = {}
+    for v in values:
+        if "=" not in v:
+            raise click.BadParameter(f"Expected {what}, got: {v}")
+        left, right = v.split("=", 1)
+        result[left] = right
+    return result
+
+
+def short_id(org_id: str | None, *, width: int = _ID_SHORT_WIDTH) -> str:
+    """Truncate an org/id for display (`019e48d3…`), or `?` when absent.
+
+    One width everywhere so the same org renders identically across the
+    header, `profiles list`, and `doctor`.
+    """
+    if not org_id:
+        return "?"
+    return org_id[:width] + "…" if len(org_id) > width else org_id

musubi/_generated/policyai/__init__.py

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

musubi/_generated/policyai/api/__init__.py

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

musubi/_generated/policyai/api/application_information/__init__.py

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

musubi/_generated/policyai/api/application_information/get_version_api_version_get.py

@@ -0,0 +1,125 @@
+from http import HTTPStatus
+from typing import Any
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.version_response_model import VersionResponseModel
+from ...types import Response
+
+
+def _get_kwargs() -> dict[str, Any]:
+    _kwargs: dict[str, Any] = {
+        "method": "get",
+        "url": "/version",
+    }
+
+    return _kwargs
+
+
+def _parse_response(*, client: AuthenticatedClient | Client, response: httpx.Response) -> VersionResponseModel | None:
+    if response.status_code == 200:
+        response_200 = VersionResponseModel.from_dict(response.json())
+
+        return response_200
+
+    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[VersionResponseModel]:
+    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,
+) -> Response[VersionResponseModel]:
+    """Get version information for the application
+
+    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[VersionResponseModel]
+    """
+
+    kwargs = _get_kwargs()
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    *,
+    client: AuthenticatedClient,
+) -> VersionResponseModel | None:
+    """Get version information for the application
+
+    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:
+        VersionResponseModel
+    """
+
+    return sync_detailed(
+        client=client,
+    ).parsed
+
+
+async def asyncio_detailed(
+    *,
+    client: AuthenticatedClient,
+) -> Response[VersionResponseModel]:
+    """Get version information for the application
+
+    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[VersionResponseModel]
+    """
+
+    kwargs = _get_kwargs()
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    *,
+    client: AuthenticatedClient,
+) -> VersionResponseModel | None:
+    """Get version information for the application
+
+    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:
+        VersionResponseModel
+    """
+
+    return (
+        await asyncio_detailed(
+            client=client,
+        )
+    ).parsed

musubi/_generated/policyai/api/decisions/__init__.py

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

musubi/_generated/policyai/api/decisions/evaluate_content_against_policy_version_api_v_1_decisions_policies_policy_id_versions_policy_version_id_post.py

@@ -0,0 +1,197 @@
+from http import HTTPStatus
+from typing import Any
+from urllib.parse import quote
+from uuid import UUID
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.evaluate_content_request_model import EvaluateContentRequestModel
+from ...models.http_validation_error import HTTPValidationError
+from ...models.moderation_results_envelope_response_model import ModerationResultsEnvelopeResponseModel
+from ...types import Response
+
+
+def _get_kwargs(
+    policy_id: UUID,
+    policy_version_id: UUID,
+    *,
+    body: EvaluateContentRequestModel,
+) -> dict[str, Any]:
+    headers: dict[str, Any] = {}
+
+    _kwargs: dict[str, Any] = {
+        "method": "post",
+        "url": "/v1/decisions/policies/{policy_id}/versions/{policy_version_id}".format(
+            policy_id=quote(str(policy_id), safe=""),
+            policy_version_id=quote(str(policy_version_id), safe=""),
+        ),
+    }
+
+    _kwargs["json"] = body.to_dict()
+
+    headers["Content-Type"] = "application/json"
+
+    _kwargs["headers"] = headers
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> HTTPValidationError | ModerationResultsEnvelopeResponseModel | None:
+    if response.status_code == 200:
+        response_200 = ModerationResultsEnvelopeResponseModel.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[HTTPValidationError | ModerationResultsEnvelopeResponseModel]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    policy_id: UUID,
+    policy_version_id: UUID,
+    *,
+    client: AuthenticatedClient,
+    body: EvaluateContentRequestModel,
+) -> Response[HTTPValidationError | ModerationResultsEnvelopeResponseModel]:
+    """Evaluate content against a policy version.
+
+    Args:
+        policy_id (UUID):
+        policy_version_id (UUID):
+        body (EvaluateContentRequestModel):
+
+    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[HTTPValidationError | ModerationResultsEnvelopeResponseModel]
+    """
+
+    kwargs = _get_kwargs(
+        policy_id=policy_id,
+        policy_version_id=policy_version_id,
+        body=body,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    policy_id: UUID,
+    policy_version_id: UUID,
+    *,
+    client: AuthenticatedClient,
+    body: EvaluateContentRequestModel,
+) -> HTTPValidationError | ModerationResultsEnvelopeResponseModel | None:
+    """Evaluate content against a policy version.
+
+    Args:
+        policy_id (UUID):
+        policy_version_id (UUID):
+        body (EvaluateContentRequestModel):
+
+    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:
+        HTTPValidationError | ModerationResultsEnvelopeResponseModel
+    """
+
+    return sync_detailed(
+        policy_id=policy_id,
+        policy_version_id=policy_version_id,
+        client=client,
+        body=body,
+    ).parsed
+
+
+async def asyncio_detailed(
+    policy_id: UUID,
+    policy_version_id: UUID,
+    *,
+    client: AuthenticatedClient,
+    body: EvaluateContentRequestModel,
+) -> Response[HTTPValidationError | ModerationResultsEnvelopeResponseModel]:
+    """Evaluate content against a policy version.
+
+    Args:
+        policy_id (UUID):
+        policy_version_id (UUID):
+        body (EvaluateContentRequestModel):
+
+    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[HTTPValidationError | ModerationResultsEnvelopeResponseModel]
+    """
+
+    kwargs = _get_kwargs(
+        policy_id=policy_id,
+        policy_version_id=policy_version_id,
+        body=body,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    policy_id: UUID,
+    policy_version_id: UUID,
+    *,
+    client: AuthenticatedClient,
+    body: EvaluateContentRequestModel,
+) -> HTTPValidationError | ModerationResultsEnvelopeResponseModel | None:
+    """Evaluate content against a policy version.
+
+    Args:
+        policy_id (UUID):
+        policy_version_id (UUID):
+        body (EvaluateContentRequestModel):
+
+    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:
+        HTTPValidationError | ModerationResultsEnvelopeResponseModel
+    """
+
+    return (
+        await asyncio_detailed(
+            policy_id=policy_id,
+            policy_version_id=policy_version_id,
+            client=client,
+            body=body,
+        )
+    ).parsed

musubi/_generated/policyai/api/decisions/evaluate_content_against_tagged_policy_versions_api_v1_decisions_evaluate_tag_name_post.py

@@ -0,0 +1,182 @@
+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.evaluate_content_request_model import EvaluateContentRequestModel
+from ...models.http_validation_error import HTTPValidationError
+from ...models.multiple_decision_results_response_model import MultipleDecisionResultsResponseModel
+from ...types import Response
+
+
+def _get_kwargs(
+    tag_name: str,
+    *,
+    body: EvaluateContentRequestModel,
+) -> dict[str, Any]:
+    headers: dict[str, Any] = {}
+
+    _kwargs: dict[str, Any] = {
+        "method": "post",
+        "url": "/v1/decisions/evaluate/{tag_name}".format(
+            tag_name=quote(str(tag_name), safe=""),
+        ),
+    }
+
+    _kwargs["json"] = body.to_dict()
+
+    headers["Content-Type"] = "application/json"
+
+    _kwargs["headers"] = headers
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> HTTPValidationError | MultipleDecisionResultsResponseModel | None:
+    if response.status_code == 200:
+        response_200 = MultipleDecisionResultsResponseModel.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[HTTPValidationError | MultipleDecisionResultsResponseModel]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    tag_name: str,
+    *,
+    client: AuthenticatedClient,
+    body: EvaluateContentRequestModel,
+) -> Response[HTTPValidationError | MultipleDecisionResultsResponseModel]:
+    """Evaluate content against all policy versions in a tag.
+
+    Args:
+        tag_name (str):
+        body (EvaluateContentRequestModel):
+
+    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[HTTPValidationError | MultipleDecisionResultsResponseModel]
+    """
+
+    kwargs = _get_kwargs(
+        tag_name=tag_name,
+        body=body,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    tag_name: str,
+    *,
+    client: AuthenticatedClient,
+    body: EvaluateContentRequestModel,
+) -> HTTPValidationError | MultipleDecisionResultsResponseModel | None:
+    """Evaluate content against all policy versions in a tag.
+
+    Args:
+        tag_name (str):
+        body (EvaluateContentRequestModel):
+
+    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:
+        HTTPValidationError | MultipleDecisionResultsResponseModel
+    """
+
+    return sync_detailed(
+        tag_name=tag_name,
+        client=client,
+        body=body,
+    ).parsed
+
+
+async def asyncio_detailed(
+    tag_name: str,
+    *,
+    client: AuthenticatedClient,
+    body: EvaluateContentRequestModel,
+) -> Response[HTTPValidationError | MultipleDecisionResultsResponseModel]:
+    """Evaluate content against all policy versions in a tag.
+
+    Args:
+        tag_name (str):
+        body (EvaluateContentRequestModel):
+
+    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[HTTPValidationError | MultipleDecisionResultsResponseModel]
+    """
+
+    kwargs = _get_kwargs(
+        tag_name=tag_name,
+        body=body,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    tag_name: str,
+    *,
+    client: AuthenticatedClient,
+    body: EvaluateContentRequestModel,
+) -> HTTPValidationError | MultipleDecisionResultsResponseModel | None:
+    """Evaluate content against all policy versions in a tag.
+
+    Args:
+        tag_name (str):
+        body (EvaluateContentRequestModel):
+
+    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:
+        HTTPValidationError | MultipleDecisionResultsResponseModel
+    """
+
+    return (
+        await asyncio_detailed(
+            tag_name=tag_name,
+            client=client,
+            body=body,
+        )
+    ).parsed