capo-lambda 0.20.0__tar.gz → 0.21.0__tar.gz

capo_lambda-0.21.0/PKG-INFO

@@ -0,0 +1,147 @@
+Metadata-Version: 2.4
+Name: capo-lambda
+Version: 0.21.0
+Summary: Python SDK for AWS Lambda.
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: jmespath>=1.0
+Requires-Dist: zapros>=0.21.0
+Provides-Extra: anyio
+Requires-Dist: anyio>=3.0; extra == "anyio"
+Provides-Extra: sso
+Requires-Dist: capo-sso>=0.2.0; extra == "sso"
+Requires-Dist: capo-sso-oidc>=0.2.0; extra == "sso"
+Requires-Dist: capo-sts>=0.3.0; extra == "sso"
+Dynamic: license-file
+
+# Getting Started
+
+## Installation
+
+```
+pip install capo-lambda
+```
+
+## Usage
+
+```python
+from capo_lambda import AsyncLambdaClient
+
+
+async def main():
+    async with AsyncLambdaClient() as lambda_:
+        # Example: call the delete_function operation
+        response = await lambda_.delete_function()
+        print(response["status_code"])
+```
+
+## Pagination
+
+Some operations in this SDK support pagination. If the operation supports pagination it will have an `iter_` prefixed method that returns an async iterator.
+
+```python
+from capo_lambda import AsyncLambdaClient
+
+
+async def main():
+    async with AsyncLambdaClient() as lambda_:
+        # Example: paginate over list_capacity_providers
+        async for item in lambda_.iter_list_capacity_providers():
+            print(item)
+```
+
+## Streaming Request
+
+Some operations accept a streaming request body. Pass an async iterator of `bytes` chunks, or the whole body as `bytes`, for the streaming parameter.
+
+A plain iterator can be sent only once, so if a request fails after its body was transmitted the operation is not retried. To get retries for streamed uploads, pass a `Body` instead: it wraps a source that can be reopened, and every attempt streams a fresh copy. `Body.from_path` (sync client) and `Body.async_from_path` (async client, needs `anyio`) stream a file from disk; `Body(opener)` takes any context manager that yields a `(stream, length)` pair.
+
+```python
+from capo_lambda import AsyncLambdaClient, Body
+
+
+async def main():
+    async with AsyncLambdaClient() as lambda_:
+        # Example: call invoke_async with a streaming request body
+        async def chunks():
+            yield b'Hello, World!'
+
+        response = await lambda_.invoke_async(invoke_args=chunks())
+        print(response)
+
+        # Or pass the whole body as bytes
+        response = await lambda_.invoke_async(invoke_args=b'Hello, World!')
+        print(response)
+
+        # Or stream a file with Body: the file is reopened on every retry
+        # and Content-Length is taken from its size, so no content_length needed
+        response = await lambda_.invoke_async(invoke_args=Body.async_from_path("hello.txt"))
+        print(response)
+```
+
+## Waiters
+
+Waiters poll an operation until a resource reaches a desired state. If the operation supports waiters it will have a `wait_until_` prefixed method.
+
+```python
+from capo_lambda import AsyncLambdaClient
+
+
+async def main():
+    async with AsyncLambdaClient() as lambda_:
+        # Example: wait for function_exists
+        await lambda_.wait_until_function_exists(max_wait_time=300)
+```
+
+## Error Handling
+
+The SDK raises exceptions for errors returned by the API. Catch them to handle failures gracefully.
+
+```python
+from capo_lambda import AsyncLambdaClient
+from capo_lambda.error import InvalidParameterValueException
+
+
+async def main():
+    async with AsyncLambdaClient() as lambda_:
+        try:
+            await lambda_.delete_function()
+        except InvalidParameterValueException as e:
+            print(f"Error: {e}")
+            print(e.data)  # additional error data
+```
+
+## Retrying
+
+The SDK retries failed operations automatically. Retry behaviour follows the Smithy specification: errors are retried based on their `is_retryable` and `is_throttling_error` attributes. Throttling errors use a longer base delay. Network-level failures (connection errors and timeouts) are also retried. Non-retryable errors, such as client errors without the `@retryable` trait, are raised immediately without further attempts.
+
+The number of attempts defaults to 3 and can be changed at the client level via `retry_max_attempts`, or per call via `config_overrides`.
+
+```python
+from capo_lambda import AsyncLambdaClient
+
+
+async def main():
+    async with AsyncLambdaClient() as lambda_:
+        # Default: 3 attempts for every operation
+        response = await lambda_.delete_function()
+
+        # Override per operation
+        response = await lambda_.delete_function(config_overrides={"retry_max_attempts": 5})
+
+        # Disable retries for this call
+        response = await lambda_.delete_function(config_overrides={"retry_max_attempts": 1})
+```

capo_lambda-0.21.0/pyproject.toml

@@ -0,0 +1,63 @@
+[project]
+name = "capo-lambda"
+version = "0.21.0"
+description = "Python SDK for AWS Lambda."
+readme = "README.md"
+requires-python = ">=3.10"
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development :: Code Generators",
+    "Typing :: Typed",
+]
+dependencies = [
+    "jmespath>=1.0",
+    "zapros>=0.21.0",
+]
+
+[project.optional-dependencies]
+# Async file request bodies via Body.async_from_path
+anyio = ["anyio>=3.0"]
+# IAM Identity Center (SSO), assume-role and web-identity credentials providers
+sso = [
+    "capo-sso>=0.2.0",
+    "capo-sso-oidc>=0.2.0",
+    "capo-sts>=0.3.0",
+]
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = ["tests"]
+
+[tool.ty.environment]
+python-version = "3.14"
+root = ["./src"]
+
+[tool.ty.src]
+include = ["src", "tests"]
+
+[tool.ty.rules]
+missing-typed-dict-key = "ignore"
+unused-type-ignore-comment = "ignore"
+
+[tool.ruff.lint]
+select = ["E", "F", "I"]
+ignore = ["E501", "E741"]
+
+[dependency-groups]
+dev = [
+    "inline-snapshot>=0.33.0",
+    # TODO: fix for 0.0.69
+    "ty==0.0.68",
+    "pytest>=9.0.3",
+    "ruff>=0.15.14",
+    "trio",
+]

capo_lambda-0.21.0/src/capo_lambda/_aws.py

@@ -0,0 +1,28 @@
+"""Error codes and HTTP statuses that are retried whether or not the model marks them @retryable."""
+
+# Transient: retried with the normal backoff.
+KNOWN_RETRYABLE_STATUSES = frozenset({500, 502, 503, 504})
+KNOWN_RETRYABLE_CODES = frozenset(
+    {"PriorRequestNotComplete", "RequestTimeout", "RequestTimeoutException"}
+)
+
+# Throttling: retried with the longer throttling backoff.
+KNOWN_THROTTLING_STATUSES = frozenset({429})
+KNOWN_THROTTLING_CODES = frozenset(
+    {
+        "BandwidthLimitExceeded",
+        "EC2ThrottledException",
+        "LimitExceededException",
+        "PriorRequestNotComplete",
+        "ProvisionedThroughputExceededException",
+        "RequestLimitExceeded",
+        "RequestThrottled",
+        "RequestThrottledException",
+        "SlowDown",
+        "ThrottledException",
+        "Throttling",
+        "ThrottlingException",
+        "TooManyRequestsException",
+        "TransactionInProgressException",
+    }
+)

capo_lambda-0.21.0/src/capo_lambda/_operations/aws_gir_api_service/add_layer_version_permission.py

@@ -0,0 +1,189 @@
+"""Generated from Smithy shape ``com.amazonaws.lambda#AddLayerVersionPermission``."""
+
+from __future__ import annotations
+
+import json
+from typing import Any
+from urllib.parse import quote
+
+import zapros
+from typing_extensions import Never
+
+import capo_lambda._auth._signers
+import capo_lambda._auth._sigv4
+import capo_lambda._protocol.eventstream
+import capo_lambda.errors.invalid_parameter_value_exception
+import capo_lambda.errors.policy_length_exceeded_exception
+import capo_lambda.errors.precondition_failed_exception
+import capo_lambda.errors.resource_conflict_exception
+import capo_lambda.errors.resource_not_found_exception
+import capo_lambda.errors.service_exception
+import capo_lambda.errors.too_many_requests_exception
+import capo_lambda.types.add_layer_version_permission_request
+import capo_lambda.types.add_layer_version_permission_response
+from capo_lambda._protocol.errors import parse_error_metadata_json
+from capo_lambda._rule_engine._endpoint_rule_set import EndpointParams, resolve
+from capo_lambda._services._pipeline import (
+    AsyncOperationOptions,
+    OperationOptions,
+    raise_error,
+)
+from capo_lambda.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 "InvalidParameterValueException":
+            raise capo_lambda.errors.invalid_parameter_value_exception.InvalidParameterValueException.from_json(
+                data, message, response=response
+            )
+        case "PolicyLengthExceededException":
+            raise capo_lambda.errors.policy_length_exceeded_exception.PolicyLengthExceededException.from_json(
+                data, message, response=response
+            )
+        case "PreconditionFailedException":
+            raise capo_lambda.errors.precondition_failed_exception.PreconditionFailedException.from_json(
+                data, message, response=response
+            )
+        case "ResourceConflictException":
+            raise capo_lambda.errors.resource_conflict_exception.ResourceConflictException.from_json(
+                data, message, response=response
+            )
+        case "ResourceNotFoundException":
+            raise capo_lambda.errors.resource_not_found_exception.ResourceNotFoundException.from_json(
+                data, message, response=response
+            )
+        case "ServiceException":
+            raise capo_lambda.errors.service_exception.ServiceException.from_json(
+                data, message, response=response
+            )
+        case "TooManyRequestsException":
+            raise capo_lambda.errors.too_many_requests_exception.TooManyRequestsException.from_json(
+                data, message, response=response
+            )
+        case _:
+            raise UnknownServiceError(code=code, message=message, response=response)
+
+
+def handle_response(
+    response: zapros.Response,
+) -> capo_lambda.types.add_layer_version_permission_response.AddLayerVersionPermissionResponse:
+    out: capo_lambda.types.add_layer_version_permission_response.AddLayerVersionPermissionResponse = capo_lambda.types.add_layer_version_permission_response.deserialize_json(
+        json.loads(response.read())
+    )
+    return out
+
+
+async def async_handle_response(
+    response: zapros.Response,
+) -> capo_lambda.types.add_layer_version_permission_response.AddLayerVersionPermissionResponse:
+    out: capo_lambda.types.add_layer_version_permission_response.AddLayerVersionPermissionResponse = capo_lambda.types.add_layer_version_permission_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_lambda._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_lambda._auth._sigv4.build_sigv4_auth_scheme(
+                "lambda", options.region, endpoint_scheme
+            )
+            if sigv4_config is not None:
+                return capo_lambda._auth._signers.SigV4Signer(
+                    options.credentials_provider, auth_scheme=sigv4_config
+                )
+    raise RuntimeError("Auth was not resolved")
+
+
+def build_request(
+    options: OperationOptions | AsyncOperationOptions,
+    input_: capo_lambda.types.add_layer_version_permission_request.AddLayerVersionPermissionRequest,
+) -> 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("/")
+        + "/2018-10-31/layers/{LayerName}/versions/{VersionNumber}/policy"
+    )
+    url = url.replace("{LayerName}", quote(input_["layer_name"], safe=""))
+    url = url.replace("{VersionNumber}", quote(str(input_["version_number"]), safe=""))
+    params: list[tuple[str, str]] = []
+    if "revision_id" in input_:
+        params.append(("RevisionId", input_["revision_id"]))
+    headers: dict[str, str] = {k: ", ".join(v) for k, v in endpoint.headers.items()}
+    body: bytes | None = json.dumps(
+        capo_lambda.types.add_layer_version_permission_request.serialize_json(input_),
+        allow_nan=False,
+    ).encode()
+    headers["content-type"] = "application/json"
+    signer = (
+        None
+        if options.anonymous
+        else 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 add_layer_version_permission(
+    options: OperationOptions,
+    input_: capo_lambda.types.add_layer_version_permission_request.AddLayerVersionPermissionRequest,
+) -> tuple[
+    capo_lambda.types.add_layer_version_permission_response.AddLayerVersionPermissionResponse,
+    zapros.Response,
+]:
+    response = options.client.handler.handle(build_request(options, input_))
+    try:
+        if response.status >= 300:
+            response.read()
+            raise_error(response, handle_error)
+        return handle_response(response), response
+    except BaseException:
+        response.close()
+        raise
+
+
+async def async_add_layer_version_permission(
+    options: AsyncOperationOptions,
+    input_: capo_lambda.types.add_layer_version_permission_request.AddLayerVersionPermissionRequest,
+) -> tuple[
+    capo_lambda.types.add_layer_version_permission_response.AddLayerVersionPermissionResponse,
+    zapros.Response,
+]:
+    response = await options.client.handler.ahandle(build_request(options, input_))
+    try:
+        if response.status >= 300:
+            await response.aread()
+            raise_error(response, handle_error)
+        return await async_handle_response(response), response
+    except BaseException:
+        await response.aclose()
+        raise

capo_lambda-0.21.0/src/capo_lambda/_operations/aws_gir_api_service/add_permission.py

@@ -0,0 +1,192 @@
+"""Generated from Smithy shape ``com.amazonaws.lambda#AddPermission``."""
+
+from __future__ import annotations
+
+import json
+from typing import Any
+from urllib.parse import quote
+
+import zapros
+from typing_extensions import Never
+
+import capo_lambda._auth._signers
+import capo_lambda._auth._sigv4
+import capo_lambda._protocol.eventstream
+import capo_lambda.errors.invalid_parameter_value_exception
+import capo_lambda.errors.policy_length_exceeded_exception
+import capo_lambda.errors.precondition_failed_exception
+import capo_lambda.errors.public_policy_exception
+import capo_lambda.errors.resource_conflict_exception
+import capo_lambda.errors.resource_not_found_exception
+import capo_lambda.errors.service_exception
+import capo_lambda.errors.too_many_requests_exception
+import capo_lambda.types.add_permission_request
+import capo_lambda.types.add_permission_response
+import capo_lambda.types.function_url_auth_type
+from capo_lambda._protocol.errors import parse_error_metadata_json
+from capo_lambda._rule_engine._endpoint_rule_set import EndpointParams, resolve
+from capo_lambda._services._pipeline import (
+    AsyncOperationOptions,
+    OperationOptions,
+    raise_error,
+)
+from capo_lambda.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 "InvalidParameterValueException":
+            raise capo_lambda.errors.invalid_parameter_value_exception.InvalidParameterValueException.from_json(
+                data, message, response=response
+            )
+        case "PolicyLengthExceededException":
+            raise capo_lambda.errors.policy_length_exceeded_exception.PolicyLengthExceededException.from_json(
+                data, message, response=response
+            )
+        case "PreconditionFailedException":
+            raise capo_lambda.errors.precondition_failed_exception.PreconditionFailedException.from_json(
+                data, message, response=response
+            )
+        case "PublicPolicyException":
+            raise capo_lambda.errors.public_policy_exception.PublicPolicyException.from_json(
+                data, message, response=response
+            )
+        case "ResourceConflictException":
+            raise capo_lambda.errors.resource_conflict_exception.ResourceConflictException.from_json(
+                data, message, response=response
+            )
+        case "ResourceNotFoundException":
+            raise capo_lambda.errors.resource_not_found_exception.ResourceNotFoundException.from_json(
+                data, message, response=response
+            )
+        case "ServiceException":
+            raise capo_lambda.errors.service_exception.ServiceException.from_json(
+                data, message, response=response
+            )
+        case "TooManyRequestsException":
+            raise capo_lambda.errors.too_many_requests_exception.TooManyRequestsException.from_json(
+                data, message, response=response
+            )
+        case _:
+            raise UnknownServiceError(code=code, message=message, response=response)
+
+
+def handle_response(
+    response: zapros.Response,
+) -> capo_lambda.types.add_permission_response.AddPermissionResponse:
+    out: capo_lambda.types.add_permission_response.AddPermissionResponse = (
+        capo_lambda.types.add_permission_response.deserialize_json(
+            json.loads(response.read())
+        )
+    )
+    return out
+
+
+async def async_handle_response(
+    response: zapros.Response,
+) -> capo_lambda.types.add_permission_response.AddPermissionResponse:
+    out: capo_lambda.types.add_permission_response.AddPermissionResponse = (
+        capo_lambda.types.add_permission_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_lambda._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_lambda._auth._sigv4.build_sigv4_auth_scheme(
+                "lambda", options.region, endpoint_scheme
+            )
+            if sigv4_config is not None:
+                return capo_lambda._auth._signers.SigV4Signer(
+                    options.credentials_provider, auth_scheme=sigv4_config
+                )
+    raise RuntimeError("Auth was not resolved")
+
+
+def build_request(
+    options: OperationOptions | AsyncOperationOptions,
+    input_: capo_lambda.types.add_permission_request.AddPermissionRequest,
+) -> 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("/") + "/2015-03-31/functions/{FunctionName}/policy"
+    url = url.replace("{FunctionName}", quote(input_["function_name"], safe=""))
+    params: list[tuple[str, str]] = []
+    if "qualifier" in input_:
+        params.append(("Qualifier", input_["qualifier"]))
+    headers: dict[str, str] = {k: ", ".join(v) for k, v in endpoint.headers.items()}
+    body: bytes | None = json.dumps(
+        capo_lambda.types.add_permission_request.serialize_json(input_), allow_nan=False
+    ).encode()
+    headers["content-type"] = "application/json"
+    signer = (
+        None
+        if options.anonymous
+        else 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 add_permission(
+    options: OperationOptions,
+    input_: capo_lambda.types.add_permission_request.AddPermissionRequest,
+) -> tuple[
+    capo_lambda.types.add_permission_response.AddPermissionResponse, zapros.Response
+]:
+    response = options.client.handler.handle(build_request(options, input_))
+    try:
+        if response.status >= 300:
+            response.read()
+            raise_error(response, handle_error)
+        return handle_response(response), response
+    except BaseException:
+        response.close()
+        raise
+
+
+async def async_add_permission(
+    options: AsyncOperationOptions,
+    input_: capo_lambda.types.add_permission_request.AddPermissionRequest,
+) -> tuple[
+    capo_lambda.types.add_permission_response.AddPermissionResponse, zapros.Response
+]:
+    response = await options.client.handler.ahandle(build_request(options, input_))
+    try:
+        if response.status >= 300:
+            await response.aread()
+            raise_error(response, handle_error)
+        return await async_handle_response(response), response
+    except BaseException:
+        await response.aclose()
+        raise