org.junit.experimental.max

Class MaxCore

java.lang.Object

org.junit.experimental.max.MaxCore

public class MaxCore
extends java.lang.Object

A replacement for JUnitCore, which keeps track of runtime and failure history, and reorders tests to maximize the chances that a failing test occurs early in the test run. The rules for sorting are:

1. Never-run tests first, in arbitrary order
2. Group remaining tests by the date at which they most recently failed.
3. Sort groups such that the most recent failure date is first, and never-failing tests are at the end.
4. Within a group, run the fastest tests first.

Field Summary

Fields

Modifier and Type	Field and Description
private MaxHistory	history
private static java.lang.String	MALFORMED_JUNIT_3_TEST_CLASS_PREFIX

Constructor Summary

Constructors

Modifier	Constructor and Description
private	MaxCore(java.io.File storedResults)

Method Summary

Modifier and Type	Method and Description
private Runner	buildRunner(Description each)
private Request	constructLeafRequest(java.util.List<Description> leaves)
private void	findLeaves(Description parent, Description description, java.util.List<Description> results)
private java.util.List<Description>	findLeaves(Request request)
static MaxCore	forFolder(java.lang.String folderName) Deprecated. use storedLocally()
private java.lang.Class<?>	getMalformedTestClass(Description each)
Result	run(java.lang.Class<?> testClass) Run all the tests in class.
Result	run(Request request) Run all the tests contained in request.
Result	run(Request request, JUnitCore core) Run all the tests contained in request.
java.util.List<Description>	sortedLeavesForTest(Request request)
Request	sortRequest(Request request)
static MaxCore	storedLocally(java.io.File storedResults) Create a new MaxCore from a serialized file stored at storedResults

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

MALFORMED_JUNIT_3_TEST_CLASS_PREFIX

private static final java.lang.String MALFORMED_JUNIT_3_TEST_CLASS_PREFIX

See Also:

Constant Field Values

history

private final MaxHistory history

Constructor Detail

MaxCore

private MaxCore(java.io.File storedResults)

Method Detail

forFolder

@Deprecated
public static MaxCore forFolder(java.lang.String folderName)

Deprecated. use storedLocally()

Create a new MaxCore from a serialized file stored at storedResults

storedLocally

public static MaxCore storedLocally(java.io.File storedResults)

Create a new MaxCore from a serialized file stored at storedResults

run

public Result run(java.lang.Class<?> testClass)

Run all the tests in class.

Returns:

a Result describing the details of the test run and the failed tests.

run

public Result run(Request request)

Run all the tests contained in request.

Parameters:

request - the request describing tests

Returns:

a Result describing the details of the test run and the failed tests.

run

public Result run(Request request,
                  JUnitCore core)

Run all the tests contained in request. This variant should be used if core has attached listeners that this run should notify.

Parameters:

request - the request describing tests

core - a JUnitCore to delegate to.

Returns:

a Result describing the details of the test run and the failed tests.

sortRequest

public Request sortRequest(Request request)

Returns:

a new Request, which contains all of the same tests, but in a new order.

constructLeafRequest

private Request constructLeafRequest(java.util.List<Description> leaves)

buildRunner

private Runner buildRunner(Description each)

getMalformedTestClass

private java.lang.Class<?> getMalformedTestClass(Description each)

sortedLeavesForTest

public java.util.List<Description> sortedLeavesForTest(Request request)

Parameters:

request - a request to run

Returns:

a list of method-level tests to run, sorted in the order specified in the class comment.

findLeaves

private java.util.List<Description> findLeaves(Request request)

findLeaves

private void findLeaves(Description parent,
                        Description description,
                        java.util.List<Description> results)