# [aws_lambda_events](https://github.com/LegNeato/aws-lambda-events)
[](https://travis-ci.org/LegNeato/aws-lambda-events)
[](https://docs.rs/aws_lambda_events/0.2.7)
This crate provides strongly-typed [AWS Lambda event structs](https://docs.aws.amazon.com/lambda/latest/dg/invoking-lambda-function.html) in Rust.
## Installation
Include the crate in your `Cargo.toml`:
```toml
[dependencies]
aws_lambda_events = "^0.2.7"
```
## Usage
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](https://github.com/awslabs/aws-lambda-rust-runtime) or community projects such as [`rust-aws-lambda`](https://github.com/srijs/rust-aws-lambda),
[`rust-crowbar`](https://github.com/ilianaw/rust-crowbar), and [`serverless_rust`](https://github.com/softprops/serverless-rust).
For a list of supported AWS Lambda events and services, see [the crate reference documentation](https://docs.rs/aws_lambda_events/0.2.7).
## How it works
This crate is automatically generated by [`aws_lambda_events_codegen`](https://github.com/LegNeato/aws-lambda-events/tree/master/aws_lambda_events_codegen). It parses event definitions from the [official Go SDK](https://github.com/aws/aws-lambda-go/tree/master/events) 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](https://github.com/aws/aws-lambda-go/tree/master/events) 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`.
## Contributing
All files in the `generated` directory should not be manually edited and are generated by [`aws_lambda_events_codegen`](https://github.com/LegNeato/aws-lambda-events/tree/master/aws_lambda_events_codegen). Any changes for files in `generated` must happen in [`aws_lambda_events_codegen`](https://github.com/LegNeato/aws-lambda-events/tree/master/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](https://github.com/aws/aws-lambda-go/tree/master/events) 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.