pullhub
About
Pullhub is a cli and lib tool that lists all pull requests from one or more repos. It supports filtering by label.
Install
npm install --save pullhub
Authentication
Pullhub authenticates the user via a github token. To get your token visit this github help page.
For public repos the token is optional but recommended. Private repos need token to enable access.
You can set the token in your shell enviroment, just add to your .bashrc
, .zshrc
etc. the following line:
export GH_TOKEN=mypersonaltoken
This will work for both cli and lib usage.
Cli usage
pullhub <repos> [--labels] [--version] [--help] <repos> space separated repos in the user/repo format --user <username> search all repos
Examples
- Get all open pull requests from two repos
pullhub user/repo1 user/repo2
- Get all open pull requests labeled "needs review" from two repos
pullhub user/repo1 user/repo2 --labels "needs review"
- Get all open pull requests labeled "in progress" and "reviewed" from one repo
pullhub user/repo1 --labels "in progress,reviewed"
- Get all open pull requests from all the repos of a user
pullhub --user rogeriopvl
Lib usage
You can use pullhub as a library, and what it will allow you to get all PRs in given repositories with given labels.
You can use promises:
const pullhub = console
Or callbacks:
const pullhub =