Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lauripiispanen/most-active-github-users-counter
CLI tool that queries the GitHub GraphQL API for users and ranks them according to number of contributions
https://github.com/lauripiispanen/most-active-github-users-counter
Last synced: 3 months ago
JSON representation
CLI tool that queries the GitHub GraphQL API for users and ranks them according to number of contributions
- Host: GitHub
- URL: https://github.com/lauripiispanen/most-active-github-users-counter
- Owner: lauripiispanen
- License: mit
- Archived: true
- Created: 2017-05-06T20:58:56.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2022-12-01T19:50:00.000Z (about 2 years ago)
- Last Synced: 2024-09-21T15:50:02.994Z (3 months ago)
- Language: Go
- Homepage: https://commits.top/
- Size: 171 KB
- Stars: 1,271
- Watchers: 19
- Forks: 195
- Open Issues: 43
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-starts - lauripiispanen/most-active-github-users-counter - CLI tool that queries the GitHub GraphQL API for users and ranks them according to number of contributions (Go)
README
[Project homepage](https://commits.top/)
# Most Active GitHub Users Counter
This CLI tool queries the GitHub GraphQL API for users and ranks them according to number of contributions. Several preset locations are provided.
**GitHub Token**
In order to make requests against the GitHub API one needs an access token, which can be created [here](https://github.com/settings/tokens). The token needs `read:org` and `read:user` permissions.
**Example usage (dev environment):**
```
go run *.go \
--token paste-your-token-here \
--preset worldwide \
--amount 500 \
--consider 1000 \
--output csv \
--file ./output.csv
```
## Contribution
Contributions are accepted. Please provide any input as pull request. As a hobby project, my time is limited, but PRs and issues are addressed regularly.
*Please use the provided precommit hooks and run `go fmt`, `go vet` and `go lint` liberally.*
## FAQ
### Why am I not on this list?
This could be due to a number of things.
1) Firstly, GitHub API doesn't allow sorting by contributions, so instead it is first sorted by number of followers to get a larger list, which is then sorted by contributions. This means you need a minimum number of followers to be on this list. Each page shows the minimum number of followers needed.
2) You live in a city which is not included in the query. Unfortunately the query is free-text and not strictly geographical. Rural areas may be excluded from the list, but you can often remedy this by adding the country name to your location in GitHub.
3) You have mostly private commits. These are included too, but they are not listed on the main country page anymore. Instead you will find a subpage with a list that also has private contributions included. This arrangement is done to favor open source contributions over private contributions.
### Why is my contribution count not the same as on my GitHub profile?
Depending on your settings, your GitHub profile displays either only your public contributions or both your public and private ones. commits.top by default shows only public contributions, but public+private count is accessible on a subpage on each region page. You can use the [GitHub API GraphQL Explorer](https://developer.github.com/v4/explorer/) and run the following query to see what the API returns for your user:
```
query {
viewer {
login
contributionsCollection {
restrictedContributionsCount
contributionCalendar {
totalContributions
}
}
}
}
```