README.md

Usage

BUILD.bazel

load("@build_bazel_integration_testing//:bazel_integration_test.bzl", "bazel_java_integration_test")
bazel_java_integration_test(
    name = "MyTest",
    srcs = ["MyTest.java"],
)

If you want your test to be in a different JVM language you can use the following:

bazel_java_integration_test(
    name = "MyScalaTest",
    test_class = "com.example.tests.integration.MyTestFromScala",
    runtime_deps = [":MyScalaTestSrc"],
)

Where MyScalaTestSrc is a scala_library you add yourself and has com.example.tests.integration.MyTestFromScala class.

Test

Note your test class must be run by JUnit as its run by java_test.
Very simplistic example:

import static org.junit.Assert.assertNotEquals;
import static org.junit.Assert.assertTrue;

import build.bazel.tests.integration.BazelCommand;
import build.bazel.tests.integration.WorkspaceDriver;

import java.io.IOException;
import org.junit.Before;
import org.junit.BeforeClass;
import org.junit.Test;

public class ExampleTest {
  private WorkspaceDriver driver = new WorkspaceDriver();

  @BeforeClass
  public static void setUpClass() throws IOException {
    WorkspaceDriver.setUpClass();
  }

  @Before
  public void setUp() throws Exception {
    driver.setUp();
  }

  @Test
  public void bazelFailure() throws Exception {
    driver.scratchFile(".bazelrc", "build --test_output=all");
    driver.scratchFile("foo/BUILD", "sh_test(name = \"bar\",\n" + "srcs = [\"bar.sh\"])");
    driver.scratchExecutableFile("foo/bar.sh", "echo \"boom\"", "exit -1");

    BazelCommand cmd = driver.bazel("test", "//foo:bar").run();

    assertNotEquals("bazel test return code", 0, cmd.exitCode());
    assertTrue(
        "stderr contains boom failure",
        cmd.outputLines().stream().anyMatch(x -> x.contains("boom")));
  }
}

In your test you should work with the WorkspaceDriver which has many useful utility methods for working with scratch workspaces.
These include, but are not limited to, copyFromRunfiles/scratchFile/workspaceDirectoryContents(useful for verbose error messages) and of course bazelCommand which allows you to run bazel build / bazel test / bazel query and more.
The WorkspaceDriverIntegrationTest has a few examples of realistic tests which sets up the environment and asserts Bazel's outputs (exit code, stderr, etc).
WorkspaceDriverTest and BazelBaseTestCaseTest show some more of the features.