Skip to content

diff-jjoules is a tool to run in your continuous integration to measure the impact of commits on the energy consumption of the program 🌱

License

Notifications You must be signed in to change notification settings

davidson-consulting/diff-jjoules

Repository files navigation

Diff-JJoules · tests Maintainability Rating codecov

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:

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.

About

diff-jjoules is a tool to run in your continuous integration to measure the impact of commits on the energy consumption of the program 🌱

Topics

Resources

License

Stars

Watchers

Forks

Languages