GitHub Bus Factor
More meaningful statistics for GitHub projects than just stars.
$ gem install github_bus_factor
Usage
You will need to create a GitHub access token. Head over to https://github.com/settings/tokens and create a new one, call the app GitHub Score and copy the token.
To fetch a report for a particular repository
$ github_bus_factor octokit/octokit.rb
First time you call it, it will prompt you to provide the token you just created.
To remove the token
$ github_bus_factor logout
If you ever forget what each line of the report means, run
$ github_bus_factor about
Report
| Description | |
|---|---|
| Forks. Might mean people planning are fixing bugs or adding features. | |
| Watchers. Shows number of people interested in project changes. | |
| Stars. Might mean it is a good project or that it was featured in a mailing list. Some people use |
|
| Age. Mature projects might mean battle tested project. Recent pushes might mean project is actively maintained. | |
| Pull Requests. Community contributions to the project. Many closed PRs usually is a good sign, while no PRs usual is bad. | |
| Refactoring. Balance between added and deleted code. Crude value not including semantic understanding of the code. | |
| Releases. Might mean disciplined maintainer. Certain dependency managers rely on releases to be present. | |
| Bus factor. Chances of the project to become abandoned once current collaborators stop updating it. The higher - the worse. |
License
The gem is available as open source under the terms of the MIT License.
