Skip to content

Calculate bus factor and other useful parameters for GitHub projects. Alternative to GitHub stars

License

Notifications You must be signed in to change notification settings

zats/github_bus_factor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

34 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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 🌟 as a "Like".
🗓 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.

About

Calculate bus factor and other useful parameters for GitHub projects. Alternative to GitHub stars

Resources

License

Stars

Watchers

Forks

Packages

No packages published