smithy-aws-event-stream

What it is and what it does

This package provides low-level Python components for handling Amazon Event Streams as part of the Smithy SDK generation framework. It is designed to be used as a runtime dependency in service clients generated by the Smithy Python code generator, enabling asynchronous communication over event streams using the restJson1 protocol.

The package is currently in pre-alpha development and explicitly warns that all interfaces are subject to change. It depends only on smithy-core and supports Python 3.12 and newer. It is not intended for production use yet, and several features remain unimplemented. Developers should treat this as an unstable, experimental component that may undergo breaking changes.

Use it for:

• Building Smithy-generated Python clients that need to handle AWS event stream operations.
• Integrating event stream communication into asynchronous service clients for non-AWS Smithy services.
• Prototyping or testing event stream protocols before production deployment.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides low-level Python components for handling Amazon Event Streams within Smithy-generated service clients, enabling asynchronous event stream communication.

No, not for production. This package is explicitly pre-alpha with unstable interfaces and a warning against production use. Install only if you are generating Smithy clients that require event stream support and are willing to accept breaking changes as the package matures.

Install

smithy-aws-event-stream on PyPI

pip install smithy-aws-event-stream

uv add smithy-aws-event-stream

poetry add smithy-aws-event-stream

Installing smithy-aws-event-stream

Before you install

Low install friction with a single pure-Python dependency (smithy-core). Active maintenance with recent commits, though the package remains in pre-alpha status and explicitly warns that all interfaces are subject to change.

License in practice

Licensed under Apache License 2.0 (permissive), allowing use in proprietary and open-source projects with minimal restrictions beyond attribution.

Quickstart

pip install smithy-aws-event-stream

from smithy_aws_event_stream import EventStreamCodec
# Use within a Smithy-generated client that handles event streams

Requires Python 3.12 or newer; intended for use as a dependency within Smithy-generated clients, not as a standalone library.

Verify before relying

• What specific event stream operations or protocols this package implements beyond the generic 'Amazon Event Streams' description.
• Whether this package can be used independently or only as part of a Smithy code-generated client.
• Performance characteristics or throughput limits for event stream handling.

Package facts

Evidence: smithy_aws_event_stream-0.3.0-py3-none-any.whl

Keywords: amazon, aws, eventstream, sdk, smithy

Tags

More Libraries packages