Skip to content

Generates a DOT file graphing open PRs and their relationships

Notifications You must be signed in to change notification settings

tzachz/github-pr-graph

Repository files navigation

github-pr-graph

Generates a DOT file graphing open PRs and their relationships - especially useful when one PR is based on another PR's base branch. Output example:

image

Usage

  1. Make sure you have Java8 installed
  2. Have your GitHub user+password ready, or create and save an access token (recommended!)
  3. Download and extract the packaged github-pr-graph.zip,
  4. Call the github-pr-graph script under bin in the extracted folder:
# Usage:
# To use with a token granting access to REPO under ORG: 
./github-pr-graph <ORG> <REPO> -token <TOKEN> 
# OR, to use with user+password granting access to REPO under ORG (won't work for users with 2FA enabled): 
./github-pr-graph <ORG> <REPO> -u <USER_NAME> -p <PASSWORD> 

# To filter PRs by keyword, add -k and the keyword to search for:
./github-pr-graph <ORG> <REPO> -token <TOKEN> -k api

The result would be a file named <ORG>-<REPO>-PR-graph.dot which can be viewed using any DOT file viewer (for Ubuntu, try xdot)

About

Generates a DOT file graphing open PRs and their relationships

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages