Pr. Police is a slackbot that sends to configured slack channels a listing of open pull requests that are waiting for a review. It supports watching multiple repositories, and filtering the pull requests by label.

This project is part of the Talkdesk Hackathon April 2017.

The easiest way to get an instance of Pr. Police up and running is to deploy it to Heroku by clicking on the button below.

You'll still need to fill in all the environment variables. For more info on this, head down to the Configuration section.

npm install pr-police

Git clone this repository then:

npm install

npm start

This will start the server locally until Ctrl-C is pressed.

Note: You will need to pass all the required env vars.

Pr. Police has the following environment variables available:

The github account token to access the repos

The slack token for the bot to access your slack team

The list of repositories to watch. The format is user/repo and comma separated.

Example: rogeriopvl/gulp-ejs, rogeriopvl/pullhub, talkdesk/pr-police

The list of labels to filter pull-requests. So imagine, your team uses the label needs review for pull-requests waiting for review, you'll have to fill in: needs review. Multiple labels are comma separated.

The list of channels on your team where Pr. Police will post the announcements. Multiple channels are comma separated.

The list of private groups on your team where Pr. Police will post the announcements. Multiple channels are comma separated.

Time interval for announcing the pull-requests on slack. In milliseconds. Default: 3600000.

The name of your Pr. Police bot on slack.

URL of the icon for the slack bot when sending messages.

Pr. Police was developed by Rogério Vicente during one of Talkdesk's internal hackathons.

Artwork created by Micaela Neto