Skip to main content

UNKNOWN

Project description

Commit Entropy is a tool that can be used to calculate the entropy of changes in a source code repository. Entropy for code changes is a measure of how specific each commit was in relation to the entire code base. Very specific commits only affect a small set of files, and thus have a low entropy. Commits that touch a large number of files are much less specific and have a higher entropy as a result.

The term Entropy in this context is a simplified application of Shannon Entropy to commits in a source repository. It’s simplified since we only look at the number of files changed each commit, with each file having an equal probability.

Read more about entropy on our blog.

Installation

Commit Entropy currently supports Python 3.x. It can be installed using pip.

pip install commit-entropy

This will install the commit-entropy executable on your path.

If you don’t have pip, you can install it manually by cloning the code and running the install script:

git clone git@github.com:GripQA/commit-entropy.git
cd commit-entropy
python setup.py install

Usage

Currently we support a single operation: exporting a csv file with the average entropy per day and a 30-day rolling average. From within a git repo:

commit-entropy csv

This will output a entropy.csv file in the current directory with the average entropy values.

You can ignore a list of paths by using the --ignore option:

commit-entropy csv --ignore=vendor/*,*.log

Support

If you have any questions, problems, or suggestions, please submit an issue or contact us at support@grip.qa.

Project details


Release history Release notifications

This version
History Node

0.2.0

History Node

0.1.1

History Node

0.1.0

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
commit-entropy-0.2.0.tar.gz (6.1 kB) Copy SHA256 hash SHA256 Source None Aug 5, 2015

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page