/guldkorn

Tool for finding interesting forks of projects on GitHub.

Primary LanguageGoThe UnlicenseUnlicense

Guldkorn

Poesi för döda fiskar.

The guldkorn tools locates forks with divergent commits or commits ahead of the original repository.

Installation

go get github.com/mewmew/guldkorn

Usage

guldkorn [OPTION]...

Flags:

  -owner string
        owner name (GitHub user or organization)
  -q    suppress non-error messages
  -repo string
        repository name
  -token string
        GitHub OAuth personal access token
  -watch
        watch divergent forks

Examples

This example helped narrow down 250 forks across 2554 branches to 65 forks across 149 branches with divergent commits or commits ahead of origin, a subset of which are presented below.

$ guldkorn -owner diasurgical -repo devilutionX -token ACCESS_TOKEN

status: "diverged" (head=AJenbo:roguelike vs base=diasurgical:master)
AJenbo:roguelike ahead 3 (and behind 139) of diasurgical:master
https://github.com/AJenbo/devilutionX/commits/roguelike?author=AJenbo

status: "diverged" (head=NEMadman:master vs base=diasurgical:master)
NEMadman:master ahead 1 (and behind 970) of diasurgical:master
https://github.com/NEMadman/devilutionX/commits/master?author=NEMadman

status: "diverged" (head=cain05:difficulty_rebalance vs base=diasurgical:master)
cain05:difficulty_rebalance ahead 13 (and behind 833) of diasurgical:master
https://github.com/cain05/devilutionX/commits/difficulty_rebalance?author=cain05

status: "diverged" (head=qndel:pixellight vs base=diasurgical:master)
qndel:pixellight ahead 81 (and behind 22) of diasurgical:master
https://github.com/qndel/devilutionX/commits/pixellight?author=qndel

...

Note: Remember to set ACCESS_TOKEN to not hit the rate limit on GitHub. To create a personal access token on GitHub visit https://github.com/settings/tokens

To use the -watch flag, the notifications permission scope is required when generating the GitHub access token. Other than that, Guldkorn requires no additional scopes.

If the environment variable GULDKORN_GITHUB_TOKEN is set, the access token will be read from there.