capo-workdocs 0.1.0__py3-none-any.whl

capo_workdocs/_operations/aws_gorilla_boy_service/describe_document_versions.py

@@ -0,0 +1,187 @@
+"""Generated from Smithy shape ``com.amazonaws.workdocs#DescribeDocumentVersions``."""
+
+from __future__ import annotations
+
+import json
+from typing import Any
+from urllib.parse import quote
+
+import zapros
+from typing_extensions import Never
+
+import capo_workdocs._auth._signers
+import capo_workdocs._auth._sigv4
+import capo_workdocs._protocol.eventstream
+import capo_workdocs.errors.entity_not_exists_exception
+import capo_workdocs.errors.failed_dependency_exception
+import capo_workdocs.errors.invalid_argument_exception
+import capo_workdocs.errors.invalid_password_exception
+import capo_workdocs.errors.prohibited_state_exception
+import capo_workdocs.errors.service_unavailable_exception
+import capo_workdocs.errors.unauthorized_operation_exception
+import capo_workdocs.errors.unauthorized_resource_access_exception
+import capo_workdocs.types.describe_document_versions_request
+import capo_workdocs.types.describe_document_versions_response
+import capo_workdocs.types.document_version_metadata_list
+from capo_workdocs._protocol.errors import parse_error_metadata_json
+from capo_workdocs._rule_engine._endpoint_rule_set import EndpointParams, resolve
+from capo_workdocs._services._pipeline import AsyncOperationOptions, OperationOptions
+from capo_workdocs.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 "EntityNotExistsException":
+            raise capo_workdocs.errors.entity_not_exists_exception.EntityNotExistsException.from_json(
+                data, message
+            )
+        case "FailedDependencyException":
+            raise capo_workdocs.errors.failed_dependency_exception.FailedDependencyException.from_json(
+                data, message
+            )
+        case "InvalidArgumentException":
+            raise capo_workdocs.errors.invalid_argument_exception.InvalidArgumentException.from_json(
+                data, message
+            )
+        case "InvalidPasswordException":
+            raise capo_workdocs.errors.invalid_password_exception.InvalidPasswordException.from_json(
+                data, message
+            )
+        case "ProhibitedStateException":
+            raise capo_workdocs.errors.prohibited_state_exception.ProhibitedStateException.from_json(
+                data, message
+            )
+        case "ServiceUnavailableException":
+            raise capo_workdocs.errors.service_unavailable_exception.ServiceUnavailableException.from_json(
+                data, message
+            )
+        case "UnauthorizedOperationException":
+            raise capo_workdocs.errors.unauthorized_operation_exception.UnauthorizedOperationException.from_json(
+                data, message
+            )
+        case "UnauthorizedResourceAccessException":
+            raise capo_workdocs.errors.unauthorized_resource_access_exception.UnauthorizedResourceAccessException.from_json(
+                data, message
+            )
+        case _:
+            raise UnknownServiceError(code=code, message=message, response=response)
+
+
+def handle_response(
+    response: zapros.Response,
+) -> capo_workdocs.types.describe_document_versions_response.DescribeDocumentVersionsResponse:
+    out: capo_workdocs.types.describe_document_versions_response.DescribeDocumentVersionsResponse = capo_workdocs.types.describe_document_versions_response.deserialize_json(
+        json.loads(response.read())
+    )
+    return out
+
+
+async def async_handle_response(
+    response: zapros.Response,
+) -> capo_workdocs.types.describe_document_versions_response.DescribeDocumentVersionsResponse:
+    out: capo_workdocs.types.describe_document_versions_response.DescribeDocumentVersionsResponse = capo_workdocs.types.describe_document_versions_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_workdocs._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_workdocs._auth._sigv4.build_sigv4_auth_scheme(
+                "workdocs", options.region, endpoint_scheme
+            )
+            if sigv4_config is not None:
+                return capo_workdocs._auth._signers.SigV4Signer(
+                    options.credentials_provider, auth_scheme=sigv4_config
+                )
+    raise RuntimeError("Auth was not resolved")
+
+
+def build_request(
+    options: OperationOptions | AsyncOperationOptions,
+    input_: capo_workdocs.types.describe_document_versions_request.DescribeDocumentVersionsRequest,
+) -> 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("/") + "/api/v1/documents/{DocumentId}/versions"
+    url = url.replace("{DocumentId}", quote(input_["document_id"], safe=""))
+    params: list[tuple[str, str]] = []
+    if "marker" in input_:
+        params.append(("marker", input_["marker"]))
+    if "limit" in input_:
+        params.append(("limit", str(input_["limit"])))
+    if "include" in input_:
+        params.append(("include", input_["include"]))
+    if "fields" in input_:
+        params.append(("fields", input_["fields"]))
+    headers: dict[str, str] = {k: ", ".join(v) for k, v in endpoint.headers.items()}
+    if "authentication_token" in input_:
+        headers["Authentication"] = input_["authentication_token"]
+    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, "GET", headers=headers, body=body, context={"signer": signer}
+    )
+
+
+def describe_document_versions(
+    options: OperationOptions,
+    input_: capo_workdocs.types.describe_document_versions_request.DescribeDocumentVersionsRequest,
+) -> tuple[
+    capo_workdocs.types.describe_document_versions_response.DescribeDocumentVersionsResponse,
+    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_describe_document_versions(
+    options: AsyncOperationOptions,
+    input_: capo_workdocs.types.describe_document_versions_request.DescribeDocumentVersionsRequest,
+) -> tuple[
+    capo_workdocs.types.describe_document_versions_response.DescribeDocumentVersionsResponse,
+    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_workdocs/_operations/aws_gorilla_boy_service/describe_folder_contents.py

@@ -0,0 +1,205 @@
+"""Generated from Smithy shape ``com.amazonaws.workdocs#DescribeFolderContents``."""
+
+from __future__ import annotations
+
+import json
+from typing import Any
+from urllib.parse import quote
+
+import zapros
+from typing_extensions import Never
+
+import capo_workdocs._auth._signers
+import capo_workdocs._auth._sigv4
+import capo_workdocs._protocol.eventstream
+import capo_workdocs.errors.entity_not_exists_exception
+import capo_workdocs.errors.failed_dependency_exception
+import capo_workdocs.errors.invalid_argument_exception
+import capo_workdocs.errors.prohibited_state_exception
+import capo_workdocs.errors.service_unavailable_exception
+import capo_workdocs.errors.unauthorized_resource_access_exception
+import capo_workdocs.types.describe_folder_contents_request
+import capo_workdocs.types.describe_folder_contents_response
+import capo_workdocs.types.document_metadata_list
+import capo_workdocs.types.folder_content_type
+import capo_workdocs.types.folder_metadata_list
+import capo_workdocs.types.order_type
+import capo_workdocs.types.resource_sort_type
+from capo_workdocs._protocol.errors import parse_error_metadata_json
+from capo_workdocs._rule_engine._endpoint_rule_set import EndpointParams, resolve
+from capo_workdocs._services._pipeline import AsyncOperationOptions, OperationOptions
+from capo_workdocs.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 "EntityNotExistsException":
+            raise capo_workdocs.errors.entity_not_exists_exception.EntityNotExistsException.from_json(
+                data, message
+            )
+        case "FailedDependencyException":
+            raise capo_workdocs.errors.failed_dependency_exception.FailedDependencyException.from_json(
+                data, message
+            )
+        case "InvalidArgumentException":
+            raise capo_workdocs.errors.invalid_argument_exception.InvalidArgumentException.from_json(
+                data, message
+            )
+        case "ProhibitedStateException":
+            raise capo_workdocs.errors.prohibited_state_exception.ProhibitedStateException.from_json(
+                data, message
+            )
+        case "ServiceUnavailableException":
+            raise capo_workdocs.errors.service_unavailable_exception.ServiceUnavailableException.from_json(
+                data, message
+            )
+        case "UnauthorizedResourceAccessException":
+            raise capo_workdocs.errors.unauthorized_resource_access_exception.UnauthorizedResourceAccessException.from_json(
+                data, message
+            )
+        case _:
+            raise UnknownServiceError(code=code, message=message, response=response)
+
+
+def handle_response(
+    response: zapros.Response,
+) -> (
+    capo_workdocs.types.describe_folder_contents_response.DescribeFolderContentsResponse
+):
+    out: capo_workdocs.types.describe_folder_contents_response.DescribeFolderContentsResponse = capo_workdocs.types.describe_folder_contents_response.deserialize_json(
+        json.loads(response.read())
+    )
+    return out
+
+
+async def async_handle_response(
+    response: zapros.Response,
+) -> (
+    capo_workdocs.types.describe_folder_contents_response.DescribeFolderContentsResponse
+):
+    out: capo_workdocs.types.describe_folder_contents_response.DescribeFolderContentsResponse = capo_workdocs.types.describe_folder_contents_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_workdocs._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_workdocs._auth._sigv4.build_sigv4_auth_scheme(
+                "workdocs", options.region, endpoint_scheme
+            )
+            if sigv4_config is not None:
+                return capo_workdocs._auth._signers.SigV4Signer(
+                    options.credentials_provider, auth_scheme=sigv4_config
+                )
+    raise RuntimeError("Auth was not resolved")
+
+
+def build_request(
+    options: OperationOptions | AsyncOperationOptions,
+    input_: capo_workdocs.types.describe_folder_contents_request.DescribeFolderContentsRequest,
+) -> zapros.Request:
+    endpoint = resolve(
+        EndpointParams(
+            Region=options.region,
+            UseDualStack=options.use_dual_stack,
+            UseFIPS=options.use_fips,
+            Endpoint=options.endpoint,
+        )
+    )  # noqa: F841
+    import capo_workdocs.types.folder_content_type
+    import capo_workdocs.types.order_type
+    import capo_workdocs.types.resource_sort_type
+
+    url = endpoint.url.rstrip("/") + "/api/v1/folders/{FolderId}/contents"
+    url = url.replace("{FolderId}", quote(input_["folder_id"], safe=""))
+    params: list[tuple[str, str]] = []
+    if "sort" in input_:
+        params.append(
+            (
+                "sort",
+                capo_workdocs.types.resource_sort_type.serialize_json(input_["sort"]),
+            )
+        )
+    if "order" in input_:
+        params.append(
+            ("order", capo_workdocs.types.order_type.serialize_json(input_["order"]))
+        )
+    if "limit" in input_:
+        params.append(("limit", str(input_["limit"])))
+    if "marker" in input_:
+        params.append(("marker", input_["marker"]))
+    if "type" in input_:
+        params.append(
+            (
+                "type",
+                capo_workdocs.types.folder_content_type.serialize_json(input_["type"]),
+            )
+        )
+    if "include" in input_:
+        params.append(("include", input_["include"]))
+    headers: dict[str, str] = {k: ", ".join(v) for k, v in endpoint.headers.items()}
+    if "authentication_token" in input_:
+        headers["Authentication"] = input_["authentication_token"]
+    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, "GET", headers=headers, body=body, context={"signer": signer}
+    )
+
+
+def describe_folder_contents(
+    options: OperationOptions,
+    input_: capo_workdocs.types.describe_folder_contents_request.DescribeFolderContentsRequest,
+) -> tuple[
+    capo_workdocs.types.describe_folder_contents_response.DescribeFolderContentsResponse,
+    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_describe_folder_contents(
+    options: AsyncOperationOptions,
+    input_: capo_workdocs.types.describe_folder_contents_request.DescribeFolderContentsRequest,
+) -> tuple[
+    capo_workdocs.types.describe_folder_contents_response.DescribeFolderContentsResponse,
+    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_workdocs/_operations/aws_gorilla_boy_service/describe_groups.py

@@ -0,0 +1,167 @@
+"""Generated from Smithy shape ``com.amazonaws.workdocs#DescribeGroups``."""
+
+from __future__ import annotations
+
+import json
+from typing import Any
+
+import zapros
+from typing_extensions import Never
+
+import capo_workdocs._auth._signers
+import capo_workdocs._auth._sigv4
+import capo_workdocs._protocol.eventstream
+import capo_workdocs.errors.failed_dependency_exception
+import capo_workdocs.errors.service_unavailable_exception
+import capo_workdocs.errors.unauthorized_operation_exception
+import capo_workdocs.errors.unauthorized_resource_access_exception
+import capo_workdocs.types.describe_groups_request
+import capo_workdocs.types.describe_groups_response
+import capo_workdocs.types.group_metadata_list
+from capo_workdocs._protocol.errors import parse_error_metadata_json
+from capo_workdocs._rule_engine._endpoint_rule_set import EndpointParams, resolve
+from capo_workdocs._services._pipeline import AsyncOperationOptions, OperationOptions
+from capo_workdocs.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 "FailedDependencyException":
+            raise capo_workdocs.errors.failed_dependency_exception.FailedDependencyException.from_json(
+                data, message
+            )
+        case "ServiceUnavailableException":
+            raise capo_workdocs.errors.service_unavailable_exception.ServiceUnavailableException.from_json(
+                data, message
+            )
+        case "UnauthorizedOperationException":
+            raise capo_workdocs.errors.unauthorized_operation_exception.UnauthorizedOperationException.from_json(
+                data, message
+            )
+        case "UnauthorizedResourceAccessException":
+            raise capo_workdocs.errors.unauthorized_resource_access_exception.UnauthorizedResourceAccessException.from_json(
+                data, message
+            )
+        case _:
+            raise UnknownServiceError(code=code, message=message, response=response)
+
+
+def handle_response(
+    response: zapros.Response,
+) -> capo_workdocs.types.describe_groups_response.DescribeGroupsResponse:
+    out: capo_workdocs.types.describe_groups_response.DescribeGroupsResponse = (
+        capo_workdocs.types.describe_groups_response.deserialize_json(
+            json.loads(response.read())
+        )
+    )
+    return out
+
+
+async def async_handle_response(
+    response: zapros.Response,
+) -> capo_workdocs.types.describe_groups_response.DescribeGroupsResponse:
+    out: capo_workdocs.types.describe_groups_response.DescribeGroupsResponse = (
+        capo_workdocs.types.describe_groups_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_workdocs._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_workdocs._auth._sigv4.build_sigv4_auth_scheme(
+                "workdocs", options.region, endpoint_scheme
+            )
+            if sigv4_config is not None:
+                return capo_workdocs._auth._signers.SigV4Signer(
+                    options.credentials_provider, auth_scheme=sigv4_config
+                )
+    raise RuntimeError("Auth was not resolved")
+
+
+def build_request(
+    options: OperationOptions | AsyncOperationOptions,
+    input_: capo_workdocs.types.describe_groups_request.DescribeGroupsRequest,
+) -> 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("/") + "/api/v1/groups"
+    params: list[tuple[str, str]] = []
+    if "search_query" in input_:
+        params.append(("searchQuery", input_["search_query"]))
+    if "organization_id" in input_:
+        params.append(("organizationId", input_["organization_id"]))
+    if "marker" in input_:
+        params.append(("marker", input_["marker"]))
+    if "limit" in input_:
+        params.append(("limit", str(input_["limit"])))
+    headers: dict[str, str] = {k: ", ".join(v) for k, v in endpoint.headers.items()}
+    if "authentication_token" in input_:
+        headers["Authentication"] = input_["authentication_token"]
+    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, "GET", headers=headers, body=body, context={"signer": signer}
+    )
+
+
+def describe_groups(
+    options: OperationOptions,
+    input_: capo_workdocs.types.describe_groups_request.DescribeGroupsRequest,
+) -> tuple[
+    capo_workdocs.types.describe_groups_response.DescribeGroupsResponse, 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_describe_groups(
+    options: AsyncOperationOptions,
+    input_: capo_workdocs.types.describe_groups_request.DescribeGroupsRequest,
+) -> tuple[
+    capo_workdocs.types.describe_groups_response.DescribeGroupsResponse, 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