Ghstats is a small command line tool to retrieve a set of stats for a given set of repositories, It allows you to get stats for all repositories owned by a named user or users, or from an organisation or organisations.

To make the reporting as fast as possible we make extensive use of the Parallel gem to run as many clones as possible in parallel.

There is no requirement to supply a token when using ghstats, however there are numerous benefits. including but not limited to:

1. Less impact from connection throttling (Unauthenticated connections are throttled more heavily by GitHub)
2. Ability to get stats for private repositories
3. Simple to report on all of your own repositories (no need to specify a username)

You could for example get stats for ALL the repositories that you own with a single command.

# ghstats -t <Your token goes here> -A

If you just wanted your personal repositories you could use -U instead of -A, or -M if you just wanted the repositories for organisations that you are a member of.

If you do not supply token you will be limited to reporting on just public repositories.

We intentionally do NOT handle username + password combinations when talking to GitHub, this removes some security risks and also removes the issue of having to handle MFA logins. It allows you to create a read-only token for cloning only to further improve your security position.

The following is an example of how to get stats about all public repositories owned by Wolf Software.

# ghstats -o WolfSoftware

Usage: ghstats
    -h, --help                       Display this screen

Access Parameters:
    -t, --token <token>              GitHub personal access token (PAT)

Report Parameters:
    -u, --user <names>               Github username(s) to rip
    -o, --org <names>                Github organisation(s) to rip
    -U, --user-repos                 Rip all of the repositories for the named user(s)
    -M, --org-member-repos           Rip all of the repositories for all organisation the user(s) is a member of
    -A, --all-repos                  Same as running -U -M
    -O, --org-repos                  Rip all of the repositories for the named organisation(s)

Report Flags:
    -P, --public-only                Only use public repos

If you just supply a username and nothing else it will default to just the users own repositories (same as -U)

users and orgs can be either a single entry or comma-separated list of entries.

All errors raised from github-core-lister are caught and re-thrown as StandardErrors in order to simplify the catching.