awslabs · davidbarsky · Dec 4, 2018 · Nov 30, 2018 · Dec 1, 2018 · Dec 1, 2018
diff --git a/Cargo.lock b/Cargo.lock
diff --git a/Cargo.toml b/Cargo.toml
@@ -1,5 +1,6 @@
 [workspace]
 members = [
     "lambda-runtime-client",
-    "lambda-runtime"
+    "lambda-runtime",
+    "lambda-http"
 ]
diff --git a/README.md b/README.md
@@ -2,10 +2,11 @@
 
 [![Build Status](https://travis-ci.org/awslabs/aws-lambda-rust-runtime.svg?branch=master)](https://travis-ci.org/awslabs/aws-lambda-rust-runtime)
 
-This package makes it easy to run AWS Lambda Functions written in Rust. This workspace includes two crates:
+This package makes it easy to run AWS Lambda Functions written in Rust. This workspace includes multiple crates:
 
 * **`lambda-runtime-client`** is a client SDK for the Lambda Runtime APIs. You probably don't need to use this crate directly!
 * **`lambda-runtime`** is a library that makes it easy to write Lambda functions in Rust.
+* **`lambda-http`** is a library that makes it easy to write API Gateway proxy event focused Lambda functions in Rust.
 
 ## Example function
 
@@ -87,7 +88,7 @@ $ cat output.json  # Prints: {"message":"Hello, world!"}
 
 ## lambda-runtime-client
 
-Defines the `RuntimeClient` trait and provides its `HttpRuntimeClient` implementation. The client fetches events and returns output as `Vec<u8>`. 
+Defines the `RuntimeClient` trait and provides its `HttpRuntimeClient` implementation. The client fetches events and returns output as `Vec<u8>`.
 
 For error reporting to the runtime APIs the library defines the `RuntimeApiError` trait and the `ErrorResponse` object. Custom errors for the APIs should implement the `to_response() -> ErrorResponse` method of the `RuntimeApiError` trait.
 

diff --git a/lambda-http/Cargo.toml b/lambda-http/Cargo.toml
@@ -0,0 +1,26 @@
+[package]
+name = "lambda_http"
+version = "0.1.0"
+authors = ["Doug Tangren"]
+description = "Rust API Gateway proxy event interfaces for AWS Lambda"
+keywords = ["AWS", "Lambda", "APIGateway", "Rust", "API"]
+license = "Apache-2.0"
+homepage = "https://github.com/awslabs/aws-lambda-rust-runtime"
+repository = "https://github.com/awslabs/aws-lambda-rust-runtime"
+documentation = "https://docs.rs/lambda_runtime"
+
+[dependencies]
+http = "0.1"
+serde = "^1"
+serde_json = "^1"
+serde_derive = "^1"
+lambda_runtime = { path = "../lambda-runtime", version = "^0.1" }
+tokio = "^0.1"
+base64 = "0.10"
+failure = "0.1"
+failure_derive = "0.1"
+serde_urlencoded = "0.5"
+
+[dev-dependencies]
+log = "^0.4"
+simple_logger = "^1"
diff --git a/lambda-http/examples/basic.rs b/lambda-http/examples/basic.rs
@@ -0,0 +1,30 @@
+extern crate lambda_http as http;
+extern crate lambda_runtime as runtime;
+extern crate log;
+extern crate simple_logger;
+
+use http::{lambda, Body, Request, RequestExt, Response};
+use runtime::{error::HandlerError, Context};
+
+use log::error;
+use std::error::Error;
+
+fn main() -> Result<(), Box<dyn Error>> {
+    simple_logger::init_with_level(log::Level::Debug).unwrap();
+    lambda!(my_handler);
+
+    Ok(())
+}
+
+fn my_handler(e: Request, c: Context) -> Result<Response<Body>, HandlerError> {
+    Ok(match e.query_string_parameters().get("first_name") {
+        Some(first_name) => Response::new(format!("Hello, {}!", first_name).into()),
+        _ => {
+            error!("Empty first name in request {}", c.aws_request_id);
+            Response::builder()
+                .status(400)
+                .body::<Body>("Empty first name".into())
+                .expect("failed to render response")
+        }
+    })
+}