aws_lambda_events 0.6.3

AWS Lambda event definitions


Build Status Documentation

This crate provides strongly-typed AWS Lambda event structs in Rust.


Include the crate in your Cargo.toml:

aws_lambda_events = "^0.5.0"


The crate itself has no AWS Lambda handler logic and instead exists to serialize and deserialize AWS Lambda events into strongly-typed Rust structs.

The types defined in this crate are usually used with handlers / runtimes provided by the official Rust runtime.

For a list of supported AWS Lambda events and services, see the crate reference documentation.

How it works

This crate is automatically generated by aws_lambda_events_codegen. It parses event definitions from the official Go SDK and thus is generally up-to-date. Additionally, tests with example events are generated to check correctness and any documentation comments are preserved and used in rustdoc.

Dealing with null and empty strings in AWS Lambda input

The official Lambda Go SDK sometimes marks a field as required when the underlying Lambda event json could actually be null or an empty string. Normally, this would cause a panic as Rust is much more strict.

This crate deals with this reality by marking all required json string fields as Option<String> in Rust. Json null or the empty string are deserialized into Rust structs as None.

Conditional compilation of features

This crate divides all Lambda Events into features named after the service that the events are generated from. By default all events are enabled when you include this crate as a dependency to your project. If you only want to import specific events from this crate, you can disable the default features, and enable only the events that you need. This will make your project to compile a little bit faster, since rustc doesn't need to compile events that you're not going to use. Here's an example on how to do that:

aws_lambda_events = { version = "^0.5", default-features = false, features = ["apigw", "alb"] }


All files in the generated directory should not be manually edited and are generated by aws_lambda_events_codegen. Any changes for files in generated must happen in aws_lambda_events_codegen.

We have no desire to manually write event definitions and contributions to that effect will not be accepted. If the official Go SDK is missing an event definition, please file a bug on that project rather than submitting a fix here. Once the official Go SDK has included your changes this project will pick up the new event definitions.

Manual changes to wrap the generated event definitions or implement Rust-specific ergonomic improvements will be enthusiastically accepted.