Diff-JJoules ·

diff-jjoules is a tool to be integrated in your continuous integration in order to

• measure the impact of commits on the energy consumption of the program
• break the build in case of an energy regression has been detected.

Prerequisites

• Java 8+
• Maven3

To use diff-jjoules, you need to install:

• TLPC-sensor and the maven plugin in examples/tlpc-sensor

Install

Then, you can install diff-jjoules:

git clone https://github.com/davidson-consulting/diff-jjoules.git
cd diff-jjoules
mvn clean install -DskipTest

You should also install the maven plugin, from diff-jjoules folder:

cd diff-jjoules-maven
mvn clean install -DskipTest

Usage

The easiest way to use diff-jjoules, you need to clone your project twice: one for the version before applying the commit, and one for the version after applying the commit. In the following, we consider path/v1 as the path to the version of the program before applying the commit, and path/v2 as the path to the version of the program after applying the commit.

You can run diff-jjoules with the following command line, from path/v1, where your pom.xml is:

mvn fr.davidson:diff-jjoules:diff-jjoules-maven -Dpath-dir-second-version=path/v2

Before running on your own project, wa advise to run the demo before.

Detailed Documentation

We provide a detailed documentation here.

Contributing

If you have any questions, remarks, suggestions or bug reports, please do not hesitate to open an issue. Diff-JJoules is licensed under GNU GPL. Contributions and pull requests are very welcome 😃. For more information on contributing, see the dedicated CONTRIBUTING.md.