Dynomite is set of high-level interfaces built on top of rusoto_dynamodb which make interacting with AWS DynamoDB more productive.
Data Modeling
Dynomite adapts Rust's native types to DynamoDB's core components to form a coherent interface.
The Attribute type
provides conversion interfaces to and from Rust's native scalar types which represent
DynamoDB's notion of "attributes". The goal of this type is to make representing
AWS typed values feel more natural and ergonomic in Rust. You can implement Attribute
for your own
types to leverage higher level functionality.
The Item type provides conversion interfaces for complex types which represent DynamoDB's notion of "items".
💡 A cargo feature named "derive" makes it easy to derive Item
instances for your custom types. This feature is enabled by default.
Rusoto extensions
By importing the dynomite::DynamoDbExt trait, dynomite adds client interfaces for creating async Stream-based auto pagination interfaces
Robust retries
By importing the dynomite::Retries trait, dynomite provides an interface for adding configuration retry policies so your rusoto DynamoDb clients.
Errors
Some operations which require coercion from AWS to Rust types may fail result in an AttributeError. These errors were designed to work with the failure crate ecosystem.
Cargo Features
This crate as a few cargo features of note.
uuid
Enabled by default, the uuid
features adds support for implementing Attribute
for
the uuid crate type Uuid
, a useful
type for producing and representing
unique identifiers for items that satisfy effective characteristcs for partition keys
derive
Enabled by default, the derive
feature enables the use of the dynomite derive feature which
allows you simple add #[derive(Item)]
to your structs.
rustls
Disabled by default, the rustls
feature changes overrides Rusoto's default tls
dependency on OpenSSL, replacing it with a rustls
based tls implementation. When you
enable this feature. It will also enable uuid
and derive
by default.
To disable any of these features
[]
= "xxx"
= false
= ["feature-you-want"]