babel-bot

A bot used by the Babel team to automate common tasks in GitHub repositories. Allows taking action on events triggered from the GitHub webhooks API.

The bot is build as an AWS Lambda function, using AWS API Gateway to map the requests to an endpoint.

Features

• Create a new comment on newly opened issues (if not in the org)
• Reply to issue with canned response when Needs Info label is added
• Notify committer in PR of test failures in TravisCI, and add OS/node.js version that failed, with direct link to log
• Add Has PR label to issues that have been referenced in a PR
• Add command to move issues to other repo (@babel-bot move to babel/babylon)
• Deletes issue comments that are just +1/-1

Future Bot Ideas

• https://github.com/babel/notes/issues/8

Adding a New Event

1. Look at the list of GitHub webhook events to determine which your rule should respond to.
2. Find (or create) a folder under src/handlers with the name matching the name of the GitHub event
3. Create a new JS file under the directory, with the name matching the action or state (dependening on the shape of the GitHub payload) you want your code to be triggered for
4. Export a default function that accepts 1 argument, which will be the payload from GitHub each time the event is triggered.

Examples of existing event rules can be found in src/handlers.

Setting up AWS Lamdba/API Gateway as a Test Environment

Visit the guide for detailed instructions.

Unit-Testing

Examples of how to test a handler can be seen in src/handlers/issues/__tests__.

Deploying a New Version to AWS Lamdba

This process is currently manual, but will likely be automated in the future.

1. Run yarn run package, which will create function.zip in the root of the repository
2. Login to the AWS console, and find the function in the Lambda dashboard, under Functions
3. Click the Upload button under the Code tab (Code Entry Type should be set to Upload a .ZIP file)
4. Click Save

If you have a ~/.aws/configuration setup, you can just run npm run deploy.