capo-lambda 0.6.0__tar.gz → 0.8.0__tar.gz

capo_lambda-0.8.0/PKG-INFO

@@ -0,0 +1,86 @@
+Metadata-Version: 2.4
+Name: capo-lambda
+Version: 0.8.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: zapros>=0.13.0
+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"])
+```
+
+## 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.8.0/README.md

@@ -0,0 +1,60 @@
+# 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"])
+```
+
+## 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.8.0/pyproject.toml

@@ -0,0 +1,60 @@
+[project]
+name = "capo-lambda"
+version = "0.8.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 = [
+    "zapros>=0.13.0",
+]
+
+[project.optional-dependencies]
+# 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.8.0/src/capo_lambda/_operations/aws_gir_api_service/add_layer_version_permission.py

@@ -0,0 +1,174 @@
+"""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
+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
+            )
+        case "PolicyLengthExceededException":
+            raise capo_lambda.errors.policy_length_exceeded_exception.PolicyLengthExceededException.from_json(
+                data, message
+            )
+        case "PreconditionFailedException":
+            raise capo_lambda.errors.precondition_failed_exception.PreconditionFailedException.from_json(
+                data, message
+            )
+        case "ResourceConflictException":
+            raise capo_lambda.errors.resource_conflict_exception.ResourceConflictException.from_json(
+                data, message
+            )
+        case "ResourceNotFoundException":
+            raise capo_lambda.errors.resource_not_found_exception.ResourceNotFoundException.from_json(
+                data, message
+            )
+        case "ServiceException":
+            raise capo_lambda.errors.service_exception.ServiceException.from_json(
+                data, message
+            )
+        case "TooManyRequestsException":
+            raise capo_lambda.errors.too_many_requests_exception.TooManyRequestsException.from_json(
+                data, message
+            )
+        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:
+        sigv4_config = (
+            name_to_schema.get("sigv4")
+            or name_to_schema.get("sigv4a")
+            or name_to_schema.get("sigv4-s3express")
+            or capo_lambda._auth._sigv4.build_sigv4_auth_scheme(
+                "lambda", options.region
+            )
+        )
+        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 = 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 >= 400:
+            response.read()
+            handle_error(response)
+        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 >= 400:
+            await response.aread()
+            handle_error(response)
+        return await async_handle_response(response), response
+    except BaseException:
+        await response.aclose()
+        raise

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

@@ -0,0 +1,177 @@
+"""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
+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
+            )
+        case "PolicyLengthExceededException":
+            raise capo_lambda.errors.policy_length_exceeded_exception.PolicyLengthExceededException.from_json(
+                data, message
+            )
+        case "PreconditionFailedException":
+            raise capo_lambda.errors.precondition_failed_exception.PreconditionFailedException.from_json(
+                data, message
+            )
+        case "PublicPolicyException":
+            raise capo_lambda.errors.public_policy_exception.PublicPolicyException.from_json(
+                data, message
+            )
+        case "ResourceConflictException":
+            raise capo_lambda.errors.resource_conflict_exception.ResourceConflictException.from_json(
+                data, message
+            )
+        case "ResourceNotFoundException":
+            raise capo_lambda.errors.resource_not_found_exception.ResourceNotFoundException.from_json(
+                data, message
+            )
+        case "ServiceException":
+            raise capo_lambda.errors.service_exception.ServiceException.from_json(
+                data, message
+            )
+        case "TooManyRequestsException":
+            raise capo_lambda.errors.too_many_requests_exception.TooManyRequestsException.from_json(
+                data, message
+            )
+        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:
+        sigv4_config = (
+            name_to_schema.get("sigv4")
+            or name_to_schema.get("sigv4a")
+            or name_to_schema.get("sigv4-s3express")
+            or capo_lambda._auth._sigv4.build_sigv4_auth_scheme(
+                "lambda", options.region
+            )
+        )
+        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 = 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 >= 400:
+            response.read()
+            handle_error(response)
+        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 >= 400:
+            await response.aread()
+            handle_error(response)
+        return await async_handle_response(response), response
+    except BaseException:
+        await response.aclose()
+        raise