Class LauncherConstants
- java.lang.Object
-
- org.junit.platform.launcher.LauncherConstants
-
@API(status=STABLE, since="1.7") public class LauncherConstants extends java.lang.Object
Collection of constants related toLauncher
.- Since:
- 1.3
- See Also:
ConfigurationParameters
-
-
Field Summary
Fields Modifier and Type Field Description static int
CAPTURE_MAX_BUFFER_DEFAULT
Default maximum number of bytes for buffering to use per thread and output type if output capturing is enabled.static java.lang.String
CAPTURE_MAX_BUFFER_PROPERTY_NAME
Property name used to configure the maximum number of bytes for buffering to use per thread and output type if output capturing is enabled: "junit.platform.output.capture.maxBuffer"static java.lang.String
CAPTURE_STDERR_PROPERTY_NAME
Property name used to enable capturing output toSystem.err
: "junit.platform.output.capture.stderr"static java.lang.String
CAPTURE_STDOUT_PROPERTY_NAME
Property name used to enable capturing output toSystem.out
: "junit.platform.output.capture.stdout"static java.lang.String
DEACTIVATE_ALL_LISTENERS_PATTERN
Wildcard pattern which signals that all listeners registered via theServiceLoader
mechanism should be deactivated: "*"static java.lang.String
DEACTIVATE_LISTENERS_PATTERN_PROPERTY_NAME
Property name used to provide patterns for deactivating listeners registered via theServiceLoader
mechanism: "junit.platform.execution.listeners.deactivate"static java.lang.String
DRY_RUN_PROPERTY_NAME
Property name used to enable dry-run mode for test execution.static java.lang.String
ENABLE_LAUNCHER_INTERCEPTORS
Property name used to enable support forLauncherInterceptor
instances to be registered via theServiceLoader
mechanism: "junit.platform.launcher.interceptors.enabled"static java.lang.String
STACKTRACE_PRUNING_ENABLED_PROPERTY_NAME
Property name used to enable or disable stack trace pruning.static java.lang.String
STDERR_REPORT_ENTRY_KEY
Key used to publish captured output toSystem.err
as part of aReportEntry
: "stderr"static java.lang.String
STDOUT_REPORT_ENTRY_KEY
Key used to publish captured output toSystem.out
as part of aReportEntry
: "stdout"
-
Constructor Summary
Constructors Modifier Constructor Description private
LauncherConstants()
-
-
-
Field Detail
-
CAPTURE_STDOUT_PROPERTY_NAME
public static final java.lang.String CAPTURE_STDOUT_PROPERTY_NAME
Property name used to enable capturing output toSystem.out
: "junit.platform.output.capture.stdout"By default, output to
System.out
is not captured.If enabled, the JUnit Platform captures the corresponding output and publishes it as a
ReportEntry
using the "stdout" key immediately before reporting the test identifier as finished.
-
CAPTURE_STDERR_PROPERTY_NAME
public static final java.lang.String CAPTURE_STDERR_PROPERTY_NAME
Property name used to enable capturing output toSystem.err
: "junit.platform.output.capture.stderr"By default, output to
System.err
is not captured.If enabled, the JUnit Platform captures the corresponding output and publishes it as a
ReportEntry
using the "stderr" key immediately before reporting the test identifier as finished.
-
CAPTURE_MAX_BUFFER_PROPERTY_NAME
public static final java.lang.String CAPTURE_MAX_BUFFER_PROPERTY_NAME
Property name used to configure the maximum number of bytes for buffering to use per thread and output type if output capturing is enabled: "junit.platform.output.capture.maxBuffer"Value must be an integer; defaults to 4194304.
- See Also:
CAPTURE_MAX_BUFFER_DEFAULT
, Constant Field Values
-
CAPTURE_MAX_BUFFER_DEFAULT
public static final int CAPTURE_MAX_BUFFER_DEFAULT
Default maximum number of bytes for buffering to use per thread and output type if output capturing is enabled.
-
STDOUT_REPORT_ENTRY_KEY
public static final java.lang.String STDOUT_REPORT_ENTRY_KEY
Key used to publish captured output toSystem.out
as part of aReportEntry
: "stdout"- See Also:
- Constant Field Values
-
STDERR_REPORT_ENTRY_KEY
public static final java.lang.String STDERR_REPORT_ENTRY_KEY
Key used to publish captured output toSystem.err
as part of aReportEntry
: "stderr"- See Also:
- Constant Field Values
-
DEACTIVATE_LISTENERS_PATTERN_PROPERTY_NAME
public static final java.lang.String DEACTIVATE_LISTENERS_PATTERN_PROPERTY_NAME
Property name used to provide patterns for deactivating listeners registered via theServiceLoader
mechanism: "junit.platform.execution.listeners.deactivate"Pattern Matching Syntax
If the property value consists solely of an asterisk (
*
), all listeners will be deactivated. Otherwise, the property value will be treated as a comma-separated list of patterns where each individual pattern will be matched against the fully qualified class name (FQCN) of each registered listener. Any dot (.
) in a pattern will match against a dot (.
) or a dollar sign ($
) in a FQCN. Any asterisk (*
) will match against one or more characters in a FQCN. All other characters in a pattern will be matched one-to-one against a FQCN.Examples
*
: deactivates all listeners.org.junit.*
: deactivates every listener under theorg.junit
base package and any of its subpackages.*.MyListener
: deactivates every listener whose simple class name is exactlyMyListener
.*System*, *Dev*
: deactivates every listener whose FQCN containsSystem
orDev
.org.example.MyListener, org.example.TheirListener
: deactivates listeners whose FQCN is exactlyorg.example.MyListener
ororg.example.TheirListener
.
-
DEACTIVATE_ALL_LISTENERS_PATTERN
public static final java.lang.String DEACTIVATE_ALL_LISTENERS_PATTERN
Wildcard pattern which signals that all listeners registered via theServiceLoader
mechanism should be deactivated: "*"
-
ENABLE_LAUNCHER_INTERCEPTORS
@API(status=EXPERIMENTAL, since="1.10") public static final java.lang.String ENABLE_LAUNCHER_INTERCEPTORS
Property name used to enable support forLauncherInterceptor
instances to be registered via theServiceLoader
mechanism: "junit.platform.launcher.interceptors.enabled"By default, interceptor registration is disabled.
- See Also:
LauncherInterceptor
, Constant Field Values
-
DRY_RUN_PROPERTY_NAME
@API(status=EXPERIMENTAL, since="1.10") public static final java.lang.String DRY_RUN_PROPERTY_NAME
Property name used to enable dry-run mode for test execution.When dry-run mode is enabled, no tests will be executed. Instead, all registered
TestExecutionListeners
will receive events for all test descriptors that are part of the discoveredTestPlan
. All containers will be reported as successful and all tests as skipped. This can be useful to test changes in the configuration of a build or to verify a listener is called as expected without having to wait for all tests to be executed.Value must be either
true
orfalse
; defaults tofalse
.- See Also:
- Constant Field Values
-
STACKTRACE_PRUNING_ENABLED_PROPERTY_NAME
@API(status=EXPERIMENTAL, since="1.10") public static final java.lang.String STACKTRACE_PRUNING_ENABLED_PROPERTY_NAME
Property name used to enable or disable stack trace pruning.By default, stack trace pruning is enabled.
- See Also:
EngineExecutionOrchestrator
, Constant Field Values
-
-