This is a JUnit extension that ignores those tests that are not related with your last changes in your Git repository. This is not a new idea, since big companies, specially with big mono-repos have worked on it.
Martin Fowler also describes how to use the test impact to infer the minimum tests to run.
You can use it from Maven and Gradle projects in any Junit based project (written in any JVM based language: e.g Kotlin, Java, Scala)
These instructions will get you a copy of the project up and running on your local machine.
- JRE 8
- Git
- Maven or Gradle
- Master as a default base branch
Declare a new test dependency in your pom.xml
:
<dependency>
<groupId>org.walkmod</groupId>
<artifactId>junit4git</artifactId>
<version>${version}</version>
<scope>test</scope>
</dependency>
Add/Edit also the maven-surefire-plugin
adding the listener
property:
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<version>2.20.1</version>
<configuration>
<properties>
<property>
<name>listener</name>
<value>org.walkmod.junit4git.junit4.Junit4GitListener</value>
</property>
</properties>
</configuration>
</plugin>
Commit these changes into your master
branch.
git checkout master
git add pom.xml
git commit -m 'junit4git setup'
In this case, is preferable to use Junit5 because Gradle does not support to setup Junit listeners. However, there is a workaround for Junit4 and scalatest.
- Modify your
build.gradle
file with the following contents:
testCompile("org.walkmod:junit4git:${version}")
-
Moreover, you need to setup a different runner for your tests. Therefore, you need to add
@RunWith(Junit4GitRunner.class)
in all your tests classes. -
Setup the agent in your
build.gradle
file.
configurations {
agent
}
dependencies {
agent "org.walkmod:junit4git-agent:${version}"
}
test.doFirst {
jvmArgs "-javaagent:${configurations.agent.singleFile}"
}
Modify your build.gradle
file with the following
contents:
testCompile("org.walkmod:junit5git:${version}")
And then:
git checkout master
git add pom.xml
git commit -m 'junit4git setup'
- Modify your
build.gradle
file with the following contents:
testCompile("org.walkmod:scalatest4git_2.11:${version}")
-
Moreover, you need to setup a different runner for your tests. Therefore, you need to add
@RunWith(classOf[ScalaGitRunner])
in all your tests classes. -
Setup the agent in your
build.gradle
file.
configurations {
agent
}
dependencies {
agent "org.walkmod:junit4git-agent:${version}"
}
test.doFirst {
jvmArgs "-javaagent:${configurations.agent.singleFile}"
}
After having configured your build, run your master
branch tests.
mvn test -- or gradle check
.
.
[WARNING] Tests run: 4, Failures: 0, Errors: 0, Skipped: 0
A Test Impact Report is generated as a Git note at (refs/notes/tests
). You can
check the contents with:
export GIT_NOTES_REF=refs/notes/tests
git notes show
A report, similar to the next one, will be printed in your console.
[
{
"test": "CalculatorTest",
"method": "testSum",
"classes": [
"Calculator"
]
}
...
]
This report specifies classes that are instantiated for each one of your test methods.
After generating your test impact report, run the tests again (from the master branch or in a new local branch)
mvn tests -- or gradle check
.
.
[WARNING] Tests run: 0, Failures: 0, Errors: 0, Skipped: 4
VoilĂ ! You will see that all the tests have been skipped because there is no change that may affect in our test results.
However, if you add / modify new test files or modify an existing source file, only the affected tests are executed.
Tests can be run incrementally once the base testing report is generated. However, how can we make them updated every time a pull request is merged?
Our strategy consist of delegating this work to Travis with the following steps:
- Generate an OAuth token for your GitHub User. Go to
Settings > Developer Settings > Personal access tokens
. ThenGenerate new token
withrepo
permissions. Copy the generated token into the clipboard. - Add a new Travis Environment Variable. Go to your last build, and then:
More Options > Settings > Environment Variables
. Add an environment variable namedGITHUB_TOKEN
and paste the contents of your clipboad. - Edit your
.travis.yml
file adding the following contents:
before_install:
- echo -e "machine github.com\n login $GITHUB_TOKEN" >> ~/.netrc
after_script:
- git push origin refs/notes/tests:refs/notes/tests
- Commit your
.travis.yml
changes to master.
This project is licensed under The Apache Software License.
This is a Gradle project that you can easily build running
gradle build customFatJar
Or, if you want to generate a version to test it from a Maven project
gradle publishToMavenLocal
- The agent fails when Jacoco is Running.
By default, Jacoco is appending an agent before running tests. Jacoco agent needs to be disabled or added as first agent because it requires non-altered classes by other agents.
To disable jacoco:
test.extensions.findByType(JacocoTaskExtension.class).enabled = false
To setup as first agent: https://discuss.gradle.org/t/jacoco-gradle-adds-the-agent-last-to-jvm-args/7124/5