Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mewmew/guldkorn

Tool for finding interesting forks of projects on GitHub.
https://github.com/mewmew/guldkorn

analysis divergence divergent divergent-fork downstream downstream-analysis forks forks-insight

Last synced: about 2 months ago
JSON representation

Tool for finding interesting forks of projects on GitHub.

Awesome Lists containing this project

README

        

# 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.

```bash
$ 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.