sbt.testing.Framework Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of test-interface Show documentation

test-interface

The newest version!

package sbt.testing;

/**
 * Interface implemented by test frameworks.
 */
public interface Framework {

  /**
   * A human-friendly name of the test framework that this object represents.
   */
  public String name();

  /**
   * An array of Fingerprints that specify how to identify test classes during
   * discovery.
   */
  public Fingerprint[] fingerprints();

  /**
   * Initiates a run.
   *
   * 
   * If a client invokes this method before a previously initiated run has completed,
   * the test framework may throw IllegalStateExceptionto indicate it
   * cannot perform the two runs concurrently.
   * 
   *
   * @param args the test-framework-specific arguments for the new run
   * @param remoteArgs the test-framework-specific remote arguments for the run in a forked JVM
   * @param testClassLoader a class loader to use when loading test classes during the run
   *
   * @return a Runner representing the newly started run.
   * @throws IllegalStateException if the test framework is unable to initiate a run because it is
   *            already performing a previously initiated run that has not yet completed.
   */
  public Runner runner(String[] args, String[] remoteArgs, ClassLoader testClassLoader);
}