sprockets-dynamodb 1.0.0

DynamoDB client and mixin for Tornado applications

An asynchronous DynamoDB client and mixin for Tornado applications

Installation

sprockets-dynamodb is available on the Python package index and is installable via pip:

pip install sprockets-dynamodb

Documentation

Documentation is available at sprockets-dynamodb.readthedocs.io.

Configuration

The following table details the environment variable configuration options.

Variable	Definition	Default
DYNAMODB_ENDPOINT	Override the default DynamoDB HTTP endpoint
DYNAMODB_MAX_CLIENTS	Maximum number of concurrent DynamoDB clients/requests per process	100
DYNAMODB_MAX_RETRIES	Maximum number retries for transient errors	3

Mixin Configuration

The sprockets_dynamodb.mixins.DynamoDBMixin class will automatically raise HTTPError responses for different classes of errors coming from DynamoDB. In addition it will attempt to work with the Sprockets InfluxDB client to instrument all DynamoDB requests, submitting per request measurements to InfluxDB. It will attempt to automatically tag measurements with the application/service name if the SERVICE environment variable is set. It will also tag the measurement if the ENVIRONMENT environment variable is set with the environment that the application is running in. Finally, if you are using the Sprockets Correlation Mixin, measurements will automatically be tagged with the correlation ID for a request.

Requirements

• Tornado

• tornado-aws

Version History

Available at https://sprockets-dynamodb.readthedocs.org/en/latest/history.html