TaskDef
A bundle of information used to request a Task
from a test
framework.
An array of TaskDef
is passed to Runner
's tasks
method,
which returns an array of Tasks
. Each returned task, when
executed, will run tests and suites determined by the test class name,
fingerprints, "explicitly specified" field, and selectors of one of the
passed TaskDef
s.
The "Explicitly specified" field means the user supplied a complete fully qualified test name, such as with the command:
> test-only com.mycompany.myproject.WholeNameSpec
as opposed to commands like:
> test-only *WholeNameSpec
or simply:
> test
The explicitlySpecified
field will be true for in the first
case, and false in the last two cases, because only in the first case was
the fully qualified test class name completely specified by the user. The
test framework can use this information to decide whether to ignore an
annotation requesting a class not be discovered.
The fingerprint
parameter indicates how the test suite was
identified as a test suite. This tasks
method may be called
with TaskDef
s containing the same value for
testClassName
but different fingerprints. For example, if both
a class and its companion object were test classes, the tasks
method could be passed an array containing TaskDef
s with the
same name but with a different value for fingerprint.isModule
.
A test framework may "reject" a requested task by returning no
Task
for that TaskDef
.
- Value parameters:
- explicitlySpecified
indicates whether the test class was explicitly specified by user.
- fingerprint
indicates how the test suite was identified as a test suite
- fullyQualifiedName
the fully qualified name of the test class to be run by the requested task
- selectors
a possibly empty array of
Selectors
determining suites and tests to run
Value members
Concrete methods
Indicates whether or not the test class requested by this
TaskDef
was "explicitly specified."
Indicates whether or not the test class requested by this
TaskDef
was "explicitly specified."
For more information on what explicitly specified means, see the main documentation for this class.
The fingerprint that the test class requested by this TaskDef
matches.
The fingerprint that the test class requested by this TaskDef
matches.
The fully qualified name of the test class requested by this
TaskDef
.
The fully qualified name of the test class requested by this
TaskDef
.
One to many selectors describing the nature of the Task
requested by this TaskDef
.
One to many selectors describing the nature of the Task
requested by this TaskDef
.
A Selector
can indicate a direct, such as command-line,
request from the user or a "rerun" of previously run tests. In the latter
case, the Selectors
would be taken from those passed in
events of a previous run or runs.