The setup-testlens action connects a Maven or Gradle build to TestLens.

The TestLens GitHub App needs to be installed on the repository.

For Gradle, the action should be added right after the setup-gradle action in all workflow files that should be instrumented:

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: actions/setup-java@v5
        with:
          distribution: temurin
          java-version: 8 # or later
      - uses: gradle/actions/setup-gradle@v5
      - uses: testlens-app/setup-testlens@v1
      - run: ./gradlew build

The action writes a Gradle init script that instruments all Test tasks.

For Maven, the action needs to be added before the first call to mvn that should be instrumented. We recommend adding it right after actions/setup-java or a similar action that ensures the required version of Java is available.

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: actions/setup-java@v5
        with:
          distribution: temurin
          java-version: 8 # or later
      - uses: testlens-app/setup-testlens@v1
      - run: mvn verify

The action expects the root parent POM to be present in the root directory of the repository. It alters the POM by adding a profile that instruments all executions of the maven-surefire-plugin and maven-failsafe-plugin.