Skip to content
/ helpr Public

🤖 A GitHub App built with the ProBot framework that labels issues when a PR is associated with it.

License

Notifications You must be signed in to change notification settings

rsarky/helpr

Repository files navigation

helPR

A GitHub App built with Probot that assigns labels to issues based on the status of the PR associated with it.

Build Status

Usage

Using helpr is pretty straightforward. Just install the app on your repository and you are ready to go. 💯

Consider this open issue :

issue

Now when someone references this issue in a pull request helpr will automatically add the label pr-available :

labelled

helpr supports 3 labels :

  • pr-available when a new PR referencing an issue is opened.
  • pr-merged when a PR referencing an issue is merged.
  • pr-rejected when a PR referencing an issue is rejected.

When a PR for an issue is merged or rejected helpr will remove the pr-available label and add the respective merged or rejected label.

Configuring

You can choose label names as per your liking 😄

Add a helpr object in your .github/config.yml file (and make the file if you don't already have it) like this:

helpr:
  opened: 'insert-label-for-pr-opened-here'
  merged: 'insert-label-for-pr-merged-here'
  rejected: 'insert-label-for-pr-rejected-here'

Only override the ones that you want to change!

The defaults are:

opened: 'pr-available'
merged: 'pr-merged'
rejected: 'pr-rejected'

Setup

# Install dependencies
npm install

# Run the bot
npm start

See docs/deploy.md if you would like to run your own instance of this app.

About

🤖 A GitHub App built with the ProBot framework that labels issues when a PR is associated with it.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published