A TUI utility that lists open github PRs for your team.
python3 -m pip install pream-team --upgrade
You need a GitHub personal access token with full repo scope
and with admin org read access if you want to specify org value.
Besides the token you also need to provide a list of github usernames. You can do that through command line or yaml config file (see below).
pream-team will also dispay a list of pull requests where you (username specified by 'me' value in cli or yaml) or your team (team name specified by 'my_team') has been added as a reviewer. You can see those by clicking on 'Review requested' button on the top right of the TUI.
If you provide org value, pream-team will fetch only the prs for repos that belong to the org.
If you provide me value, pream team will print out your approval status for the
pull request ('v', '@', 'x' for approved, commented, chages requeted) followed by the number of approvals for the PR eg. [v|2] [draft|repo-name] - pr title. If you dont provide the me value, you will only get the number of approvals eg. [2] [draft|repo-name] - pr title
Command line options:
options:
-h, --help show this help message and exit
--names NAMES [NAMES ...]
List of GitHub usernames.
--days DAYS Number of past days to search for PRs.
--token TOKEN GitHub API token.
--org ORG GitHub organization name.
--me ME Your GitHub username.
--my_team MY_TEAM name of your gh team. used to check for review requests that requested team review but
not you explicitly.
--file FILE Path to YAML file containing 'names', 'days', 'token' and 'org' fields. (Note that command line
arguments override YAML file configuration)
Or through a yaml file (default location is ~/.prs/config.yml):
org: some-org # optional
token: some-token # required
days-back: 25 # optional
me: username # optional
my_team: team-name # optional
names: # required (at least one)
- "Teamamte-username-1"
- "Teamamte-username-2"
- "Teamamte-username-3"