capo-lambda 0.12.0__tar.gz → 0.13.0__tar.gz

{capo_lambda-0.12.0/src/capo_lambda.egg-info → capo_lambda-0.13.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: capo-lambda
-Version: 0.12.0
+Version: 0.13.0
 Summary: Python SDK for AWS Lambda.
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
@@ -17,9 +17,8 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: jmespath>=1.0
 Requires-Dist: zapros>=0.13.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"
@@ -47,6 +46,57 @@ async def main():
         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.
+
+```python
+from capo_lambda import AsyncLambdaClient
+
+
+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)
+```
+
+## 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.

{capo_lambda-0.12.0 → capo_lambda-0.13.0}/README.md

@@ -19,6 +19,57 @@ async def main():
         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.
+
+```python
+from capo_lambda import AsyncLambdaClient
+
+
+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)
+```
+
+## 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.

{capo_lambda-0.12.0 → capo_lambda-0.13.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "capo-lambda"
-version = "0.12.0"
+version = "0.13.0"
 description = "Python SDK for AWS Lambda."
 readme = "README.md"
 requires-python = ">=3.10"
@@ -19,12 +19,11 @@ classifiers = [
     "Typing :: Typed",
 ]
 dependencies = [
+    "jmespath>=1.0",
     "zapros>=0.13.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_lambda-0.12.0 → capo_lambda-0.13.0}/src/capo_lambda/__init__.py

@@ -48,7 +48,6 @@ from ._auth._providers import (
 )
 from ._auth._signers import Signer as Signer
 from ._auth._signers import SigV4Signer as SigV4Signer
-from ._body import Body as Body
 from ._services._lambda import LambdaClient as LambdaClient
 from ._services._pipeline import (
     AsyncOperationOptions as AsyncOperationOptions,

{capo_lambda-0.12.0 → capo_lambda-0.13.0}/src/capo_lambda/_operations/aws_gir_api_service/invoke_async.py

@@ -3,7 +3,6 @@
 from __future__ import annotations
 
 import json
-from collections.abc import AsyncIterator, Iterator
 from typing import Any, cast
 from urllib.parse import quote
 
@@ -12,7 +11,6 @@ from typing_extensions import Never
 
 import capo_lambda._auth._signers
 import capo_lambda._auth._sigv4
-import capo_lambda._body
 import capo_lambda._protocol.eventstream
 import capo_lambda.errors.ec2_access_denied_exception
 import capo_lambda.errors.ec2_throttled_exception
@@ -237,60 +235,6 @@ def build_request(
     params: list[tuple[str, str]] = []
     headers: dict[str, str] = {k: ", ".join(v) for k, v in endpoint.headers.items()}
     body = input_["invoke_args"]
-    if isinstance(body, capo_lambda._body.Body):
-        body = cast(capo_lambda._body.Body[Iterator[bytes]], body)
-        stream = body.stream
-        if stream is None:
-            rebuilt = body.rebuild()
-            if rebuilt is None:
-                raise RuntimeError("streaming body could not be rebuilt")
-            stream, _ = rebuilt
-        if "content-length" not in [header.lower() for header in headers]:
-            headers["Content-Length"] = str(body.length)
-        body = stream
-    if isinstance(body, capo_lambda._iter.StaticAnyIterator):
-        body = cast(bytes, body.content)
-    if not isinstance(body, bytes) and "content-length" not in [
-        header.lower() for header in headers
-    ]:
-        raise ValueError("Content-Length is required for streaming input")
-    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}
-    )
-
-
-async def async_build_request(
-    options: OperationOptions | AsyncOperationOptions,
-    input_: capo_lambda.types.invoke_async_request.InvokeAsyncRequest,
-) -> 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("/") + "/2014-11-13/functions/{FunctionName}/invoke-async"
-    url = url.replace("{FunctionName}", quote(input_["function_name"], safe=""))
-    params: list[tuple[str, str]] = []
-    headers: dict[str, str] = {k: ", ".join(v) for k, v in endpoint.headers.items()}
-    body = input_["invoke_args"]
-    if isinstance(body, capo_lambda._body.Body):
-        body = cast(capo_lambda._body.Body[AsyncIterator[bytes]], body)
-        stream = body.stream
-        if stream is None:
-            rebuilt = await body.arebuild()
-            if rebuilt is None:
-                raise RuntimeError("streaming body could not be rebuilt")
-            stream, _ = rebuilt
-        if "content-length" not in [header.lower() for header in headers]:
-            headers["Content-Length"] = str(body.length)
-        body = stream
     if isinstance(body, capo_lambda._iter.StaticAnyIterator):
         body = cast(bytes, body.content)
     if not isinstance(body, bytes) and "content-length" not in [
@@ -329,9 +273,7 @@ async def async_invoke_async(
 ) -> tuple[
     capo_lambda.types.invoke_async_response.InvokeAsyncResponse, zapros.Response
 ]:
-    response = await options.client.handler.ahandle(
-        await async_build_request(options, input_)
-    )
+    response = await options.client.handler.ahandle(build_request(options, input_))
     try:
         if response.status >= 300:
             await response.aread()

{capo_lambda-0.12.0 → capo_lambda-0.13.0}/src/capo_lambda/_resources/aws_gir_api_service/function.py

@@ -6,7 +6,6 @@ from typing import TYPE_CHECKING, Optional
 
 import capo_lambda._auth._signers
 import capo_lambda._auth._sigv4
-from capo_lambda._body import Body, aclosing_bodies, closing_bodies
 from capo_lambda._iter import ensure_async_iterator, ensure_sync_iterator
 from capo_lambda._services._pipeline import (
     AsyncOperationRequest,
@@ -1593,7 +1592,7 @@ class Function:
     def invoke_async(
         self,
         function_name: "capo_lambda.types.namespaced_function_name.NamespacedFunctionName",
-        invoke_args: Body[Iterator[bytes]] | Iterator[bytes] | bytes,
+        invoke_args: Iterator[bytes] | bytes,
         *,
         config_overrides: Optional[LambdaClientConfig] = None,
     ) -> "capo_lambda.types.invoke_async_response.InvokeAsyncResponse":
@@ -1662,14 +1661,13 @@ class Function:
             "invoke_args": ensure_sync_iterator(invoke_args),
         }
 
-        with closing_bodies(input_):
-            response = execute_pipeline(
-                OperationRequest(input=input_, options=options_),
-                handler=_handler,
-                interceptors=list(interceptors_),
-            )
-            response.response.close()
-            return response.output
+        response = execute_pipeline(
+            OperationRequest(input=input_, options=options_),
+            handler=_handler,
+            interceptors=list(interceptors_),
+        )
+        response.response.close()
+        return response.output
 
     @contextmanager
     def invoke_with_response_stream(
@@ -3682,7 +3680,7 @@ class AsyncFunction:
     async def invoke_async(
         self,
         function_name: "capo_lambda.types.namespaced_function_name.NamespacedFunctionName",
-        invoke_args: Body[AsyncIterator[bytes]] | AsyncIterator[bytes] | bytes,
+        invoke_args: AsyncIterator[bytes] | bytes,
         *,
         config_overrides: Optional[AsyncLambdaClientConfig] = None,
     ) -> "capo_lambda.types.invoke_async_response.InvokeAsyncResponse":
@@ -3752,14 +3750,13 @@ class AsyncFunction:
             "invoke_args": ensure_async_iterator(invoke_args),
         }
 
-        async with aclosing_bodies(input_):
-            response = await aexecute_pipeline(
-                AsyncOperationRequest(input=input_, options=options_),
-                handler=_handler,
-                interceptors=list(interceptors_),
-            )
-            await response.response.aclose()
-            return response.output
+        response = await aexecute_pipeline(
+            AsyncOperationRequest(input=input_, options=options_),
+            handler=_handler,
+            interceptors=list(interceptors_),
+        )
+        await response.response.aclose()
+        return response.output
 
     @asynccontextmanager
     async def invoke_with_response_stream(