unitysvc-py 0.2.0__tar.gz → 0.2.1__tar.gz

{unitysvc_py-0.2.0/src/unitysvc_py.egg-info → unitysvc_py-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: unitysvc-py
-Version: 0.2.0
+Version: 0.2.1
 Summary: Customer-facing Python SDK and `usvc` CLI for UnitySVC
 Author-email: Bo Peng <bo.peng@unitysvc.com>
 Maintainer-email: Bo Peng <bo.peng@unitysvc.com>

{unitysvc_py-0.2.0 → unitysvc_py-0.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "unitysvc-py"
-version = "0.2.0"
+version = "0.2.1"
 description = "Customer-facing Python SDK and `usvc` CLI for UnitySVC"
 readme = "README.md"
 authors = [{ name = "Bo Peng", email = "bo.peng@unitysvc.com" }]

unitysvc_py-0.2.1/src/unitysvc/_generated/api/customer/customer_get_cycle_usage.py

@@ -0,0 +1,229 @@
+import datetime
+from http import HTTPStatus
+from typing import Any, cast
+from urllib.parse import quote
+
+import httpx
+from dateutil.parser import isoparse
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.cycle_usage_response import CycleUsageResponse
+from ...models.http_validation_error import HTTPValidationError
+from ...types import UNSET, Response, Unset
+
+
+def _get_kwargs(
+    *,
+    cycle_start: datetime.date | None | Unset = UNSET,
+    authorization: None | str | Unset = UNSET,
+    x_role_id: None | str | Unset = UNSET,
+) -> dict[str, Any]:
+    headers: dict[str, Any] = {}
+    if not isinstance(authorization, Unset):
+        headers["authorization"] = authorization
+
+    if not isinstance(x_role_id, Unset):
+        headers["x-role-id"] = x_role_id
+
+    params: dict[str, Any] = {}
+
+    json_cycle_start: None | str | Unset
+    if isinstance(cycle_start, Unset):
+        json_cycle_start = UNSET
+    elif isinstance(cycle_start, datetime.date):
+        json_cycle_start = cycle_start.isoformat()
+    else:
+        json_cycle_start = cycle_start
+    params["cycle_start"] = json_cycle_start
+
+    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": "/usage/cycle",
+        "params": params,
+    }
+
+    _kwargs["headers"] = headers
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> CycleUsageResponse | HTTPValidationError | None:
+    if response.status_code == 200:
+        response_200 = CycleUsageResponse.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[CycleUsageResponse | 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(
+    *,
+    client: AuthenticatedClient | Client,
+    cycle_start: datetime.date | None | Unset = UNSET,
+    authorization: None | str | Unset = UNSET,
+    x_role_id: None | str | Unset = UNSET,
+) -> Response[CycleUsageResponse | HTTPValidationError]:
+    """Cycle-to-date usage and cost
+
+     Per-service usage and cost for the current billing cycle, plus every plan-level meter (request
+    logging, log storage, data transfer) with its included quota. Defaults to the current cycle; pass
+    cycle_start to read an earlier one.
+
+    Args:
+        cycle_start (datetime.date | None | Unset): First day of the cycle to report. Defaults to
+            the customer's current wallet cycle.
+        authorization (None | str | Unset):
+        x_role_id (None | str | Unset):
+
+    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[CycleUsageResponse | HTTPValidationError]
+    """
+
+    kwargs = _get_kwargs(
+        cycle_start=cycle_start,
+        authorization=authorization,
+        x_role_id=x_role_id,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    *,
+    client: AuthenticatedClient | Client,
+    cycle_start: datetime.date | None | Unset = UNSET,
+    authorization: None | str | Unset = UNSET,
+    x_role_id: None | str | Unset = UNSET,
+) -> CycleUsageResponse | HTTPValidationError | None:
+    """Cycle-to-date usage and cost
+
+     Per-service usage and cost for the current billing cycle, plus every plan-level meter (request
+    logging, log storage, data transfer) with its included quota. Defaults to the current cycle; pass
+    cycle_start to read an earlier one.
+
+    Args:
+        cycle_start (datetime.date | None | Unset): First day of the cycle to report. Defaults to
+            the customer's current wallet cycle.
+        authorization (None | str | Unset):
+        x_role_id (None | str | Unset):
+
+    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:
+        CycleUsageResponse | HTTPValidationError
+    """
+
+    return sync_detailed(
+        client=client,
+        cycle_start=cycle_start,
+        authorization=authorization,
+        x_role_id=x_role_id,
+    ).parsed
+
+
+async def asyncio_detailed(
+    *,
+    client: AuthenticatedClient | Client,
+    cycle_start: datetime.date | None | Unset = UNSET,
+    authorization: None | str | Unset = UNSET,
+    x_role_id: None | str | Unset = UNSET,
+) -> Response[CycleUsageResponse | HTTPValidationError]:
+    """Cycle-to-date usage and cost
+
+     Per-service usage and cost for the current billing cycle, plus every plan-level meter (request
+    logging, log storage, data transfer) with its included quota. Defaults to the current cycle; pass
+    cycle_start to read an earlier one.
+
+    Args:
+        cycle_start (datetime.date | None | Unset): First day of the cycle to report. Defaults to
+            the customer's current wallet cycle.
+        authorization (None | str | Unset):
+        x_role_id (None | str | Unset):
+
+    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[CycleUsageResponse | HTTPValidationError]
+    """
+
+    kwargs = _get_kwargs(
+        cycle_start=cycle_start,
+        authorization=authorization,
+        x_role_id=x_role_id,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    *,
+    client: AuthenticatedClient | Client,
+    cycle_start: datetime.date | None | Unset = UNSET,
+    authorization: None | str | Unset = UNSET,
+    x_role_id: None | str | Unset = UNSET,
+) -> CycleUsageResponse | HTTPValidationError | None:
+    """Cycle-to-date usage and cost
+
+     Per-service usage and cost for the current billing cycle, plus every plan-level meter (request
+    logging, log storage, data transfer) with its included quota. Defaults to the current cycle; pass
+    cycle_start to read an earlier one.
+
+    Args:
+        cycle_start (datetime.date | None | Unset): First day of the cycle to report. Defaults to
+            the customer's current wallet cycle.
+        authorization (None | str | Unset):
+        x_role_id (None | str | Unset):
+
+    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:
+        CycleUsageResponse | HTTPValidationError
+    """
+
+    return (
+        await asyncio_detailed(
+            client=client,
+            cycle_start=cycle_start,
+            authorization=authorization,
+            x_role_id=x_role_id,
+        )
+    ).parsed

{unitysvc_py-0.2.0 → unitysvc_py-0.2.1}/src/unitysvc/_generated/api/customer_broadcasts/customer_broadcasts_update_broadcast.py

@@ -80,12 +80,13 @@ def sync_detailed(
     authorization: None | str | Unset = UNSET,
     x_role_id: None | str | Unset = UNSET,
 ) -> Response[BroadcastPublic | HTTPValidationError]:
-    r"""Update Broadcast
+    """Update Broadcast
 
-     Update a broadcast's config (timeout, enabled, description).
+     Update a broadcast's config (mode, timeout, enabled, description).
 
-    ``mode`` may be set to ``\"sync\"`` but not ``\"async\"`` (rejected with 422
-    until async is built — see #1553).
+    Switching ``mode`` takes effect on the next ``/b/<name>`` call: ``sync``
+    blocks for the aggregated envelope, ``async`` returns ``202`` + per-target
+    task ids (#1553).
 
     Args:
         broadcast_id (UUID):
@@ -123,12 +124,13 @@ def sync(
     authorization: None | str | Unset = UNSET,
     x_role_id: None | str | Unset = UNSET,
 ) -> BroadcastPublic | HTTPValidationError | None:
-    r"""Update Broadcast
+    """Update Broadcast
 
-     Update a broadcast's config (timeout, enabled, description).
+     Update a broadcast's config (mode, timeout, enabled, description).
 
-    ``mode`` may be set to ``\"sync\"`` but not ``\"async\"`` (rejected with 422
-    until async is built — see #1553).
+    Switching ``mode`` takes effect on the next ``/b/<name>`` call: ``sync``
+    blocks for the aggregated envelope, ``async`` returns ``202`` + per-target
+    task ids (#1553).
 
     Args:
         broadcast_id (UUID):
@@ -161,12 +163,13 @@ async def asyncio_detailed(
     authorization: None | str | Unset = UNSET,
     x_role_id: None | str | Unset = UNSET,
 ) -> Response[BroadcastPublic | HTTPValidationError]:
-    r"""Update Broadcast
+    """Update Broadcast
 
-     Update a broadcast's config (timeout, enabled, description).
+     Update a broadcast's config (mode, timeout, enabled, description).
 
-    ``mode`` may be set to ``\"sync\"`` but not ``\"async\"`` (rejected with 422
-    until async is built — see #1553).
+    Switching ``mode`` takes effect on the next ``/b/<name>`` call: ``sync``
+    blocks for the aggregated envelope, ``async`` returns ``202`` + per-target
+    task ids (#1553).
 
     Args:
         broadcast_id (UUID):
@@ -202,12 +205,13 @@ async def asyncio(
     authorization: None | str | Unset = UNSET,
     x_role_id: None | str | Unset = UNSET,
 ) -> BroadcastPublic | HTTPValidationError | None:
-    r"""Update Broadcast
+    """Update Broadcast
 
-     Update a broadcast's config (timeout, enabled, description).
+     Update a broadcast's config (mode, timeout, enabled, description).
 
-    ``mode`` may be set to ``\"sync\"`` but not ``\"async\"`` (rejected with 422
-    until async is built — see #1553).
+    Switching ``mode`` takes effect on the next ``/b/<name>`` call: ``sync``
+    blocks for the aggregated envelope, ``async`` returns ``202`` + per-target
+    task ids (#1553).
 
     Args:
         broadcast_id (UUID):

{unitysvc_py-0.2.0 → unitysvc_py-0.2.1}/src/unitysvc/_generated/api/customer_groups/customer_groups_list_group_services.py

@@ -106,9 +106,8 @@ def sync_detailed(
     The group is addressable by id or name; both are returned in the
     group detail shape. Names stay valid across admin recreations of a
     group, so SDK scripts that use the name keep working.
-    Mirrors the visibility rule used by the GraphQL
-    ``resolve_group_services`` resolver for non-admin / non-seller
-    callers: service must be ``status='active'`` and
+    Matches the public catalog visibility rule: service must be
+    ``status='active'`` and
     ``visibility='public'``. The group itself must be in the
     customer-visible set (active + platform + non-empty).
 
@@ -172,9 +171,8 @@ def sync(
     The group is addressable by id or name; both are returned in the
     group detail shape. Names stay valid across admin recreations of a
     group, so SDK scripts that use the name keep working.
-    Mirrors the visibility rule used by the GraphQL
-    ``resolve_group_services`` resolver for non-admin / non-seller
-    callers: service must be ``status='active'`` and
+    Matches the public catalog visibility rule: service must be
+    ``status='active'`` and
     ``visibility='public'``. The group itself must be in the
     customer-visible set (active + platform + non-empty).
 
@@ -233,9 +231,8 @@ async def asyncio_detailed(
     The group is addressable by id or name; both are returned in the
     group detail shape. Names stay valid across admin recreations of a
     group, so SDK scripts that use the name keep working.
-    Mirrors the visibility rule used by the GraphQL
-    ``resolve_group_services`` resolver for non-admin / non-seller
-    callers: service must be ``status='active'`` and
+    Matches the public catalog visibility rule: service must be
+    ``status='active'`` and
     ``visibility='public'``. The group itself must be in the
     customer-visible set (active + platform + non-empty).
 
@@ -297,9 +294,8 @@ async def asyncio(
     The group is addressable by id or name; both are returned in the
     group detail shape. Names stay valid across admin recreations of a
     group, so SDK scripts that use the name keep working.
-    Mirrors the visibility rule used by the GraphQL
-    ``resolve_group_services`` resolver for non-admin / non-seller
-    callers: service must be ``status='active'`` and
+    Matches the public catalog visibility rule: service must be
+    ``status='active'`` and
     ``visibility='public'``. The group itself must be in the
     customer-visible set (active + platform + non-empty).
 

{unitysvc_py-0.2.0 → unitysvc_py-0.2.1}/src/unitysvc/_generated/api/customer_services/customer_services_get_service.py

@@ -77,14 +77,11 @@ def sync_detailed(
 
      Get details of a single service in the public catalog.
 
-    Hot path: read from ``service_mview`` for active + public services.
-
-    Cold path: if the mview misses, fall back to a base-tables query
-    that matches ``status = 'deprecated' AND visibility = 'public'``.
-    This enables statement / invoice back-reference URLs to keep
-    rendering after a service has been deprecated (the service still
-    exists in the base tables; only the mview filters it out). See
-    unitysvc#1027.
+    Hot path: the active + public row. Cold path: the same query at
+    ``status = 'deprecated'``, so statement / invoice back-reference URLs
+    keep rendering after a service has been deprecated — see unitysvc#1027,
+    which added the fallback back when ``service_mview`` was the hot path
+    and excluded deprecated rows. Both paths read the base tables now.
 
     Returns 404 for non-public services, or for statuses other than
     ``active`` / ``deprecated`` — the visible set is intentionally
@@ -96,6 +93,13 @@ def sync_detailed(
     caller sees exactly what an authenticated customer sees — caller
     identity was never used for scoping here.
 
+    Cacheable, but only with revalidation: ``no-cache`` plus an ``ETag``.
+    The catalog row fetches this on expand for the full description
+    (unitysvc#2632), so a browser or the edge may keep a copy, but every
+    reuse comes back here and re-runs the live visibility gate, so a service
+    made private or suspended stops being served at once (#1952). An
+    unchanged service costs a 304, not the body.
+
     Args:
         service_id (UUID):
         authorization (None | str | Unset):
@@ -133,14 +137,11 @@ def sync(
 
      Get details of a single service in the public catalog.
 
-    Hot path: read from ``service_mview`` for active + public services.
-
-    Cold path: if the mview misses, fall back to a base-tables query
-    that matches ``status = 'deprecated' AND visibility = 'public'``.
-    This enables statement / invoice back-reference URLs to keep
-    rendering after a service has been deprecated (the service still
-    exists in the base tables; only the mview filters it out). See
-    unitysvc#1027.
+    Hot path: the active + public row. Cold path: the same query at
+    ``status = 'deprecated'``, so statement / invoice back-reference URLs
+    keep rendering after a service has been deprecated — see unitysvc#1027,
+    which added the fallback back when ``service_mview`` was the hot path
+    and excluded deprecated rows. Both paths read the base tables now.
 
     Returns 404 for non-public services, or for statuses other than
     ``active`` / ``deprecated`` — the visible set is intentionally
@@ -152,6 +153,13 @@ def sync(
     caller sees exactly what an authenticated customer sees — caller
     identity was never used for scoping here.
 
+    Cacheable, but only with revalidation: ``no-cache`` plus an ``ETag``.
+    The catalog row fetches this on expand for the full description
+    (unitysvc#2632), so a browser or the edge may keep a copy, but every
+    reuse comes back here and re-runs the live visibility gate, so a service
+    made private or suspended stops being served at once (#1952). An
+    unchanged service costs a 304, not the body.
+
     Args:
         service_id (UUID):
         authorization (None | str | Unset):
@@ -184,14 +192,11 @@ async def asyncio_detailed(
 
      Get details of a single service in the public catalog.
 
-    Hot path: read from ``service_mview`` for active + public services.
-
-    Cold path: if the mview misses, fall back to a base-tables query
-    that matches ``status = 'deprecated' AND visibility = 'public'``.
-    This enables statement / invoice back-reference URLs to keep
-    rendering after a service has been deprecated (the service still
-    exists in the base tables; only the mview filters it out). See
-    unitysvc#1027.
+    Hot path: the active + public row. Cold path: the same query at
+    ``status = 'deprecated'``, so statement / invoice back-reference URLs
+    keep rendering after a service has been deprecated — see unitysvc#1027,
+    which added the fallback back when ``service_mview`` was the hot path
+    and excluded deprecated rows. Both paths read the base tables now.
 
     Returns 404 for non-public services, or for statuses other than
     ``active`` / ``deprecated`` — the visible set is intentionally
@@ -203,6 +208,13 @@ async def asyncio_detailed(
     caller sees exactly what an authenticated customer sees — caller
     identity was never used for scoping here.
 
+    Cacheable, but only with revalidation: ``no-cache`` plus an ``ETag``.
+    The catalog row fetches this on expand for the full description
+    (unitysvc#2632), so a browser or the edge may keep a copy, but every
+    reuse comes back here and re-runs the live visibility gate, so a service
+    made private or suspended stops being served at once (#1952). An
+    unchanged service costs a 304, not the body.
+
     Args:
         service_id (UUID):
         authorization (None | str | Unset):
@@ -238,14 +250,11 @@ async def asyncio(
 
      Get details of a single service in the public catalog.
 
-    Hot path: read from ``service_mview`` for active + public services.
-
-    Cold path: if the mview misses, fall back to a base-tables query
-    that matches ``status = 'deprecated' AND visibility = 'public'``.
-    This enables statement / invoice back-reference URLs to keep
-    rendering after a service has been deprecated (the service still
-    exists in the base tables; only the mview filters it out). See
-    unitysvc#1027.
+    Hot path: the active + public row. Cold path: the same query at
+    ``status = 'deprecated'``, so statement / invoice back-reference URLs
+    keep rendering after a service has been deprecated — see unitysvc#1027,
+    which added the fallback back when ``service_mview`` was the hot path
+    and excluded deprecated rows. Both paths read the base tables now.
 
     Returns 404 for non-public services, or for statuses other than
     ``active`` / ``deprecated`` — the visible set is intentionally
@@ -257,6 +266,13 @@ async def asyncio(
     caller sees exactly what an authenticated customer sees — caller
     identity was never used for scoping here.
 
+    Cacheable, but only with revalidation: ``no-cache`` plus an ``ETag``.
+    The catalog row fetches this on expand for the full description
+    (unitysvc#2632), so a browser or the edge may keep a copy, but every
+    reuse comes back here and re-runs the live visibility gate, so a service
+    made private or suspended stops being served at once (#1952). An
+    unchanged service costs a 304, not the body.
+
     Args:
         service_id (UUID):
         authorization (None | str | Unset):

unitysvc_py-0.2.1/src/unitysvc/_generated/api/preferences/__init__.py

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