capo-workspaces-thin-client 0.1.0__py3-none-any.whl

capo_workspaces_thin_client/_iter.py

@@ -0,0 +1,113 @@
+"""Iterator helpers used by generated streaming operations.
+
+Hand-written, not regenerated.
+"""
+
+from __future__ import annotations
+
+from collections.abc import AsyncIterable, AsyncIterator, Callable, Iterable, Iterator
+from typing import Generic, TypeVar, cast
+
+T = TypeVar("T")
+U = TypeVar("U")
+
+
+class AnyIterator(AsyncIterator[T], Iterator[T], Generic[T]):
+    """A type that is both a synchronous and asynchronous iterator.
+
+    Streaming output fields use this so the same TypedDict type works for
+    both sync and async operation variants.
+    """
+
+    ...
+
+
+class StaticAnyIterator(AnyIterator[T], Generic[T]):
+    """An :class:`AnyIterator` backed by static, in-memory content.
+
+    Used when streaming output is produced from already-materialized bytes
+    rather than a live stream. The ``content`` is yielded once and remains
+    accessible as a public attribute.
+    """
+
+    def __init__(self, content: T) -> None:
+        self.content = content
+        self._consumed = False
+
+    def __next__(self) -> T:
+        if self._consumed:
+            raise StopIteration
+        self._consumed = True
+        return self.content
+
+    async def __anext__(self) -> T:
+        if self._consumed:
+            raise StopAsyncIteration
+        self._consumed = True
+        return self.content
+
+
+def map_sync_iterator(iterable: Iterable[T], fn: Callable[[T], U]) -> Iterator[U]:
+    """Map ``fn`` over a synchronous iterable, yielding results lazily."""
+    for item in iterable:
+        yield fn(item)
+
+
+async def map_async_iterator(
+    async_iterable: AsyncIterable[T], fn: Callable[[T], U]
+) -> AsyncIterator[U]:
+    """Map ``fn`` over an asynchronous iterable, yielding results lazily."""
+    async for item in async_iterable:
+        yield fn(item)
+
+
+def chain_sync_iterator(*iterables: Iterable[T]) -> Iterator[T]:
+    """Yield items from each iterable in order."""
+    for iterable in iterables:
+        yield from iterable
+
+
+async def chain_async_iterator(
+    prefix: Iterable[T], rest: AsyncIterable[T]
+) -> AsyncIterator[T]:
+    """Yield the synchronous ``prefix`` items, then the async ``rest`` items."""
+    for item in prefix:
+        yield item
+    async for item in rest:
+        yield item
+
+
+def ensure_async_iterator(value: AsyncIterator[T] | T) -> AnyIterator[T]:
+    """Return ``value`` as an :class:`AnyIterator`.
+
+    An async iterator is returned unchanged; a single value is wrapped in a
+    fresh single-item async iterator.
+    """
+    if isinstance(value, AsyncIterator):
+        return cast(AnyIterator[T], value)
+
+    return StaticAnyIterator(value)
+
+
+def ensure_sync_iterator(value: Iterator[T] | T) -> AnyIterator[T]:
+    """Return ``value`` as an :class:`AnyIterator`.
+
+    A sync iterator is returned unchanged; a single value is wrapped in a
+    fresh single-item sync iterator.
+    """
+    if isinstance(value, Iterator):
+        return cast(AnyIterator[T], value)
+
+    return StaticAnyIterator(value)
+
+
+__all__ = [
+    "AnyIterator",
+    "StaticAnyIterator",
+    "chain_async_iterator",
+    "chain_sync_iterator",
+    "ensure_async_iterator",
+    "ensure_sync_iterator",
+    "map_async_iterator",
+    "map_sync_iterator",
+]

capo_workspaces_thin_client/_operations/thin_client/create_environment.py

@@ -0,0 +1,189 @@
+"""Generated from Smithy shape ``com.amazonaws.workspacesthinclient#CreateEnvironment``."""
+
+from __future__ import annotations
+
+import json
+from typing import Any
+
+import zapros
+from typing_extensions import Never
+
+import capo_workspaces_thin_client._auth._signers
+import capo_workspaces_thin_client._auth._sigv4
+import capo_workspaces_thin_client._protocol.eventstream
+import capo_workspaces_thin_client.errors.access_denied_exception
+import capo_workspaces_thin_client.errors.conflict_exception
+import capo_workspaces_thin_client.errors.internal_server_exception
+import capo_workspaces_thin_client.errors.resource_not_found_exception
+import capo_workspaces_thin_client.errors.service_quota_exceeded_exception
+import capo_workspaces_thin_client.errors.throttling_exception
+import capo_workspaces_thin_client.errors.validation_exception
+import capo_workspaces_thin_client.types.create_environment_request
+import capo_workspaces_thin_client.types.create_environment_response
+import capo_workspaces_thin_client.types.device_creation_tags_map
+import capo_workspaces_thin_client.types.environment_summary
+import capo_workspaces_thin_client.types.maintenance_window
+import capo_workspaces_thin_client.types.software_set_update_mode
+import capo_workspaces_thin_client.types.software_set_update_schedule
+import capo_workspaces_thin_client.types.tags_map
+from capo_workspaces_thin_client._protocol.errors import parse_error_metadata_json
+from capo_workspaces_thin_client._rule_engine._endpoint_rule_set import (
+    EndpointParams,
+    resolve,
+)
+from capo_workspaces_thin_client._services._pipeline import (
+    AsyncOperationOptions,
+    OperationOptions,
+)
+from capo_workspaces_thin_client.errors import UnknownServiceError
+
+
+def handle_error(response: zapros.Response) -> Never:
+    data = json.loads(response.read())
+    code, message = parse_error_metadata_json(response, data)
+    match code:
+        case "AccessDeniedException":
+            raise capo_workspaces_thin_client.errors.access_denied_exception.AccessDeniedException.from_json(
+                data, message
+            )
+        case "ConflictException":
+            raise capo_workspaces_thin_client.errors.conflict_exception.ConflictException.from_json(
+                data, message
+            )
+        case "InternalServerException":
+            raise capo_workspaces_thin_client.errors.internal_server_exception.InternalServerException.from_json(
+                data, message
+            )
+        case "ResourceNotFoundException":
+            raise capo_workspaces_thin_client.errors.resource_not_found_exception.ResourceNotFoundException.from_json(
+                data, message
+            )
+        case "ServiceQuotaExceededException":
+            raise capo_workspaces_thin_client.errors.service_quota_exceeded_exception.ServiceQuotaExceededException.from_json(
+                data, message
+            )
+        case "ThrottlingException":
+            raise capo_workspaces_thin_client.errors.throttling_exception.ThrottlingException.from_json(
+                data, message
+            )
+        case "ValidationException":
+            raise capo_workspaces_thin_client.errors.validation_exception.ValidationException.from_json(
+                data, message
+            )
+        case _:
+            raise UnknownServiceError(code=code, message=message, response=response)
+
+
+def handle_response(
+    response: zapros.Response,
+) -> capo_workspaces_thin_client.types.create_environment_response.CreateEnvironmentResponse:
+    out: capo_workspaces_thin_client.types.create_environment_response.CreateEnvironmentResponse = capo_workspaces_thin_client.types.create_environment_response.deserialize_json(
+        json.loads(response.read())
+    )
+    return out
+
+
+async def async_handle_response(
+    response: zapros.Response,
+) -> capo_workspaces_thin_client.types.create_environment_response.CreateEnvironmentResponse:
+    out: capo_workspaces_thin_client.types.create_environment_response.CreateEnvironmentResponse = capo_workspaces_thin_client.types.create_environment_response.deserialize_json(
+        json.loads(await response.aread())
+    )
+    return out
+
+
+def get_signer(
+    options: AsyncOperationOptions | OperationOptions,
+    auth_schemes: list[dict[str, Any]] | None = None,
+) -> capo_workspaces_thin_client._auth._signers.Signer | None:
+    name_to_schema = {s["name"]: s for s in (auth_schemes or [])}  # noqa: F841
+    if (
+        options.credentials_provider is not None
+        and name_to_schema
+        and not name_to_schema.keys() & {"sigv4", "sigv4-s3express"}
+    ):
+        raise RuntimeError(
+            "Endpoint requires an unsupported auth scheme: " + ", ".join(name_to_schema)
+        )
+    if options.credentials_provider is not None:
+        endpoint_scheme = name_to_schema.get("sigv4") or name_to_schema.get(
+            "sigv4-s3express"
+        )
+        if endpoint_scheme is not None or not name_to_schema:
+            sigv4_config = (
+                capo_workspaces_thin_client._auth._sigv4.build_sigv4_auth_scheme(
+                    "thinclient", options.region, endpoint_scheme
+                )
+            )
+            if sigv4_config is not None:
+                return capo_workspaces_thin_client._auth._signers.SigV4Signer(
+                    options.credentials_provider, auth_scheme=sigv4_config
+                )
+    raise RuntimeError("Auth was not resolved")
+
+
+def build_request(
+    options: OperationOptions | AsyncOperationOptions,
+    input_: capo_workspaces_thin_client.types.create_environment_request.CreateEnvironmentRequest,
+) -> zapros.Request:
+    endpoint = resolve(
+        EndpointParams(
+            Region=options.region,
+            UseDualStack=options.use_dual_stack,
+            UseFIPS=options.use_fips,
+            Endpoint=options.endpoint,
+        )
+    )  # noqa: F841
+    url = endpoint.url.rstrip("/") + "/environments"
+    params: list[tuple[str, str]] = []
+    headers: dict[str, str] = {k: ", ".join(v) for k, v in endpoint.headers.items()}
+    body: bytes | None = json.dumps(
+        capo_workspaces_thin_client.types.create_environment_request.serialize_json(
+            input_
+        ),
+        allow_nan=False,
+    ).encode()
+    headers["content-type"] = "application/json"
+    signer = get_signer(options, auth_schemes=endpoint.properties.get("authSchemes"))
+    normalized_url = zapros.URL(url)
+    for k, v in params:
+        normalized_url.search_params.append(k, v)
+    return zapros.Request(
+        normalized_url, "POST", headers=headers, body=body, context={"signer": signer}
+    )
+
+
+def create_environment(
+    options: OperationOptions,
+    input_: capo_workspaces_thin_client.types.create_environment_request.CreateEnvironmentRequest,
+) -> tuple[
+    capo_workspaces_thin_client.types.create_environment_response.CreateEnvironmentResponse,
+    zapros.Response,
+]:
+    response = options.client.handler.handle(build_request(options, input_))
+    try:
+        if response.status >= 300:
+            response.read()
+            handle_error(response)
+        return handle_response(response), response
+    except BaseException:
+        response.close()
+        raise
+
+
+async def async_create_environment(
+    options: AsyncOperationOptions,
+    input_: capo_workspaces_thin_client.types.create_environment_request.CreateEnvironmentRequest,
+) -> tuple[
+    capo_workspaces_thin_client.types.create_environment_response.CreateEnvironmentResponse,
+    zapros.Response,
+]:
+    response = await options.client.handler.ahandle(build_request(options, input_))
+    try:
+        if response.status >= 300:
+            await response.aread()
+            handle_error(response)
+        return await async_handle_response(response), response
+    except BaseException:
+        await response.aclose()
+        raise

capo_workspaces_thin_client/_operations/thin_client/delete_device.py

@@ -0,0 +1,172 @@
+"""Generated from Smithy shape ``com.amazonaws.workspacesthinclient#DeleteDevice``."""
+
+from __future__ import annotations
+
+import json
+from typing import Any
+from urllib.parse import quote
+
+import zapros
+from typing_extensions import Never
+
+import capo_workspaces_thin_client._auth._signers
+import capo_workspaces_thin_client._auth._sigv4
+import capo_workspaces_thin_client._protocol.eventstream
+import capo_workspaces_thin_client.errors.access_denied_exception
+import capo_workspaces_thin_client.errors.conflict_exception
+import capo_workspaces_thin_client.errors.internal_server_exception
+import capo_workspaces_thin_client.errors.resource_not_found_exception
+import capo_workspaces_thin_client.errors.throttling_exception
+import capo_workspaces_thin_client.errors.validation_exception
+import capo_workspaces_thin_client.types.delete_device_request
+import capo_workspaces_thin_client.types.delete_device_response
+from capo_workspaces_thin_client._protocol.errors import parse_error_metadata_json
+from capo_workspaces_thin_client._rule_engine._endpoint_rule_set import (
+    EndpointParams,
+    resolve,
+)
+from capo_workspaces_thin_client._services._pipeline import (
+    AsyncOperationOptions,
+    OperationOptions,
+)
+from capo_workspaces_thin_client.errors import UnknownServiceError
+
+
+def handle_error(response: zapros.Response) -> Never:
+    data = json.loads(response.read())
+    code, message = parse_error_metadata_json(response, data)
+    match code:
+        case "AccessDeniedException":
+            raise capo_workspaces_thin_client.errors.access_denied_exception.AccessDeniedException.from_json(
+                data, message
+            )
+        case "ConflictException":
+            raise capo_workspaces_thin_client.errors.conflict_exception.ConflictException.from_json(
+                data, message
+            )
+        case "InternalServerException":
+            raise capo_workspaces_thin_client.errors.internal_server_exception.InternalServerException.from_json(
+                data, message
+            )
+        case "ResourceNotFoundException":
+            raise capo_workspaces_thin_client.errors.resource_not_found_exception.ResourceNotFoundException.from_json(
+                data, message
+            )
+        case "ThrottlingException":
+            raise capo_workspaces_thin_client.errors.throttling_exception.ThrottlingException.from_json(
+                data, message
+            )
+        case "ValidationException":
+            raise capo_workspaces_thin_client.errors.validation_exception.ValidationException.from_json(
+                data, message
+            )
+        case _:
+            raise UnknownServiceError(code=code, message=message, response=response)
+
+
+def handle_response(
+    response: zapros.Response,
+) -> capo_workspaces_thin_client.types.delete_device_response.DeleteDeviceResponse:
+    out: capo_workspaces_thin_client.types.delete_device_response.DeleteDeviceResponse = {}  # type: ignore[typeddict-item]
+    return out
+
+
+async def async_handle_response(
+    response: zapros.Response,
+) -> capo_workspaces_thin_client.types.delete_device_response.DeleteDeviceResponse:
+    out: capo_workspaces_thin_client.types.delete_device_response.DeleteDeviceResponse = {}  # type: ignore[typeddict-item]
+    return out
+
+
+def get_signer(
+    options: AsyncOperationOptions | OperationOptions,
+    auth_schemes: list[dict[str, Any]] | None = None,
+) -> capo_workspaces_thin_client._auth._signers.Signer | None:
+    name_to_schema = {s["name"]: s for s in (auth_schemes or [])}  # noqa: F841
+    if (
+        options.credentials_provider is not None
+        and name_to_schema
+        and not name_to_schema.keys() & {"sigv4", "sigv4-s3express"}
+    ):
+        raise RuntimeError(
+            "Endpoint requires an unsupported auth scheme: " + ", ".join(name_to_schema)
+        )
+    if options.credentials_provider is not None:
+        endpoint_scheme = name_to_schema.get("sigv4") or name_to_schema.get(
+            "sigv4-s3express"
+        )
+        if endpoint_scheme is not None or not name_to_schema:
+            sigv4_config = (
+                capo_workspaces_thin_client._auth._sigv4.build_sigv4_auth_scheme(
+                    "thinclient", options.region, endpoint_scheme
+                )
+            )
+            if sigv4_config is not None:
+                return capo_workspaces_thin_client._auth._signers.SigV4Signer(
+                    options.credentials_provider, auth_scheme=sigv4_config
+                )
+    raise RuntimeError("Auth was not resolved")
+
+
+def build_request(
+    options: OperationOptions | AsyncOperationOptions,
+    input_: capo_workspaces_thin_client.types.delete_device_request.DeleteDeviceRequest,
+) -> zapros.Request:
+    endpoint = resolve(
+        EndpointParams(
+            Region=options.region,
+            UseDualStack=options.use_dual_stack,
+            UseFIPS=options.use_fips,
+            Endpoint=options.endpoint,
+        )
+    )  # noqa: F841
+    url = endpoint.url.rstrip("/") + "/devices/{id}"
+    url = url.replace("{id}", quote(input_["id"], safe=""))
+    params: list[tuple[str, str]] = []
+    if "client_token" in input_:
+        params.append(("clientToken", input_["client_token"]))
+    headers: dict[str, str] = {k: ", ".join(v) for k, v in endpoint.headers.items()}
+    body: bytes | None = b""
+    signer = get_signer(options, auth_schemes=endpoint.properties.get("authSchemes"))
+    normalized_url = zapros.URL(url)
+    for k, v in params:
+        normalized_url.search_params.append(k, v)
+    return zapros.Request(
+        normalized_url, "DELETE", headers=headers, body=body, context={"signer": signer}
+    )
+
+
+def delete_device(
+    options: OperationOptions,
+    input_: capo_workspaces_thin_client.types.delete_device_request.DeleteDeviceRequest,
+) -> tuple[
+    capo_workspaces_thin_client.types.delete_device_response.DeleteDeviceResponse,
+    zapros.Response,
+]:
+    response = options.client.handler.handle(build_request(options, input_))
+    try:
+        if response.status >= 300:
+            response.read()
+            handle_error(response)
+        return handle_response(response), response
+    except BaseException:
+        response.close()
+        raise
+
+
+async def async_delete_device(
+    options: AsyncOperationOptions,
+    input_: capo_workspaces_thin_client.types.delete_device_request.DeleteDeviceRequest,
+) -> tuple[
+    capo_workspaces_thin_client.types.delete_device_response.DeleteDeviceResponse,
+    zapros.Response,
+]:
+    response = await options.client.handler.ahandle(build_request(options, input_))
+    try:
+        if response.status >= 300:
+            await response.aread()
+            handle_error(response)
+        return await async_handle_response(response), response
+    except BaseException:
+        await response.aclose()
+        raise

capo_workspaces_thin_client/_operations/thin_client/delete_environment.py

@@ -0,0 +1,172 @@
+"""Generated from Smithy shape ``com.amazonaws.workspacesthinclient#DeleteEnvironment``."""
+
+from __future__ import annotations
+
+import json
+from typing import Any
+from urllib.parse import quote
+
+import zapros
+from typing_extensions import Never
+
+import capo_workspaces_thin_client._auth._signers
+import capo_workspaces_thin_client._auth._sigv4
+import capo_workspaces_thin_client._protocol.eventstream
+import capo_workspaces_thin_client.errors.access_denied_exception
+import capo_workspaces_thin_client.errors.conflict_exception
+import capo_workspaces_thin_client.errors.internal_server_exception
+import capo_workspaces_thin_client.errors.resource_not_found_exception
+import capo_workspaces_thin_client.errors.throttling_exception
+import capo_workspaces_thin_client.errors.validation_exception
+import capo_workspaces_thin_client.types.delete_environment_request
+import capo_workspaces_thin_client.types.delete_environment_response
+from capo_workspaces_thin_client._protocol.errors import parse_error_metadata_json
+from capo_workspaces_thin_client._rule_engine._endpoint_rule_set import (
+    EndpointParams,
+    resolve,
+)
+from capo_workspaces_thin_client._services._pipeline import (
+    AsyncOperationOptions,
+    OperationOptions,
+)
+from capo_workspaces_thin_client.errors import UnknownServiceError
+
+
+def handle_error(response: zapros.Response) -> Never:
+    data = json.loads(response.read())
+    code, message = parse_error_metadata_json(response, data)
+    match code:
+        case "AccessDeniedException":
+            raise capo_workspaces_thin_client.errors.access_denied_exception.AccessDeniedException.from_json(
+                data, message
+            )
+        case "ConflictException":
+            raise capo_workspaces_thin_client.errors.conflict_exception.ConflictException.from_json(
+                data, message
+            )
+        case "InternalServerException":
+            raise capo_workspaces_thin_client.errors.internal_server_exception.InternalServerException.from_json(
+                data, message
+            )
+        case "ResourceNotFoundException":
+            raise capo_workspaces_thin_client.errors.resource_not_found_exception.ResourceNotFoundException.from_json(
+                data, message
+            )
+        case "ThrottlingException":
+            raise capo_workspaces_thin_client.errors.throttling_exception.ThrottlingException.from_json(
+                data, message
+            )
+        case "ValidationException":
+            raise capo_workspaces_thin_client.errors.validation_exception.ValidationException.from_json(
+                data, message
+            )
+        case _:
+            raise UnknownServiceError(code=code, message=message, response=response)
+
+
+def handle_response(
+    response: zapros.Response,
+) -> capo_workspaces_thin_client.types.delete_environment_response.DeleteEnvironmentResponse:
+    out: capo_workspaces_thin_client.types.delete_environment_response.DeleteEnvironmentResponse = {}  # type: ignore[typeddict-item]
+    return out
+
+
+async def async_handle_response(
+    response: zapros.Response,
+) -> capo_workspaces_thin_client.types.delete_environment_response.DeleteEnvironmentResponse:
+    out: capo_workspaces_thin_client.types.delete_environment_response.DeleteEnvironmentResponse = {}  # type: ignore[typeddict-item]
+    return out
+
+
+def get_signer(
+    options: AsyncOperationOptions | OperationOptions,
+    auth_schemes: list[dict[str, Any]] | None = None,
+) -> capo_workspaces_thin_client._auth._signers.Signer | None:
+    name_to_schema = {s["name"]: s for s in (auth_schemes or [])}  # noqa: F841
+    if (
+        options.credentials_provider is not None
+        and name_to_schema
+        and not name_to_schema.keys() & {"sigv4", "sigv4-s3express"}
+    ):
+        raise RuntimeError(
+            "Endpoint requires an unsupported auth scheme: " + ", ".join(name_to_schema)
+        )
+    if options.credentials_provider is not None:
+        endpoint_scheme = name_to_schema.get("sigv4") or name_to_schema.get(
+            "sigv4-s3express"
+        )
+        if endpoint_scheme is not None or not name_to_schema:
+            sigv4_config = (
+                capo_workspaces_thin_client._auth._sigv4.build_sigv4_auth_scheme(
+                    "thinclient", options.region, endpoint_scheme
+                )
+            )
+            if sigv4_config is not None:
+                return capo_workspaces_thin_client._auth._signers.SigV4Signer(
+                    options.credentials_provider, auth_scheme=sigv4_config
+                )
+    raise RuntimeError("Auth was not resolved")
+
+
+def build_request(
+    options: OperationOptions | AsyncOperationOptions,
+    input_: capo_workspaces_thin_client.types.delete_environment_request.DeleteEnvironmentRequest,
+) -> zapros.Request:
+    endpoint = resolve(
+        EndpointParams(
+            Region=options.region,
+            UseDualStack=options.use_dual_stack,
+            UseFIPS=options.use_fips,
+            Endpoint=options.endpoint,
+        )
+    )  # noqa: F841
+    url = endpoint.url.rstrip("/") + "/environments/{id}"
+    url = url.replace("{id}", quote(input_["id"], safe=""))
+    params: list[tuple[str, str]] = []
+    if "client_token" in input_:
+        params.append(("clientToken", input_["client_token"]))
+    headers: dict[str, str] = {k: ", ".join(v) for k, v in endpoint.headers.items()}
+    body: bytes | None = b""
+    signer = get_signer(options, auth_schemes=endpoint.properties.get("authSchemes"))
+    normalized_url = zapros.URL(url)
+    for k, v in params:
+        normalized_url.search_params.append(k, v)
+    return zapros.Request(
+        normalized_url, "DELETE", headers=headers, body=body, context={"signer": signer}
+    )
+
+
+def delete_environment(
+    options: OperationOptions,
+    input_: capo_workspaces_thin_client.types.delete_environment_request.DeleteEnvironmentRequest,
+) -> tuple[
+    capo_workspaces_thin_client.types.delete_environment_response.DeleteEnvironmentResponse,
+    zapros.Response,
+]:
+    response = options.client.handler.handle(build_request(options, input_))
+    try:
+        if response.status >= 300:
+            response.read()
+            handle_error(response)
+        return handle_response(response), response
+    except BaseException:
+        response.close()
+        raise
+
+
+async def async_delete_environment(
+    options: AsyncOperationOptions,
+    input_: capo_workspaces_thin_client.types.delete_environment_request.DeleteEnvironmentRequest,
+) -> tuple[
+    capo_workspaces_thin_client.types.delete_environment_response.DeleteEnvironmentResponse,
+    zapros.Response,
+]:
+    response = await options.client.handler.ahandle(build_request(options, input_))
+    try:
+        if response.status >= 300:
+            await response.aread()
+            handle_error(response)
+        return await async_handle_response(response), response
+    except BaseException:
+        await response.aclose()
+        raise