GitHub Survivor is a simple bug dashboard that shows an overview of bugs in an external issue tracker. We use it at 99designs to keep an eye on the bug count and remind ourselves to close bugs.
It's easy to forget about bugs when you're knee-deep in feature development. This dashboard is a good way to keep bugs on people's minds, and to show at-a-glance information about the current bug situation.
GitHub Survivor scrapes your bug data using your issue tracker's API and stores it in a local Mongo DB for subsequent querying. It shows, at a glance:
- Top/bottom bug closers for the current reporting period (week, month or sprint)
- Current open bug count
- Net difference in open bugs since the last reporting period
- Charts (yay!):
- Number of bugs opened/closed for the last 12 reporting periods
- Number of open bugs over the last 12 reporting periods
There are bug trackers that provide this kind of data, but we wanted something fun that integrates with our existing bug tracking solution.
GitHub Survivor can integrate with these issue trackers out of the box:
- GitHub
- JIRA (courtesy of jirasurvivor)
Read more about defining backends in the wiki.
Requirements:
- Python >= 2.7
- MongoDB
- virtualenv (recommended)
This command might satisfy the above dependencies on Ubuntu:
$ sudo apt-get install python2.7 mongodb python-virtualenv
- Install package using
pip install githubsurvivor
- Generate a configuration file using
githubsurvivor-generate-config
- Do an initial import of your bugs using
githubsurvivor-sync
- Start the server using
githubsurvivor
For detailed instructions, see https://github.com/99designs/githubsurvivor/wiki/Installation
See https://github.com/99designs/githubsurvivor/wiki/Development
MIT; see LICENSE
See https://github.com/99designs/githubsurvivor/wiki/Contributors