Skip to main content

Utilities for building and testing AWS applications in Python

Project description



CI Build codecov

Utilities for building and testing AWS applications in Python.



Lambda events can be given data models that are created from the event and context:

from awstin.awslambda.api import LambdaEvent

class CustomEvent(LambdaEvent):
    def __init__(self, request_id, memory_limit):
        self.request_id = request_id
        self.memory_limit = memory_limit

    def _from_event(cls, event, context):
        request_id = event["requestContext"]["requestId"]
        memory_limit = context["memory_limit_in_mb"]
        return cls(request_id, memory_limit)

Lambda handlers can then be created using the lambda_handler decorator factory, which takes as an input the data model for the lambda event.

from awstin.awslambda.api import lambda_handler

def handle_custom_event(event):



The DynamoDB class currently gives dict-like access to boto3 Tables and their contents. This requires either the TEST_DYNAMODB_ENDPOINT (for integration testing) or AWS_REGION (for production) endpoints to be set.

from awstin.dynamodb.api import DynamoDB

dynamodb = DynamoDB()

# List of available tables
tables = dynamodb.tables

# Access a single table
table = dynamodb["my_table"]

# Tables that only have a partition key can be accessed directly by their
# partition key
item = table["an_item"]

# Full primary key access is also available
item = table[{"primary_key_name": "an_item"}]


For integration testing, a context manager to create and then tear-down a DynamoDB table is provided. More flexible control over the created table is planned.

from awstin.dynamodb.testing import temporary_dynamodb_table

with temporary_dynamodb_table("table_name", "hashkey_name") as table:
    item = {
        "hashkey_name": "test_value",
        "another_key": 5,


SNS topics can be retrieved by name and published to with the message directly:

from awstin.sns.api import SNSTopic

topic = SNSTopic("topic-name")
message_id = topic.publish("a message")

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for awstin, version 0.0.3
Filename, size File type Python version Upload date Hashes
Filename, size awstin-0.0.3-py3-none-any.whl (14.8 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size awstin-0.0.3.tar.gz (10.7 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page