capo-keyspacesstreams 0.1.0__py3-none-any.whl

capo_keyspacesstreams/errors/internal_server_exception.py

@@ -0,0 +1,47 @@
+"""Generated from Smithy shape ``com.amazonaws.keyspacesstreams#InternalServerException``."""
+
+from typing_extensions import NotRequired, TypedDict
+
+from capo_keyspacesstreams.errors import ServiceError
+
+
+class InternalServerException_(TypedDict, closed=True):
+    message: NotRequired["str"]
+    """<p>The service encountered an internal error. Try your request again.</p>"""
+
+
+# --- awsJson1_0 ser/de ---
+def serialize_aws_json_1_0(value: InternalServerException_) -> dict:
+    out: dict = {}
+    if "message" in value:
+        out["message"] = value["message"]
+    return out
+
+
+def deserialize_aws_json_1_0(data: dict) -> InternalServerException_:
+    out: InternalServerException_ = {}  # type: ignore[typeddict-item]
+    if data.get("message") is not None:
+        out["message"] = data["message"]
+    return out
+
+
+class InternalServerException(ServiceError):
+    """Modeled error for Smithy shape ``com.amazonaws.keyspacesstreams#InternalServerException``."""
+
+    code: str | None = "InternalServerException"
+
+    def __init__(self, data: InternalServerException_, message: str | None = None):
+        super().__init__(
+            "server",
+            is_throttling_error=False,
+            is_retryable=False,
+            code="InternalServerException",
+            message=message,
+        )
+        self.data = data
+
+    @classmethod
+    def from_aws_json_1_0(
+        cls, data: dict, message: str | None = None
+    ) -> "InternalServerException":
+        return cls(deserialize_aws_json_1_0(data), message)

capo_keyspacesstreams/errors/resource_not_found_exception.py

@@ -0,0 +1,47 @@
+"""Generated from Smithy shape ``com.amazonaws.keyspacesstreams#ResourceNotFoundException``."""
+
+from typing_extensions import NotRequired, TypedDict
+
+from capo_keyspacesstreams.errors import ServiceError
+
+
+class ResourceNotFoundException_(TypedDict, closed=True):
+    message: NotRequired["str"]
+    """<p>The requested resource wasn't found. Verify that the resource exists and try again.</p>"""
+
+
+# --- awsJson1_0 ser/de ---
+def serialize_aws_json_1_0(value: ResourceNotFoundException_) -> dict:
+    out: dict = {}
+    if "message" in value:
+        out["message"] = value["message"]
+    return out
+
+
+def deserialize_aws_json_1_0(data: dict) -> ResourceNotFoundException_:
+    out: ResourceNotFoundException_ = {}  # type: ignore[typeddict-item]
+    if data.get("message") is not None:
+        out["message"] = data["message"]
+    return out
+
+
+class ResourceNotFoundException(ServiceError):
+    """Modeled error for Smithy shape ``com.amazonaws.keyspacesstreams#ResourceNotFoundException``."""
+
+    code: str | None = "ResourceNotFoundException"
+
+    def __init__(self, data: ResourceNotFoundException_, message: str | None = None):
+        super().__init__(
+            "client",
+            is_throttling_error=False,
+            is_retryable=False,
+            code="ResourceNotFoundException",
+            message=message,
+        )
+        self.data = data
+
+    @classmethod
+    def from_aws_json_1_0(
+        cls, data: dict, message: str | None = None
+    ) -> "ResourceNotFoundException":
+        return cls(deserialize_aws_json_1_0(data), message)

capo_keyspacesstreams/errors/throttling_exception.py

@@ -0,0 +1,47 @@
+"""Generated from Smithy shape ``com.amazonaws.keyspacesstreams#ThrottlingException``."""
+
+from typing_extensions import NotRequired, TypedDict
+
+from capo_keyspacesstreams.errors import ServiceError
+
+
+class ThrottlingException_(TypedDict, closed=True):
+    message: NotRequired["str"]
+    """<p>The request was denied due to request throttling. Reduce the frequency of requests and try again.</p>"""
+
+
+# --- awsJson1_0 ser/de ---
+def serialize_aws_json_1_0(value: ThrottlingException_) -> dict:
+    out: dict = {}
+    if "message" in value:
+        out["message"] = value["message"]
+    return out
+
+
+def deserialize_aws_json_1_0(data: dict) -> ThrottlingException_:
+    out: ThrottlingException_ = {}  # type: ignore[typeddict-item]
+    if data.get("message") is not None:
+        out["message"] = data["message"]
+    return out
+
+
+class ThrottlingException(ServiceError):
+    """Modeled error for Smithy shape ``com.amazonaws.keyspacesstreams#ThrottlingException``."""
+
+    code: str | None = "ThrottlingException"
+
+    def __init__(self, data: ThrottlingException_, message: str | None = None):
+        super().__init__(
+            "client",
+            is_throttling_error=False,
+            is_retryable=False,
+            code="ThrottlingException",
+            message=message,
+        )
+        self.data = data
+
+    @classmethod
+    def from_aws_json_1_0(
+        cls, data: dict, message: str | None = None
+    ) -> "ThrottlingException":
+        return cls(deserialize_aws_json_1_0(data), message)

capo_keyspacesstreams/errors/validation_exception.py

@@ -0,0 +1,72 @@
+"""Generated from Smithy shape ``com.amazonaws.keyspacesstreams#ValidationException``."""
+
+from typing import TYPE_CHECKING
+
+from typing_extensions import NotRequired, TypedDict
+
+from capo_keyspacesstreams.errors import ServiceError
+
+if TYPE_CHECKING:
+    import capo_keyspacesstreams.types.validation_exception_type
+
+
+class ValidationException_(TypedDict, closed=True):
+    message: NotRequired["str"]
+    """<p>The input fails to satisfy the constraints specified by the service. Check the error details and modify your request.</p>"""
+    error_code: NotRequired[
+        "capo_keyspacesstreams.types.validation_exception_type.ValidationExceptionType"
+    ]
+    """<p>An error occurred validating your request. See the error message for details.</p>"""
+
+
+# --- awsJson1_0 ser/de ---
+def serialize_aws_json_1_0(value: ValidationException_) -> dict:
+    out: dict = {}
+    if "message" in value:
+        out["message"] = value["message"]
+    if "error_code" in value:
+        import capo_keyspacesstreams.types.validation_exception_type
+
+        out["errorCode"] = (
+            capo_keyspacesstreams.types.validation_exception_type.serialize_aws_json_1_0(
+                value["error_code"]
+            )
+        )
+    return out
+
+
+def deserialize_aws_json_1_0(data: dict) -> ValidationException_:
+    out: ValidationException_ = {}  # type: ignore[typeddict-item]
+    if data.get("message") is not None:
+        out["message"] = data["message"]
+    if data.get("errorCode") is not None:
+        import capo_keyspacesstreams.types.validation_exception_type
+
+        out["error_code"] = (
+            capo_keyspacesstreams.types.validation_exception_type.deserialize_aws_json_1_0(
+                data["errorCode"]
+            )
+        )
+    return out
+
+
+class ValidationException(ServiceError):
+    """Modeled error for Smithy shape ``com.amazonaws.keyspacesstreams#ValidationException``."""
+
+    code: str | None = "ValidationException"
+
+    def __init__(self, data: ValidationException_, message: str | None = None):
+        super().__init__(
+            "client",
+            is_throttling_error=False,
+            is_retryable=False,
+            code="ValidationException",
+            message=message,
+        )
+        self.data = data
+
+    @classmethod
+    def from_aws_json_1_0(
+        cls, data: dict, message: str | None = None
+    ) -> "ValidationException":
+        return cls(deserialize_aws_json_1_0(data), message)

capo_keyspacesstreams/types/_prelude/blob.py

@@ -0,0 +1,12 @@
+"""Generated from Smithy prelude shape ``smithy.api#Blob``."""
+
+import base64
+
+
+# --- awsJson1_0 ser/de ---
+def serialize_aws_json_1_0(value: bytes) -> str:
+    return base64.b64encode(value).decode("ascii")
+
+
+def deserialize_aws_json_1_0(data: str) -> bytes:
+    return base64.b64decode(data)

capo_keyspacesstreams/types/_prelude/timestamp.py

@@ -0,0 +1,17 @@
+"""Generated from Smithy prelude shape ``smithy.api#Timestamp``."""
+
+import datetime
+
+
+# --- awsJson1_0 ser/de ---
+def serialize_aws_json_1_0(value: datetime.datetime) -> float:
+    value = (
+        value.astimezone(datetime.timezone.utc)
+        if value.tzinfo
+        else value.replace(tzinfo=datetime.timezone.utc)
+    )
+    return value.timestamp()
+
+
+def deserialize_aws_json_1_0(data: float) -> datetime.datetime:
+    return datetime.datetime.fromtimestamp(float(data), tz=datetime.timezone.utc)

capo_keyspacesstreams/types/date.py

@@ -0,0 +1,20 @@
+"""Generated from Smithy shape ``com.amazonaws.keyspacesstreams#Date``."""
+
+import datetime
+from typing import TypeAlias
+
+Date: TypeAlias = datetime.datetime
+
+
+# --- awsJson1_0 ser/de ---
+def serialize_aws_json_1_0(value: Date) -> float:
+    value = (
+        value.astimezone(datetime.timezone.utc)
+        if value.tzinfo
+        else value.replace(tzinfo=datetime.timezone.utc)
+    )
+    return value.timestamp()
+
+
+def deserialize_aws_json_1_0(data: float) -> Date:
+    return datetime.datetime.fromtimestamp(float(data), tz=datetime.timezone.utc)

capo_keyspacesstreams/types/get_records_input.py

@@ -0,0 +1,37 @@
+"""Generated from Smithy shape ``com.amazonaws.keyspacesstreams#GetRecordsInput``."""
+
+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
+
+
+class GetRecordsInput(TypedDict, closed=True):
+    shard_iterator: "capo_keyspacesstreams.types.shard_iterator.ShardIterator"
+    """<p> The unique identifier of the shard iterator. A shard iterator specifies the position in the shard from which you want to start reading data records sequentially. You obtain this value by calling the <code>GetShardIterator </code> operation. Each shard iterator is valid for 15 minutes after creation. </p>"""
+    max_results: NotRequired["int"]
+    """<p> The maximum number of records to return in a single <code>GetRecords</code> request. The default value is 100. You can specify a limit between 1 and 1000, but the actual number returned might be less than the specified maximum if the size of the data for the returned records exceeds the internal size limit. </p>"""
+
+
+# --- awsJson1_0 ser/de ---
+def serialize_aws_json_1_0(value: GetRecordsInput) -> dict:
+    out: dict = {}
+    out["shardIterator"] = value["shard_iterator"]
+    if "max_results" in value:
+        out["maxResults"] = value["max_results"]
+    return out
+
+
+def deserialize_aws_json_1_0(data: dict) -> GetRecordsInput:
+    out: GetRecordsInput = {}  # type: ignore[typeddict-item]
+    if data.get("shardIterator") is not None:
+        out["shard_iterator"] = data["shardIterator"]
+    else:
+        raise DeserializationError("GetRecordsInput.shard_iterator required")
+    if data.get("maxResults") is not None:
+        out["max_results"] = data["maxResults"]
+    return out

capo_keyspacesstreams/types/get_records_output.py

@@ -0,0 +1,70 @@
+"""Generated from Smithy shape ``com.amazonaws.keyspacesstreams#GetRecordsOutput``."""
+
+from typing import TYPE_CHECKING
+
+from typing_extensions import NotRequired, TypedDict
+
+if TYPE_CHECKING:
+    import capo_keyspacesstreams.types.iterator_description
+    import capo_keyspacesstreams.types.record_list
+    import capo_keyspacesstreams.types.shard_iterator
+
+
+class GetRecordsOutput(TypedDict, closed=True):
+    change_records: NotRequired["capo_keyspacesstreams.types.record_list.RecordList"]
+    """<p> An array of change data records retrieved from the specified shard. Each record represents a single data modification (insert, update, or delete) to a row in the Amazon Keyspaces table. Records include the primary key columns and information about what data was modified. </p>"""
+    next_shard_iterator: NotRequired[
+        "capo_keyspacesstreams.types.shard_iterator.ShardIterator"
+    ]
+    """<p> The next position in the shard from which to start sequentially reading data records. If null, the shard has been closed and the requested iterator will not return any more data. </p>"""
+    iterator_description: NotRequired[
+        "capo_keyspacesstreams.types.iterator_description.IteratorDescription"
+    ]
+    """<p> Provides information about the current iterator at the time GetRecords request was processed by Keyspaces. </p>"""
+
+
+# --- awsJson1_0 ser/de ---
+def serialize_aws_json_1_0(value: GetRecordsOutput) -> dict:
+    out: dict = {}
+    if "change_records" in value:
+        import capo_keyspacesstreams.types.record_list
+
+        out["changeRecords"] = (
+            capo_keyspacesstreams.types.record_list.serialize_aws_json_1_0(
+                value["change_records"]
+            )
+        )
+    if "next_shard_iterator" in value:
+        out["nextShardIterator"] = value["next_shard_iterator"]
+    if "iterator_description" in value:
+        import capo_keyspacesstreams.types.iterator_description
+
+        out["iteratorDescription"] = (
+            capo_keyspacesstreams.types.iterator_description.serialize_aws_json_1_0(
+                value["iterator_description"]
+            )
+        )
+    return out
+
+
+def deserialize_aws_json_1_0(data: dict) -> GetRecordsOutput:
+    out: GetRecordsOutput = {}  # type: ignore[typeddict-item]
+    if data.get("changeRecords") is not None:
+        import capo_keyspacesstreams.types.record_list
+
+        out["change_records"] = (
+            capo_keyspacesstreams.types.record_list.deserialize_aws_json_1_0(
+                data["changeRecords"]
+            )
+        )
+    if data.get("nextShardIterator") is not None:
+        out["next_shard_iterator"] = data["nextShardIterator"]
+    if data.get("iteratorDescription") is not None:
+        import capo_keyspacesstreams.types.iterator_description
+
+        out["iterator_description"] = (
+            capo_keyspacesstreams.types.iterator_description.deserialize_aws_json_1_0(
+                data["iteratorDescription"]
+            )
+        )
+    return out

capo_keyspacesstreams/types/get_shard_iterator_input.py

@@ -0,0 +1,70 @@
+"""Generated from Smithy shape ``com.amazonaws.keyspacesstreams#GetShardIteratorInput``."""
+
+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
+    import capo_keyspacesstreams.types.shard_iterator_type
+    import capo_keyspacesstreams.types.stream_arn
+
+
+class GetShardIteratorInput(TypedDict, closed=True):
+    stream_arn: "capo_keyspacesstreams.types.stream_arn.StreamArn"
+    """<p> The Amazon Resource Name (ARN) of the stream for which to get the shard iterator. The ARN uniquely identifies the stream within Amazon Keyspaces. </p>"""
+    shard_id: "capo_keyspacesstreams.types.shard_id.ShardId"
+    """<p> The identifier of the shard within the stream. The shard ID uniquely identifies a subset of the stream's data records that you want to access. </p>"""
+    shard_iterator_type: (
+        "capo_keyspacesstreams.types.shard_iterator_type.ShardIteratorType"
+    )
+    """<p> Determines how the shard iterator is positioned. Must be one of the following: </p> <ul> <li> <p> <code>TRIM_HORIZON</code> - Start reading at the last untrimmed record in the shard, which is the oldest data record in the shard.</p> </li> <li> <p> <code>AT_SEQUENCE_NUMBER</code> - Start reading exactly from the specified sequence number.</p> </li> <li> <p> <code>AFTER_SEQUENCE_NUMBER</code> - Start reading right after the specified sequence number. </p> </li> <li> <p> <code>LATEST</code> - Start reading just after the most recent record in the shard, so that you always read the most recent data. </p> </li> </ul>"""
+    sequence_number: NotRequired[
+        "capo_keyspacesstreams.types.sequence_number.SequenceNumber"
+    ]
+    """<p> The sequence number of the data record in the shard from which to start reading. Required if <code>ShardIteratorType</code> is <code>AT_SEQUENCE_NUMBER</code> or <code>AFTER_SEQUENCE_NUMBER</code>. This parameter is ignored for other iterator types. </p>"""
+
+
+# --- awsJson1_0 ser/de ---
+def serialize_aws_json_1_0(value: GetShardIteratorInput) -> dict:
+    out: dict = {}
+    out["streamArn"] = value["stream_arn"]
+    out["shardId"] = value["shard_id"]
+    import capo_keyspacesstreams.types.shard_iterator_type
+
+    out["shardIteratorType"] = (
+        capo_keyspacesstreams.types.shard_iterator_type.serialize_aws_json_1_0(
+            value["shard_iterator_type"]
+        )
+    )
+    if "sequence_number" in value:
+        out["sequenceNumber"] = value["sequence_number"]
+    return out
+
+
+def deserialize_aws_json_1_0(data: dict) -> GetShardIteratorInput:
+    out: GetShardIteratorInput = {}  # type: ignore[typeddict-item]
+    if data.get("streamArn") is not None:
+        out["stream_arn"] = data["streamArn"]
+    else:
+        raise DeserializationError("GetShardIteratorInput.stream_arn required")
+    if data.get("shardId") is not None:
+        out["shard_id"] = data["shardId"]
+    else:
+        raise DeserializationError("GetShardIteratorInput.shard_id required")
+    if data.get("shardIteratorType") is not None:
+        import capo_keyspacesstreams.types.shard_iterator_type
+
+        out["shard_iterator_type"] = (
+            capo_keyspacesstreams.types.shard_iterator_type.deserialize_aws_json_1_0(
+                data["shardIteratorType"]
+            )
+        )
+    else:
+        raise DeserializationError("GetShardIteratorInput.shard_iterator_type required")
+    if data.get("sequenceNumber") is not None:
+        out["sequence_number"] = data["sequenceNumber"]
+    return out

capo_keyspacesstreams/types/get_shard_iterator_output.py

@@ -0,0 +1,30 @@
+"""Generated from Smithy shape ``com.amazonaws.keyspacesstreams#GetShardIteratorOutput``."""
+
+from typing import TYPE_CHECKING
+
+from typing_extensions import NotRequired, TypedDict
+
+if TYPE_CHECKING:
+    import capo_keyspacesstreams.types.shard_iterator
+
+
+class GetShardIteratorOutput(TypedDict, closed=True):
+    shard_iterator: NotRequired[
+        "capo_keyspacesstreams.types.shard_iterator.ShardIterator"
+    ]
+    """<p> The unique identifier for the shard iterator. This value is used in the <code>GetRecords</code> operation to retrieve data records from the specified shard. Each shard iterator expires 15 minutes after it is returned to the requester. </p>"""
+
+
+# --- awsJson1_0 ser/de ---
+def serialize_aws_json_1_0(value: GetShardIteratorOutput) -> dict:
+    out: dict = {}
+    if "shard_iterator" in value:
+        out["shardIterator"] = value["shard_iterator"]
+    return out
+
+
+def deserialize_aws_json_1_0(data: dict) -> GetShardIteratorOutput:
+    out: GetShardIteratorOutput = {}  # type: ignore[typeddict-item]
+    if data.get("shardIterator") is not None:
+        out["shard_iterator"] = data["shardIterator"]
+    return out

capo_keyspacesstreams/types/get_stream_input.py

@@ -0,0 +1,63 @@
+"""Generated from Smithy shape ``com.amazonaws.keyspacesstreams#GetStreamInput``."""
+
+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
+    import capo_keyspacesstreams.types.stream_arn
+
+
+class GetStreamInput(TypedDict, closed=True):
+    stream_arn: "capo_keyspacesstreams.types.stream_arn.StreamArn"
+    """<p> The Amazon Resource Name (ARN) of the stream for which detailed information is requested. This uniquely identifies the specific stream you want to get information about. </p>"""
+    max_results: NotRequired["int"]
+    """<p> The maximum number of shard objects to return in a single <code>GetStream</code> request. The default value is 100. The minimum value is 1 and the maximum value is 100. </p>"""
+    shard_filter: NotRequired["capo_keyspacesstreams.types.shard_filter.ShardFilter"]
+    """<p> Optional filter criteria to apply when retrieving shards. You can filter shards based on their parent <code>shardID</code> to get a list of children shards to narrow down the results returned by the <code>GetStream</code> operation. </p>"""
+    next_token: NotRequired["capo_keyspacesstreams.types.shard_id_token.ShardIdToken"]
+    """<p> An optional pagination token provided by a previous <code>GetStream</code> operation. If this parameter is specified, the response includes only records beyond the token, up to the value specified by <code>MaxResults</code>. </p>"""
+
+
+# --- awsJson1_0 ser/de ---
+def serialize_aws_json_1_0(value: GetStreamInput) -> dict:
+    out: dict = {}
+    out["streamArn"] = value["stream_arn"]
+    if "max_results" in value:
+        out["maxResults"] = value["max_results"]
+    if "shard_filter" in value:
+        import capo_keyspacesstreams.types.shard_filter
+
+        out["shardFilter"] = (
+            capo_keyspacesstreams.types.shard_filter.serialize_aws_json_1_0(
+                value["shard_filter"]
+            )
+        )
+    if "next_token" in value:
+        out["nextToken"] = value["next_token"]
+    return out
+
+
+def deserialize_aws_json_1_0(data: dict) -> GetStreamInput:
+    out: GetStreamInput = {}  # type: ignore[typeddict-item]
+    if data.get("streamArn") is not None:
+        out["stream_arn"] = data["streamArn"]
+    else:
+        raise DeserializationError("GetStreamInput.stream_arn required")
+    if data.get("maxResults") is not None:
+        out["max_results"] = data["maxResults"]
+    if data.get("shardFilter") is not None:
+        import capo_keyspacesstreams.types.shard_filter
+
+        out["shard_filter"] = (
+            capo_keyspacesstreams.types.shard_filter.deserialize_aws_json_1_0(
+                data["shardFilter"]
+            )
+        )
+    if data.get("nextToken") is not None:
+        out["next_token"] = data["nextToken"]
+    return out