srvrls 0.1.1

A lightweight, opinionated serverless framework reducing boilerplate
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50

# srvrls - a lightweight serverless framework

![CodeBuild test indicator](https://codebuild.us-west-2.amazonaws.com/badges?uuid=eyJlbmNyeXB0ZWREYXRhIjoib3o3dlJ5RkJuMEVTckIyR1p1WXAzZkxjVzFQTnZ1QjFMUzZ0OUc2Q1dkQlVhQVU2WjFFTExyQVladmRoc2tSRkozbHFVaHg2ZGhtY2xlN2N1ZFY4cDhjPSIsIml2UGFyYW1ldGVyU3BlYyI6IjdiZUk4RWRZeHpoemZxdEUiLCJtYXRlcmlhbFNldFNlcmlhbCI6MX0%3D&branch=master)

We built this library to simplify building applications that use AWS API Gateway
as a proxy for AWS Lambda.

This library has opinions, strong ones, very possibly not your own.
Our design priorities here are simple:

- reduce needed boilerplate in serverless applications
- provide opinionated defaults to otherwise open questions (more on this later)
- provide decoupling between the serverless function provider and the application logic
(keeping open the option of supporting Google or Azure functions in the future)

This wrapper turns this
    
    impl Handler<ApiGatewayProxyRequest, ApiGatewayProxyResponse, HandlerError> for App {
        fn run(&mut self, req: ApiGatewayProxyRequest, _ctx: Context) -> Result<ApiGatewayProxyResponse, HandlerError> {
            match some_function(req) {
                Ok(response) => {
                    ApiGatewayProxyResponse {
                        status_code: 200,
                        headers: hashmap!(String::from("Content-Type") => String::from("application/json")),
                        multi_value_headers: HashMap::new(),
                        body: Some(response),
                        is_base64_encoded: None,
                    }
                }, 
                Err(e) => {
                    ApiGatewayProxyResponse {
                        status_code: 400,
                        headers: hashmap!(String::from("Content-Type") => String::from("application/json")),
                        multi_value_headers: HashMap::new(),
                        body: Some(e.message),
                        is_base64_encoded: None,
                    }
                }
            }
        }
    }

into this

    impl SrvrlsApplication for App {
        fn handle(&mut self, event: SrvrlsRequest) -> Result<SrvrlsResponse, SrvrlsError> {
            let response = some_function?;
            Ok(SrvrlsResponse::ok(response))
        }
    }