capo-keyspacesstreams 0.7.0__tar.gz → 0.8.0__tar.gz

{capo_keyspacesstreams-0.7.0/src/capo_keyspacesstreams.egg-info → capo_keyspacesstreams-0.8.0}/PKG-INFO

@@ -1,7 +1,11 @@
 Metadata-Version: 2.4
 Name: capo-keyspacesstreams
-Version: 0.7.0
+Version: 0.8.0
 Summary: Python SDK for AWS Keyspacesstreams.
+Project-URL: Homepage, https://capo-sdk.dev/
+Project-URL: Documentation, https://capo-sdk.dev/services/keyspacesstreams/
+Project-URL: Repository, https://github.com/kap-sh/capo/tree/main/services/keyspacesstreams
+Project-URL: Changelog, https://github.com/kap-sh/capo/blob/main/services/keyspacesstreams/CHANGELOG.md
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -26,7 +30,11 @@ Requires-Dist: capo-sso-oidc>=0.2.0; extra == "sso"
 Requires-Dist: capo-sts>=0.3.0; extra == "sso"
 Dynamic: license-file
 
-# Getting Started
+# capo-keyspacesstreams: typed, async Python SDK for AWS Keyspacesstreams
+
+`capo-keyspacesstreams` is a typed Python SDK for AWS Keyspacesstreams. It has an async client, `AsyncKeyspacesStreamsClient`, for asyncio and trio, and a sync client, `KeyspacesStreamsClient`, with the same methods. Requests and responses are typed with TypedDicts, so your editor and type checker know every field.
+
+It is part of [capo](https://capo-sdk.dev/), a community-driven alternative to boto3 and aioboto3, built on its own HTTP stack instead of botocore and generated from the official AWS Smithy models. Documentation: [https://capo-sdk.dev/services/keyspacesstreams/](https://capo-sdk.dev/services/keyspacesstreams/)
 
 ## Installation
 

{capo_keyspacesstreams-0.7.0 → capo_keyspacesstreams-0.8.0}/README.md

@@ -1,4 +1,8 @@
-# Getting Started
+# capo-keyspacesstreams: typed, async Python SDK for AWS Keyspacesstreams
+
+`capo-keyspacesstreams` is a typed Python SDK for AWS Keyspacesstreams. It has an async client, `AsyncKeyspacesStreamsClient`, for asyncio and trio, and a sync client, `KeyspacesStreamsClient`, with the same methods. Requests and responses are typed with TypedDicts, so your editor and type checker know every field.
+
+It is part of [capo](https://capo-sdk.dev/), a community-driven alternative to boto3 and aioboto3, built on its own HTTP stack instead of botocore and generated from the official AWS Smithy models. Documentation: [https://capo-sdk.dev/services/keyspacesstreams/](https://capo-sdk.dev/services/keyspacesstreams/)
 
 ## Installation
 

{capo_keyspacesstreams-0.7.0 → capo_keyspacesstreams-0.8.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "capo-keyspacesstreams"
-version = "0.7.0"
+version = "0.8.0"
 description = "Python SDK for AWS Keyspacesstreams."
 readme = "README.md"
 requires-python = ">=3.10"
@@ -22,6 +22,12 @@ dependencies = [
     "zapros>=0.21.0",
 ]
 
+[project.urls]
+Homepage = "https://capo-sdk.dev/"
+Documentation = "https://capo-sdk.dev/services/keyspacesstreams/"
+Repository = "https://github.com/kap-sh/capo/tree/main/services/keyspacesstreams"
+Changelog = "https://github.com/kap-sh/capo/blob/main/services/keyspacesstreams/CHANGELOG.md"
+
 [project.optional-dependencies]
 # Async file request bodies via Body.async_from_path
 anyio = ["anyio>=3.0"]

{capo_keyspacesstreams-0.7.0 → capo_keyspacesstreams-0.8.0}/src/capo_keyspacesstreams/__init__.py

@@ -79,3 +79,9 @@ from ._services.async_keyspaces_streams import (
 from ._services.keyspaces_streams import (
     KeyspacesStreamsClient as KeyspacesStreamsClient,
 )
+from .types._unknown import (
+    UnknownEvent as UnknownEvent,
+)
+from .types._unknown import (
+    UnknownUnionMember as UnknownUnionMember,
+)

capo_keyspacesstreams-0.8.0/src/capo_keyspacesstreams/types/_unknown.py

@@ -0,0 +1,34 @@
+"""Stand-ins for union variants and events this client doesn't know about.
+
+A service may add a union member or an event after the client was generated.
+Smithy asks clients not to fail on those, so deserialization returns one of
+these instead of raising.
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+from .._protocol.eventstream import Message
+
+
+@dataclass(frozen=True)
+class UnknownUnionMember:
+    """A union variant the service sent that this client has no member for."""
+
+    name: str
+    """The variant's name on the wire."""
+
+
+@dataclass(frozen=True)
+class UnknownEvent:
+    """An event-stream event whose ``:event-type`` this client doesn't know."""
+
+    event_type: str
+    """The event's ``:event-type`` header."""
+
+    message: Message
+    """The raw message, headers and undecoded payload."""
+
+
+__all__ = ["UnknownEvent", "UnknownUnionMember"]

{capo_keyspacesstreams-0.7.0 → capo_keyspacesstreams-0.8.0}/src/capo_keyspacesstreams/types/get_records_input.py

@@ -4,8 +4,6 @@ from typing import TYPE_CHECKING
 
 from typing_extensions import NotRequired, TypedDict
 
-from capo_keyspacesstreams.errors import DeserializationError
-
 if TYPE_CHECKING:
     import capo_keyspacesstreams.types.shard_iterator
 
@@ -31,7 +29,7 @@ def deserialize_aws_json_1_0(data: dict) -> GetRecordsInput:
     if data.get("shardIterator") is not None:
         out["shard_iterator"] = data["shardIterator"]
     else:
-        raise DeserializationError("GetRecordsInput.shard_iterator required")
+        out["shard_iterator"] = ""
     if data.get("maxResults") is not None:
         out["max_results"] = data["maxResults"]
     return out

{capo_keyspacesstreams-0.7.0 → capo_keyspacesstreams-0.8.0}/src/capo_keyspacesstreams/types/get_shard_iterator_input.py

@@ -4,8 +4,6 @@ from typing import TYPE_CHECKING
 
 from typing_extensions import NotRequired, TypedDict
 
-from capo_keyspacesstreams.errors import DeserializationError
-
 if TYPE_CHECKING:
     import capo_keyspacesstreams.types.sequence_number
     import capo_keyspacesstreams.types.shard_id
@@ -50,11 +48,11 @@ def deserialize_aws_json_1_0(data: dict) -> GetShardIteratorInput:
     if data.get("streamArn") is not None:
         out["stream_arn"] = data["streamArn"]
     else:
-        raise DeserializationError("GetShardIteratorInput.stream_arn required")
+        out["stream_arn"] = ""
     if data.get("shardId") is not None:
         out["shard_id"] = data["shardId"]
     else:
-        raise DeserializationError("GetShardIteratorInput.shard_id required")
+        out["shard_id"] = ""
     if data.get("shardIteratorType") is not None:
         import capo_keyspacesstreams.types.shard_iterator_type
 
@@ -64,7 +62,11 @@ def deserialize_aws_json_1_0(data: dict) -> GetShardIteratorInput:
             )
         )
     else:
-        raise DeserializationError("GetShardIteratorInput.shard_iterator_type required")
+        import typing
+
+        out["shard_iterator_type"] = typing.cast(
+            "capo_keyspacesstreams.types.shard_iterator_type.ShardIteratorType", ""
+        )
     if data.get("sequenceNumber") is not None:
         out["sequence_number"] = data["sequenceNumber"]
     return out

{capo_keyspacesstreams-0.7.0 → capo_keyspacesstreams-0.8.0}/src/capo_keyspacesstreams/types/get_stream_input.py

@@ -4,8 +4,6 @@ from typing import TYPE_CHECKING
 
 from typing_extensions import NotRequired, TypedDict
 
-from capo_keyspacesstreams.errors import DeserializationError
-
 if TYPE_CHECKING:
     import capo_keyspacesstreams.types.shard_filter
     import capo_keyspacesstreams.types.shard_id_token
@@ -47,7 +45,7 @@ def deserialize_aws_json_1_0(data: dict) -> GetStreamInput:
     if data.get("streamArn") is not None:
         out["stream_arn"] = data["streamArn"]
     else:
-        raise DeserializationError("GetStreamInput.stream_arn required")
+        out["stream_arn"] = ""
     if data.get("maxResults") is not None:
         out["max_results"] = data["maxResults"]
     if data.get("shardFilter") is not None:

{capo_keyspacesstreams-0.7.0 → capo_keyspacesstreams-0.8.0}/src/capo_keyspacesstreams/types/get_stream_output.py

@@ -4,8 +4,6 @@ from typing import TYPE_CHECKING
 
 from typing_extensions import NotRequired, TypedDict
 
-from capo_keyspacesstreams.errors import DeserializationError
-
 if TYPE_CHECKING:
     import capo_keyspacesstreams.types.date
     import capo_keyspacesstreams.types.keyspace_name
@@ -86,11 +84,11 @@ def deserialize_aws_json_1_0(data: dict) -> GetStreamOutput:
     if data.get("streamArn") is not None:
         out["stream_arn"] = data["streamArn"]
     else:
-        raise DeserializationError("GetStreamOutput.stream_arn required")
+        out["stream_arn"] = ""
     if data.get("streamLabel") is not None:
         out["stream_label"] = data["streamLabel"]
     else:
-        raise DeserializationError("GetStreamOutput.stream_label required")
+        out["stream_label"] = ""
     if data.get("streamStatus") is not None:
         import capo_keyspacesstreams.types.stream_status
 
@@ -100,7 +98,11 @@ def deserialize_aws_json_1_0(data: dict) -> GetStreamOutput:
             )
         )
     else:
-        raise DeserializationError("GetStreamOutput.stream_status required")
+        import typing
+
+        out["stream_status"] = typing.cast(
+            "capo_keyspacesstreams.types.stream_status.StreamStatus", ""
+        )
     if data.get("streamViewType") is not None:
         import capo_keyspacesstreams.types.stream_view_type
 
@@ -110,7 +112,11 @@ def deserialize_aws_json_1_0(data: dict) -> GetStreamOutput:
             )
         )
     else:
-        raise DeserializationError("GetStreamOutput.stream_view_type required")
+        import typing
+
+        out["stream_view_type"] = typing.cast(
+            "capo_keyspacesstreams.types.stream_view_type.StreamViewType", ""
+        )
     if data.get("creationRequestDateTime") is not None:
         import capo_keyspacesstreams.types.date
 
@@ -120,17 +126,19 @@ def deserialize_aws_json_1_0(data: dict) -> GetStreamOutput:
             )
         )
     else:
-        raise DeserializationError(
-            "GetStreamOutput.creation_request_date_time required"
+        import datetime
+
+        out["creation_request_date_time"] = datetime.datetime.fromtimestamp(
+            0, tz=datetime.timezone.utc
         )
     if data.get("keyspaceName") is not None:
         out["keyspace_name"] = data["keyspaceName"]
     else:
-        raise DeserializationError("GetStreamOutput.keyspace_name required")
+        out["keyspace_name"] = ""
     if data.get("tableName") is not None:
         out["table_name"] = data["tableName"]
     else:
-        raise DeserializationError("GetStreamOutput.table_name required")
+        out["table_name"] = ""
     if data.get("shards") is not None:
         import capo_keyspacesstreams.types.shard_description_list
 

{capo_keyspacesstreams-0.7.0 → capo_keyspacesstreams-0.8.0}/src/capo_keyspacesstreams/types/keyspaces_cell_value.py

@@ -5,6 +5,7 @@ from typing import TYPE_CHECKING, TypeAlias
 from typing_extensions import TypedDict
 
 from capo_keyspacesstreams.errors import DeserializationError, SerializationError
+from capo_keyspacesstreams.types._unknown import UnknownUnionMember
 
 if TYPE_CHECKING:
     import capo_keyspacesstreams.types.keyspaces_cell_list
@@ -143,12 +144,17 @@ KeyspacesCellValue: TypeAlias = (
     | _KeyspacesCellValue_varcharT
     | _KeyspacesCellValue_varintT
     | _KeyspacesCellValue_udtT
+    | UnknownUnionMember
 )
 
 
 # --- awsJson1_0 ser/de ---
 def serialize_aws_json_1_0(value: KeyspacesCellValue) -> dict:
-    if "asciiT" in value:
+    if isinstance(value, UnknownUnionMember):
+        raise SerializationError(
+            f"KeyspacesCellValue: cannot serialize unknown variant {value.name!r}"
+        )
+    elif "asciiT" in value:
         return {"asciiT": value["asciiT"]}
     elif "bigintT" in value:
         return {"bigintT": value["bigintT"]}
@@ -330,4 +336,9 @@ def deserialize_aws_json_1_0(data: dict) -> KeyspacesCellValue:
             )
         }
     else:
+        name = next(
+            (k for k, v in data.items() if v is not None and k != "__type"), None
+        )
+        if name is not None:
+            return UnknownUnionMember(name)
         raise DeserializationError("KeyspacesCellValue: no recognized variant key")

{capo_keyspacesstreams-0.7.0 → capo_keyspacesstreams-0.8.0}/src/capo_keyspacesstreams/types/stream.py

@@ -4,8 +4,6 @@ from typing import TYPE_CHECKING
 
 from typing_extensions import TypedDict
 
-from capo_keyspacesstreams.errors import DeserializationError
-
 if TYPE_CHECKING:
     import capo_keyspacesstreams.types.keyspace_name
     import capo_keyspacesstreams.types.stream_arn
@@ -38,17 +36,17 @@ def deserialize_aws_json_1_0(data: dict) -> Stream:
     if data.get("streamArn") is not None:
         out["stream_arn"] = data["streamArn"]
     else:
-        raise DeserializationError("Stream.stream_arn required")
+        out["stream_arn"] = ""
     if data.get("keyspaceName") is not None:
         out["keyspace_name"] = data["keyspaceName"]
     else:
-        raise DeserializationError("Stream.keyspace_name required")
+        out["keyspace_name"] = ""
     if data.get("tableName") is not None:
         out["table_name"] = data["tableName"]
     else:
-        raise DeserializationError("Stream.table_name required")
+        out["table_name"] = ""
     if data.get("streamLabel") is not None:
         out["stream_label"] = data["streamLabel"]
     else:
-        raise DeserializationError("Stream.stream_label required")
+        out["stream_label"] = ""
     return out

{capo_keyspacesstreams-0.7.0 → capo_keyspacesstreams-0.8.0/src/capo_keyspacesstreams.egg-info}/PKG-INFO

@@ -1,7 +1,11 @@
 Metadata-Version: 2.4
 Name: capo-keyspacesstreams
-Version: 0.7.0
+Version: 0.8.0
 Summary: Python SDK for AWS Keyspacesstreams.
+Project-URL: Homepage, https://capo-sdk.dev/
+Project-URL: Documentation, https://capo-sdk.dev/services/keyspacesstreams/
+Project-URL: Repository, https://github.com/kap-sh/capo/tree/main/services/keyspacesstreams
+Project-URL: Changelog, https://github.com/kap-sh/capo/blob/main/services/keyspacesstreams/CHANGELOG.md
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -26,7 +30,11 @@ Requires-Dist: capo-sso-oidc>=0.2.0; extra == "sso"
 Requires-Dist: capo-sts>=0.3.0; extra == "sso"
 Dynamic: license-file
 
-# Getting Started
+# capo-keyspacesstreams: typed, async Python SDK for AWS Keyspacesstreams
+
+`capo-keyspacesstreams` is a typed Python SDK for AWS Keyspacesstreams. It has an async client, `AsyncKeyspacesStreamsClient`, for asyncio and trio, and a sync client, `KeyspacesStreamsClient`, with the same methods. Requests and responses are typed with TypedDicts, so your editor and type checker know every field.
+
+It is part of [capo](https://capo-sdk.dev/), a community-driven alternative to boto3 and aioboto3, built on its own HTTP stack instead of botocore and generated from the official AWS Smithy models. Documentation: [https://capo-sdk.dev/services/keyspacesstreams/](https://capo-sdk.dev/services/keyspacesstreams/)
 
 ## Installation
 

{capo_keyspacesstreams-0.7.0 → capo_keyspacesstreams-0.8.0}/src/capo_keyspacesstreams.egg-info/SOURCES.txt

@@ -42,6 +42,7 @@ src/capo_keyspacesstreams/errors/internal_server_exception.py
 src/capo_keyspacesstreams/errors/resource_not_found_exception.py
 src/capo_keyspacesstreams/errors/throttling_exception.py
 src/capo_keyspacesstreams/errors/validation_exception.py
+src/capo_keyspacesstreams/types/_unknown.py
 src/capo_keyspacesstreams/types/date.py
 src/capo_keyspacesstreams/types/get_records_input.py
 src/capo_keyspacesstreams/types/get_records_output.py