rpau / junit4git   1.2

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. Then Generate new token with repo 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 named GITHUB_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