package module
Version: v1.0.0 Latest Latest

This package is not in the latest version of its module.

Go to latest
Published: Nov 10, 2019 License: MIT Imports: 10 Imported by: 0


Build Status GoDoc Go Report Card


Shim is a thin layer between API Gateway integration requests via Lambda and the standard library http.Handler interface. It allows you to write plain ol' Go and run it on Lambda with minimal modifications. Bring your own router!

Shim uses Go modules to model its dependencies.


For an extensive example on how shim fits in with other AWS serverless tooling like SAM Local and the Serverless Application Model (SAM) specification head over to the this example in the wiki

Note: API Gateway

Make sure that proxy pass integration in API Gateway is enabled to make sure your application receives every request sent to your API Gateway endpoint.

package main

import (



func main() {
  // Create a router as normal. Any router that satisfies the http.Handler interface
  // is accepted!
  mux := http.NewServeMux()
  mux.HandleFunc("/", func(w http.ResponseWriter, req *http.Request) {
    fmt.Fprint(w, "hello, world")

  s := shim.New(mux)

  // Pass your router to shim and let Lambda handle the rest
With Debugging Logger

You can pull logs from various steps in the shim by passing the SetDebugLogger option. It accepts any logger that provides the Println and Printf functions a lá the standard library logger.

func main() {

  l := log.New(os.Stdout, "", log.LstdFlags)
  shim := shim.New(
    nil, // or your mux




Package shim provides a thin layer between the Lambda API Gateway integrations and the standard library `http.Handler` interface. Bring your own router.



This section is empty.


This section is empty.


func NewAPIGatewayProxyResponse

func NewAPIGatewayProxyResponse(rw *ResponseWriter) events.APIGatewayProxyResponse

NewAPIGatewayProxyResponse converts a shim.ResponseWriter into an events.APIGatewayProxyResponse

func NewHTTPRequest

func NewHTTPRequest(ctx context.Context, event events.APIGatewayProxyRequest) (*http.Request, error)

NewHTTPRequest creates an *http.Request from a context.Context and an events.APIGatewayProxyRequest

func SetDebugLogger

func SetDebugLogger(l Log) func(*Shim)

SetDebugLogger is an option function to set the debug logger on a Shim. The debug logger gives insight into the event received from APIGateway and how shim transforms the request and response.


type Handler

type Handler interface {
	Handle(ctx context.Context, request events.APIGatewayProxyRequest) (events.APIGatewayProxyResponse, error)

Handler is an interface for accepting and responding to API Gateway integration requests

func New

func New(h http.Handler, options ...func(*Shim)) Handler

New returns an initialized Shim with the provided http.Handler. If no http.Handler is provided New will use http.DefaultServiceMux

type Log

type Log interface {
	Printf(format string, v ...interface{})
	Println(v ...interface{})

Log is a simple logging interface that is satisfied by the standard library logger amongst other idiomatic loggers

type ResponseWriter

type ResponseWriter struct {
	Code    int
	Headers http.Header
	Body    bytes.Buffer

ResponseWriter adheres to the http.ResponseWriter interface and makes the HTTP Status Code, Headers, and Body publicly accessible

func NewResponseWriter

func NewResponseWriter() *ResponseWriter

NewResponseWriter returns an ResponseWriter with the headers properly initialized

func (*ResponseWriter) Header

func (rw *ResponseWriter) Header() http.Header

Header adheres the http.ResponseWriter interface

func (*ResponseWriter) Write

func (rw *ResponseWriter) Write(b []byte) (int, error)

Write adheres to the io.Writer interface

func (*ResponseWriter) WriteHeader

func (rw *ResponseWriter) WriteHeader(c int)

WriteHeader adheres to the http.ResponseWriter interface

type Shim

type Shim struct {
	Handler http.Handler
	Log     Log

Shim provides a thin layer between your traditional http.Handler based application and AWS Lambda + API Gateway.

func (*Shim) Handle

Handle converts an APIGatewayProxyRequest converts an APIGatewayProxyRequest into an http.Request and passes it to the given http.Handler along with a ResponseWriter. The response from the handler is converted into an APIGatewayProxyResponse.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL