https://github.com/nathancahill/aws-serverless-micro

Deploy Micro functions on AWS Lambda
https://github.com/nathancahill/aws-serverless-micro

aws-lambda micro serverless zeit

Last synced: about 1 month ago
JSON representation

Deploy Micro functions on AWS Lambda

• Host: GitHub
• URL: https://github.com/nathancahill/aws-serverless-micro
• Owner: nathancahill
• License: mit
• Created: 2019-04-27T21:37:55.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2023-01-05T16:16:10.000Z (over 1 year ago)
• Last Synced: 2024-05-02T00:58:14.144Z (about 2 months ago)
• Topics: aws-lambda, micro, serverless, zeit
• Language: JavaScript
• Homepage:
• Size: 419 KB
• Stars: 13
• Watchers: 2
• Forks: 2
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• awesome-micro - aws-serverless-micro - Deploy Micro functions on AWS Lambda (Deployment Tools / Utilities)

README

        
![CI](https://github.com/nathancahill/aws-serverless-micro/workflows/CI/badge.svg?branch=master)

[![Coverage Status](https://coveralls.io/repos/github/nathancahill/aws-serverless-micro/badge.svg?branch=master)](https://coveralls.io/github/nathancahill/aws-serverless-micro?branch=master)

![Dependencies](https://img.shields.io/badge/dependencies-1-brightgreen.svg)

# AWS Serverless Micro

Run [Micro](https://github.com/zeit/micro/) functions on AWS Lambda. A very thin

layer for Micro functions that does two things:

-   Reshape an API Gateway `event` object to [`http.IncomingMessage`](https://nodejs.org/api/http.html#http_class_http_incomingmessage)

-   Marshall the returned [`http.ServerResponse`](https://nodejs.org/api/http.html#http_class_http_serverresponse) to a Lambda Proxy object.

Inspired by [awslabs/aws-serverless-express](https://github.com/awslabs/aws-serverless-express/).

_With **Micro**:_

```js

// The Micro function

$ cat my-api.js

module.exports = async () => 'Welcome to Micro'

// Running with `micro`

$ micro my-api.js

micro: Accepting connections on port 3000

```

_With **aws-serverless-micro**:_

```js

// The Micro function

$ cat my-api.js

module.exports = async () => 'Welcome to Micro'

// Wrapped in `aws-serverless-micro`

$ cat lambda.js

module.exports = {

    handler: require('aws-serverless-micro')(require('./my-api')),

}

// Deploy `lambda.handler` with the tool of your choice

```

## Install

```

$ yarn add aws-serverless-micro

```

```

$ npm install aws-serverless-micro

```

aws-serverless-micro targets Node.js v8.10 or higher as this is the version running on AWS Lambda.

## Compatability

This libary is **100% compatible** with the Micro API. The [full Micro test suite](https://github.com/nathancahill/aws-serverless-micro/tree/master/test/fixtures/micro)

is run against the library with 100% coverage.

-   [x] micro.send

-   [x] micro.sendError

-   [x] micro.createError

-   [x] micro.buffer

-   [x] micro.text

-   [x] micro.json

## License

MIT