Skip to main content

GitHub stats sparkline CLI

Project description

A command line tool for generating sparklines from GitHub stats.

GitHub has several APIs for extracting activity statistics in a raw JSON format. Sparkler is a tool that can take this raw data and generate sparkline images to show the activity level over a period of time.

Sparkler will create a sparkline of the commit activity over the last year.


Sparkler can be installed with pip:

$ pip install --user sparkler


There are two inputs required when running sparkler, the GitHub repo you wish to graph and the name of the file to save the graph.

To get the last year’s commit activity for the kubernetes/kubernetes repo, use the command line:

sparkler kubernetes/kubernetes activity.jpg

Additional options are available for setting the foreground and background colors of the generated graph. Refer to the help text for details:

sparkler -h
usage: sparkler [-h] [--version] [--background BACKGROUND] [--line LINE]
                repo outfile

positional arguments:
  repo                  The GitHub org/repo to report on.
  outfile               The file name for the generated image. Note: Due to
                        current library issues, this must be a jpg.

optional arguments:
  -h, --help            show this help message and exit
  --version             show program's version number and exit
  --background BACKGROUND
                        The background color of the sparkline image.
  --line LINE           The sparkline image line color.

Feel free to open GitHub Issues or put up a pull request.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sparkler-0.3.0.tar.gz (14.8 kB view hashes)

Uploaded source

Built Distribution

sparkler-0.3.0-py2.py3-none-any.whl (10.4 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page