PR Labeler

A GitHub App built with Probot that enables a GitHub bot to label PRs automatically based on title and body against a list of defined labels.

Config

Add a pr-labeler.yml configuration file to your repository's .github directory with the following content:

# .github/pr-labeler.yml
# The bot always updates the labels, add/remove as necessary [default: false]
alwaysReplace: false
# Treats the text and labels as case sensitive [default: true]
caseSensitive: true
# Array of labels to be applied to the PR [default: []]
customLabels:
  # Finds the `text` within the PR title and body and applies the `label`
  - text: '#bug'
    label: 'bug'
  - text: '#test'
    label: 'test'
  - text: '#feature'
    label: 'feature'
# Search the body of the PR for the `text` [default: true]
searchBody: true
# Search the title of the PR for the `text` [default: true]
searchTitle: true
# Search for whole words only [default: false]
wholeWords: false

Development

If you want to work on the bot, you can follow the instructions below.

Setup

# Install dependencies
yarn install

# Build the bot (we need to transpile TypeScript into JavaScript)
yarn build

# Run the bot
yarn start

Docker

# 1. Build container
docker build -t pr-labeler .

# 2. Start container
docker run -e APP_ID=<app-id> -e PRIVATE_KEY=<pem-value> pr-labeler

Contributing

If you have suggestions for how pr-labeler could be improved, or want to report a bug, open an issue! We'd love all and any contributions.

For more, check out the Contributing Guide.