From 336d2daf3962651df2b178d063064207aa74a487da7deed8f6b3986f33ba5b00 Mon Sep 17 00:00:00 2001 From: Fridrich Strba Date: Mon, 4 Nov 2024 09:50:29 +0000 Subject: [PATCH] OBS-URL: https://build.opensuse.org/package/show/Java:packages/maven-surefire?expand=0&rev=52 --- maven-surefire-bootstrap-resources.patch | 1637 +++++++--------------- 1 file changed, 531 insertions(+), 1106 deletions(-) diff --git a/maven-surefire-bootstrap-resources.patch b/maven-surefire-bootstrap-resources.patch index 64de1ce..0f80a1e 100644 --- a/maven-surefire-bootstrap-resources.patch +++ b/maven-surefire-bootstrap-resources.patch @@ -1,35 +1,7 @@ -From 2384dbdd33075fbed6799b8e9e8ca59487e786ec Mon Sep 17 00:00:00 2001 -From: =?UTF-8?q?Fridrich=20=C5=A0trba?= -Date: Tue, 1 Oct 2024 07:32:40 +0200 -Subject: [PATCH] bootstrap resources - ---- - .../maven-failsafe-plugin/plugin-help.xml | 1084 ++++++++++++++ - .../META-INF/maven/plugin.xml | 1308 +++++++++++++++++ - .../maven_failsafe_plugin/HelpMojo.java | 448 ++++++ - .../maven-surefire-plugin/plugin-help.xml | 943 ++++++++++++ - .../META-INF/maven/plugin.xml | 1145 +++++++++++++++ - .../maven_surefire_plugin/HelpMojo.java | 448 ++++++ - .../plugin-help.xml | 496 +++++++ - .../META-INF/maven/plugin.xml | 958 ++++++++++++ - .../HelpMojo.java | 448 ++++++ - 9 files changed, 7278 insertions(+) - create mode 100644 maven-failsafe-plugin/src/main/filtered-resources/META-INF/maven/org.apache.maven.plugins/maven-failsafe-plugin/plugin-help.xml - create mode 100644 maven-failsafe-plugin/src/main/filtered-resources/META-INF/maven/plugin.xml - create mode 100644 maven-failsafe-plugin/src/main/java/org/apache/maven/plugin/maven_failsafe_plugin/HelpMojo.java - create mode 100644 maven-surefire-plugin/src/main/filtered-resources/META-INF/maven/org.apache.maven.plugins/maven-surefire-plugin/plugin-help.xml - create mode 100644 maven-surefire-plugin/src/main/filtered-resources/META-INF/maven/plugin.xml - create mode 100644 maven-surefire-plugin/src/main/java/org/apache/maven/plugin/maven_surefire_plugin/HelpMojo.java - create mode 100644 maven-surefire-report-plugin/src/main/filtered-resources/META-INF/maven/org.apache.maven.plugins/maven-surefire-report-plugin/plugin-help.xml - create mode 100644 maven-surefire-report-plugin/src/main/filtered-resources/META-INF/maven/plugin.xml - create mode 100644 maven-surefire-report-plugin/src/main/java/org/apache/maven/plugin/maven_surefire_report_plugin/HelpMojo.java - -diff --git a/maven-failsafe-plugin/src/main/filtered-resources/META-INF/maven/org.apache.maven.plugins/maven-failsafe-plugin/plugin-help.xml b/maven-failsafe-plugin/src/main/filtered-resources/META-INF/maven/org.apache.maven.plugins/maven-failsafe-plugin/plugin-help.xml -new file mode 100644 -index 000000000..3b4bb7649 ---- /dev/null -+++ b/maven-failsafe-plugin/src/main/filtered-resources/META-INF/maven/org.apache.maven.plugins/maven-failsafe-plugin/plugin-help.xml -@@ -0,0 +1,1084 @@ +diff -urEbwBN a/maven-failsafe-plugin/src/main/filtered-resources/META-INF/maven/org.apache.maven.plugins/maven-failsafe-plugin/plugin-help.xml b/maven-failsafe-plugin/src/main/filtered-resources/META-INF/maven/org.apache.maven.plugins/maven-failsafe-plugin/plugin-help.xml +--- a/maven-failsafe-plugin/src/main/filtered-resources/META-INF/maven/org.apache.maven.plugins/maven-failsafe-plugin/plugin-help.xml 1970-01-01 01:00:00.000000000 +0100 ++++ b/maven-failsafe-plugin/src/main/filtered-resources/META-INF/maven/org.apache.maven.plugins/maven-failsafe-plugin/plugin-help.xml 2024-11-04 10:43:47.030374365 +0100 +@@ -0,0 +1,953 @@ + + + @@ -114,47 +86,30 @@ index 000000000..3b4bb7649 + + additionalClasspathDependencies + java.util.List<org.apache.maven.model.Dependency> -+ 3.2 + false + true -+ Additional Maven dependencies to be added to the test classpath at runtime. Each element supports the parametrization like documented in POM Reference: Dependencies <https://maven.apache.org/pom.html#dependencies>. -+Those dependencies are automatically collected (i.e. have their full dependency tree calculated) and then all underlying artifacts are resolved from the repository (including their transitive dependencies). Afterwards the resolved artifacts are filtered to only contain compile and runtime scoped ones and appended to the test classpath at runtime (after the ones from additionalClasspathElements). -+ -+The following differences to regular project dependency resolving apply: -+ -+* The dependency management from the project is not taken into account. -+* Conflicts between the different items and the project dependencies are not resolved. -+* Only external dependencies (outside the current Maven reactor) are supported. ++ + + + additionalClasspathElements + java.lang.String[] -+ 2.4 + false + true -+ Additional elements to be appended to the test classpath at runtime. Each element must be a file system path to a JAR file or a directory containing classes. No wildcards are allowed here. ++ + + + argLine + java.lang.String -+ 2.1 + false + true -+ Arbitrary JVM options to set on the command line. Only effective for forked executions. -+ -+Since the Version 2.17 using an alternate syntax for argLine, @{...} allows late replacement of properties when the plugin is executed, so properties that have been modified by other plugins will be picked up correctly. See the Frequently Asked Questions page with more details: -+http://maven.apache.org/surefire/maven-surefire-plugin/faq.html <http://maven.apache.org/surefire/maven-surefire-plugin/faq.html> -+http://maven.apache.org/surefire/maven-failsafe-plugin/faq.html <http://maven.apache.org/surefire/maven-failsafe-plugin/faq.html> -+See also: forkCount ++ + + + childDelegation + boolean -+ 2.1 + false + true -+ When false it makes tests run using the standard classloader delegation instead of the default Maven isolated classloader. Only used when forking (forkCount is greater than zero). -+Setting it to false helps with some problems caused by conflicts between xml parsers in the classpath and the Java 5 provider parser. ++ + + + classesDirectory @@ -166,27 +121,16 @@ index 000000000..3b4bb7649 + + classpathDependencyExcludes + java.lang.String[] -+ 2.6 + false + true -+ List of dependencies to exclude from the test classpath at runtime. Each item is passed as pattern to org.apache.maven.shared.artifact.filter.PatternIncludesArtifactFilter. The pattern is matched against the following artifact ids: -+* groupId:artifactId (Short ID) -+* groupId:artifactId:type:classifier (Dependency Conflict ID) -+* groupId:artifactId:type:classifier:version (Full ID) The matching algorithm is described in detail in Advanced Artifact-Matching <https://maven.apache.org/plugins/maven-assembly-plugin/advanced-descriptor-topics.html#advanced-artifact-matching-in-includes-and-excludes> for the maven-assembly-plugin. This parameter behaves the same as the excludes pattern described there. The dependency matching is applied to the project dependency IDs (including transitive ones) after resolving, i.e. excluding one dependency will not exclude its transitive dependencies! ++ + + + classpathDependencyScopeExclude + java.lang.String -+ 2.6 + false + true -+ A dependency scope to exclude from the test classpath at runtime. The scope should be one of the scopes defined by org.apache.maven.artifact.Artifact. This includes the following: -+ -+* compile - system, provided, compile -+* runtime - compile, runtime -+* compile+runtime - system, provided, compile, runtime -+* runtime+system - system, compile, runtime -+* test - system, provided, compile, runtime, test ++ + + + consoleOutputReporter @@ -206,51 +150,31 @@ index 000000000..3b4bb7649 + + dependenciesToScan + java.lang.String[] -+ 2.15 + false + true -+ List of dependencies to scan for test classes to include in the test run. The child elements of this element must be <dependency> elements, and the contents of each of these elements must be a string which follows the general form: -+groupId[:artifactId[:type[:classifier][:version]]] -+ -+The wildcard character * can be used within the sub parts of those composite identifiers to do glob-like pattern matching. The classifier may be omitted when matching dependencies without a classifier. -+ -+Examples: -+ -+* group or, equivalently, group:* -+* g*p:*rtifac* -+* group:*:jar -+* group:artifact:*:1.0.0 (no classifier) -+* group:*:test-jar:tests -+* *:artifact:*:*:1.0.0 -+Since version 2.22.0 you can scan for test classes from a project dependency of your multi-module project. -+ -+In versions before 3.0.0-M4, only groupId:artifactId is supported. -+ ++ + + + disableXmlReport -+ boolean -+ 2.2 ++ java.lang.Boolean + No reason given + false + true -+ Flag to disable the generation of report files in xml format. Deprecated since 3.0.0-M4. Instead use disable within statelessTestsetReporter since of 3.0.0-M6. ++ + + + enableAssertions + boolean -+ 2.3.1 + false + true -+ By default, Surefire enables JVM assertions for the execution of your test cases. To disable the assertions, set this flag to "false". ++ + + + enableOutErrElements + boolean -+ 3.3.1 + false + true -+ Flag for including/excluding <system-out /> and <system-err /> elements for successfully passed tests in XML reports. Note that the default value may change to false is a future version. ++ + + + enableProcessChecker @@ -258,24 +182,23 @@ index 000000000..3b4bb7649 + 3.0.0-M4 + false + true -+ Since 3.0.0-M4 the process checkers are disabled. You can enable them namely by setting ping and native or all in this parameter. -+The checker is useful in situations when you kill the build on a CI system and you want the Surefire forked JVM to kill the tests asap and free all handlers on the file system been previously used by the JVM and by the tests. -+The ping should be safely used together with ZGC or Shenandoah Garbage Collector. Due to the ping relies on timing of the PING (triggered every 30 seconds), slow GCs may pause the timers and pretend that the parent process of the forked JVM does not exist. -+The native is very fast checker. It is useful mechanism on Unix based systems, Linux distributions and Alpine/BusyBox Linux. See the JIRA SUREFIRE-1631 <https://issues.apache.org/jira/browse/SUREFIRE-1631> for Windows issues. -+Another useful configuration parameter is forkedProcessTimeoutInSeconds. ++ Since 3.0.0-M4 the process checkers are disabled. You can enable them namely by setting ping and native or all in this parameter. ++The checker is useful in situations when you kill the build on a CI system and you want the Surefire forked JVM to kill the tests asap and free all handlers on the file system been previously used by the JVM and by the tests. ++The ping should be safely used together with ZGC or Shenandoah Garbage Collector. Due to the ping relies on timing of the PING (triggered every 30 seconds), slow GCs may pause the timers and pretend that the parent process of the forked JVM does not exist. ++The native is very fast checker. It is useful mechanism on Unix based systems, Linux distributions and Alpine/BusyBox Linux. See the JIRA SUREFIRE-1631 <https://issues.apache.org/jira/browse/SUREFIRE-1631> for Windows issues. ++Another useful configuration parameter is forkedProcessTimeoutInSeconds. +See the Frequently Asked Questions page with more details: -+http://maven.apache.org/surefire/maven-surefire-plugin/faq.html#kill-jvm <http://maven.apache.org/surefire/maven-surefire-plugin/faq.html#kill-jvm> -+http://maven.apache.org/surefire/maven-failsafe-plugin/faq.html#kill-jvm <http://maven.apache.org/surefire/maven-failsafe-plugin/faq.html#kill-jvm> -+Example of use: ++http://maven.apache.org/surefire/maven-surefire-plugin/faq.html#kill-jvm <http://maven.apache.org/surefire/maven-surefire-plugin/faq.html#kill-jvm> ++http://maven.apache.org/surefire/maven-failsafe-plugin/faq.html#kill-jvm <http://maven.apache.org/surefire/maven-failsafe-plugin/faq.html#kill-jvm> ++Example of use: +mvn test -Dfailsafe.enableProcessChecker=all + + + enablePropertiesElement + boolean -+ 3.3.1 + false + true -+ Flag for including/excluding <properties /> element for successfully passed tests in XML reports. ++ + + + encoding @@ -288,10 +211,9 @@ index 000000000..3b4bb7649 + + environmentVariables + java.util.Map<java.lang.String, java.lang.String> -+ 2.1.3 + false + true -+ Additional environment variables to set on the command line. ++ + + + excludeJUnit5Engines @@ -307,32 +229,28 @@ index 000000000..3b4bb7649 + 3.0.0-M4 + false + true -+ You can selectively exclude individual environment variables by enumerating their keys. -+The environment is a system-dependent mapping from keys to values which is inherited from the Maven process to the forked Surefire processes. The keys must literally (case sensitive) match in order to exclude their environment variable. -+Example to exclude three environment variables: ++ You can selectively exclude individual environment variables by enumerating their keys. ++The environment is a system-dependent mapping from keys to values which is inherited from the Maven process to the forked Surefire processes. The keys must literally (case sensitive) match in order to exclude their environment variable. ++Example to exclude three environment variables: +mvn test -Dfailsafe.excludedEnvironmentVariables=ACME1,ACME2,ACME3 + + + excludedGroups + java.lang.String -+ 2.2 + false + true -+ (TestNG/JUnit47 provider with JUnit4.8+ only and JUnit5+ provider since 2.22.0) Excluded groups/categories/tags. Any methods/classes/etc with one of the groups/categories/tags specified in this list will specifically not be run. -+For JUnit4, this parameter forces the use of the 4.7 provider. For JUnit5, this parameter forces the use of the JUnit platform provider. -+This parameter is ignored if the suiteXmlFiles parameter is specified. -+Since version 2.18.1 and JUnit 4.12, the @Category annotation type is automatically inherited from superclasses, see @java.lang.annotation.Inherited. Make sure that test class inheritance still makes sense together with @Category annotation of the JUnit 4.12 or higher appeared in superclass. ++ + + + excludes + java.util.List<java.lang.String> + false + true -+ A list of <exclude> elements specifying the tests (by pattern) that should be excluded in testing. When not specified and when the test parameter is not specified, the default excludes will be -+<excludes> <exclude>**/*$*</exclude> </excludes> (which excludes all inner classes). -+This parameter is ignored if the TestNG suiteXmlFiles parameter is specified. ++ A list of <exclude> elements specifying the tests (by pattern) that should be excluded in testing. When not specified and when the test parameter is not specified, the default excludes will be ++<excludes> <exclude>**/*$*</exclude> </excludes> (which excludes all inner classes). ++This parameter is ignored if the TestNG suiteXmlFiles parameter is specified. +Each exclude item may also contain a comma-separated sub-list of items, which will be treated as multiple <exclude> entries. -+Since 2.19 a complex syntax is supported in one parameter (JUnit 4, JUnit 4.7+, TestNG): <exclude>%regex[pkg.*Slow.*.class], Unstable*</exclude> ++Since 2.19 a complex syntax is supported in one parameter (JUnit 4, JUnit 4.7+, TestNG): <exclude>%regex[pkg.*Slow.*.class], Unstable*</exclude> +Notice that these values are relative to the directory containing generated test classes of the project being tested. This directory is declared by the parameter testClassesDirectory which defaults to the POM property ${project.build.testOutputDirectory}, typically src/test/java unless overridden. + + @@ -341,7 +259,7 @@ index 000000000..3b4bb7649 + 2.13 + false + true -+ A file containing exclude patterns, each in a next line. Blank lines, or lines starting with # are ignored. If excludes are also specified, these patterns are appended. Example with path, simple and regex excludes: */it/* **/DontRunIT.* %regex[.*IT.*|.*Not.*] ++ A file containing exclude patterns, each in a next line. Blank lines, or lines starting with # are ignored. If excludes are also specified, these patterns are appended. Example with path, simple and regex excludes: */it/* **/DontRunIT.* %regex[.*IT.*|.*Not.*] +Since 3.0.0-M6, method filtering support is provided in the exclusions file as well, example: pkg.SomeIT#testMethod + + @@ -364,22 +282,16 @@ index 000000000..3b4bb7649 + + failIfNoTests + boolean -+ 2.4 + false + true -+ Set this to "true" to cause a failure if there are no tests to run. Defaults to "false". ++ + + + forkCount + java.lang.String -+ 2.14 + false + true -+ Option to specify the number of VMs to fork in parallel in order to execute the tests. When terminated with "C", the number part is multiplied with the number of CPU cores. Floating point value are only accepted together with "C". If set to "0", no VM is forked and all tests are executed within the main process. -+ -+Example values: "1.5C", "4" -+ -+The system properties and the argLine of the forked processes may contain the place holder string ${surefire.forkNumber}, which is replaced with a fixed number for each of the parallel forks, ranging from 1 to the effective value of forkCount times the maximum number of parallel Surefire executions in maven parallel builds, i.e. the effective value of the -T command line argument of maven core. ++ + + + forkNode @@ -387,7 +299,7 @@ index 000000000..3b4bb7649 + 3.0.0-M5 + false + true -+ This parameter configures the forked node. Currently, you can select the communication protocol, i.e. process pipes or TCP/IP sockets. The plugin uses process pipes by default which will be turned to TCP/IP in the version 3.0.0. Alternatively, you can implement your own factory and SPI. ++ This parameter configures the forked node. Currently, you can select the communication protocol, i.e. process pipes or TCP/IP sockets. The plugin uses process pipes by default which will be turned to TCP/IP in the version 3.0.0. Alternatively, you can implement your own factory and SPI. +See the documentation for more details: +https://maven.apache.org/plugins/maven-surefire-plugin/examples/process-communication.html <https://maven.apache.org/plugins/maven-surefire-plugin/examples/process-communication.html> + @@ -410,13 +322,9 @@ index 000000000..3b4bb7649 + + groups + java.lang.String -+ 2.2 + false + true -+ (TestNG/JUnit47 provider with JUnit4.8+ only and JUnit5+ provider since 2.22.0) Groups/categories/tags for this test. Only classes/methods/etc decorated with one of the groups/categories/tags specified here will be included in test run, if specified. -+For JUnit4 tests, this parameter forces the use of the 4.7 provider. For JUnit5 tests, this parameter forces the use of the JUnit platform provider. -+This parameter is ignored if the suiteXmlFiles parameter is specified. -+Since version 2.18.1 and JUnit 4.12, the @Category annotation type is automatically inherited from superclasses, see @java.lang.annotation.Inherited. Make sure that test class inheritance still makes sense together with @Category annotation of the JUnit 4.12 or higher appeared in superclass. ++ + + + includeJUnit5Engines @@ -431,9 +339,9 @@ index 000000000..3b4bb7649 + java.util.List<java.lang.String> + false + true -+ A list of <include> elements specifying the test filter (by pattern) of tests which should be included in testing. If it is not specified and the test parameter is unspecified as well, the default includes is <includes> <include>**/IT*.java</include> <include>**/*IT.java</include> <include>**/*ITCase.java</include> </includes> ++ A list of <include> elements specifying the test filter (by pattern) of tests which should be included in testing. If it is not specified and the test parameter is unspecified as well, the default includes is <includes> <include>**/IT*.java</include> <include>**/*IT.java</include> <include>**/*ITCase.java</include> </includes> +Each include item may also contain a comma-separated sublist of items, which will be treated as multiple <include> entries. -+Since 2.19 a complex syntax is supported in one parameter (JUnit 4, JUnit 4.7+, TestNG): <include>%regex[.*[Cat|Dog].*], Basic????, !Unstable*</include> <include>%regex[.*[Cat|Dog].*], !%regex[pkg.*Slow.*.class], pkg/**/*Fast*.java</include> ++Since 2.19 a complex syntax is supported in one parameter (JUnit 4, JUnit 4.7+, TestNG): <include>%regex[.*[Cat|Dog].*], Basic????, !Unstable*</include> <include>%regex[.*[Cat|Dog].*], !%regex[pkg.*Slow.*.class], pkg/**/*Fast*.java</include> +This parameter is ignored if the TestNG suiteXmlFiles parameter is specified. + +Notice that these values are relative to the directory containing generated test classes of the project being tested. This directory is declared by the parameter testClassesDirectory which defaults to the POM property ${project.build.testOutputDirectory}, typically src/test/java unless overridden. @@ -444,68 +352,50 @@ index 000000000..3b4bb7649 + 2.13 + false + true -+ A file containing include patterns, each in a next line. Blank lines, or lines starting with # are ignored. If includes are also specified, these patterns are appended. Example with path, simple and regex includes: */it/* **/NotIncludedByDefault.java %regex[.*IT.*|.*Not.*] ++ A file containing include patterns, each in a next line. Blank lines, or lines starting with # are ignored. If includes are also specified, these patterns are appended. Example with path, simple and regex includes: */it/* **/NotIncludedByDefault.java %regex[.*IT.*|.*Not.*] +Since 3.0.0-M6, method filtering support is provided in the inclusions file as well, example: pkg.SomeIT#testMethod + + + jdkToolchain + java.util.Map<java.lang.String, java.lang.String> -+ 3.0.0-M5 and Maven 3.3.x + false + true -+ -+Allow for configuration of the test jvm via maven toolchains. This permits a configuration where the project is built with one jvm and tested with another. This is similar to jvm, but avoids hardcoding paths. The two parameters are mutually exclusive (jvm wins) -+ -+Examples: -+(see Guide to Toolchains <https://maven.apache.org/guides/mini/guide-using-toolchains.html> for more info) <configuration> ... <jdkToolchain> <version>1.11</version> </jdkToolchain> </configuration> <configuration> ... <jdkToolchain> <version>1.8</version> <vendor>zulu</vendor> </jdkToolchain> </configuration> ++ + + + junitArtifactName + java.lang.String -+ 2.3.1 + false + true -+ Allows you to specify the name of the JUnit artifact. If not set, junit:junit will be used. ++ + + + jvm + java.lang.String -+ 2.1 + false + true -+ Option to specify the jvm (or path to the java executable) to use with the forking options. For the default, the jvm will be a new instance of the same VM as the one used to run Maven. JVM settings are not inherited from MAVEN_OPTS. ++ + + + objectFactory + java.lang.String -+ 2.5 + false + true -+ (TestNG only) Define the factory class used to create all test instances. ++ + + + parallel + java.lang.String -+ 2.2 + false + true -+ (TestNG provider) When you use the parameter parallel, TestNG will try to run all your test methods in separate threads, except for methods that depend on each other, which will be run in the same thread in order to respect their order of execution. Supports two values: classes or methods. -+(JUnit 4.7 provider) Supports values classes, methods, both to run in separate threads been controlled by threadCount. -+ -+Since version 2.16 (JUnit 4.7 provider), the value both is DEPRECATED. Use classesAndMethods instead. -+ -+Since version 2.16 (JUnit 4.7 provider), additional vales are available: -+suites, suitesAndClasses, suitesAndMethods, classesAndMethods, all. -+By default, Surefire does not execute tests in parallel. You can set the parameter parallel to none to explicitly disable parallel execution (e.g. when disabling parallel execution in special Maven profiles when executing coverage analysis). ++ + + + parallelOptimized + boolean -+ 2.17 + false + true -+ (JUnit 4.7 / provider only) The thread counts do not exceed the number of parallel suite, class runners and average number of methods per class if set to true. -+True by default. ++ + + + parallelTestsTimeoutForcedInSeconds @@ -513,7 +403,7 @@ index 000000000..3b4bb7649 + 2.16 + false + true -+ Stop executing queued parallel JUnit tests and interrupt currently running tests after a certain number of seconds. ++ Stop executing queued parallel JUnit tests and interrupt currently running tests after a certain number of seconds. +Example values: "3.5", "4" + +If set to 0, wait forever, never timing out. Makes sense with specified parallel different from "none". @@ -524,7 +414,7 @@ index 000000000..3b4bb7649 + 2.16 + false + true -+ Stop executing queued parallel JUnit tests after a certain number of seconds. ++ Stop executing queued parallel JUnit tests after a certain number of seconds. +Example values: "3.5", "4" + +If set to 0, wait forever, never timing out. Makes sense with specified parallel different from "none". @@ -532,10 +422,9 @@ index 000000000..3b4bb7649 + + perCoreThreadCount + boolean -+ 2.5 + false + true -+ (JUnit 4.7 provider) Indicates that threadCount, threadCountSuites, threadCountClasses, threadCountMethods are per cpu core. ++ + + + printSummary @@ -547,30 +436,23 @@ index 000000000..3b4bb7649 + + promoteUserPropertiesToSystemProperties + boolean -+ 3.4.0 + false + true -+ If set to true will also pass all user properties exposed via org.apache.maven.execution.MavenSession.getUserProperties() as system properties to a provider. Those always take precedence over same named system properties set via any other means. -+See also: systemPropertyVariables ++ + + + properties + java.util.Properties -+ 2.4 + false + true -+ List of properties for configuring the testing provider. This is the preferred method of configuring TestNG and JUnit platform providers. -+ -+JUnit platform properties may be defined in a configurationParameters element: <properties> <configurationParameters> junit.jupiter.execution.parallel.enabled = true junit.jupiter.execution.parallel.mode.default = concurrent </configurationParameters> </properties> -+TestNG properties may be defined as distinct element blocks: <properties> <property> <name>parallel</name> <value>methods</value> </property> </properties> ++ + + + redirectTestOutputToFile + boolean -+ 2.3 + false + true -+ Set this to "true" to redirect the unit test standard output to a file (found in reportsDirectory/testName-output.txt). ++ + + + reportFormat @@ -584,7 +466,7 @@ index 000000000..3b4bb7649 + java.lang.String + false + true -+ Add custom text into report filename: TEST-testClassName-reportNameSuffix.xml, testClassName-reportNameSuffix.txt and testClassName-reportNameSuffix-output.txt. File TEST-testClassName-reportNameSuffix.xml has changed attributes 'testsuite'--'name' and 'testcase'--'classname' - reportNameSuffix is added to the attribute value. ++ + + + reportsDirectory @@ -603,10 +485,9 @@ index 000000000..3b4bb7649 + + reuseForks + boolean -+ 2.13 + false + true -+ Indicates if forked VMs can be reused. If set to "false", a new VM is forked for each test class to be executed. If set to "true", up to forkCount VMs will be forked and then reused to execute all tests. ++ + + + runOrder @@ -614,13 +495,13 @@ index 000000000..3b4bb7649 + 2.7 + false + true -+ Defines the order the tests will be run in. Supported values are alphabetical, reversealphabetical, random, hourly (alphabetical on even hours, reverse alphabetical on odd hours), failedfirst, balanced and filesystem. ++ Defines the order the tests will be run in. Supported values are alphabetical, reversealphabetical, random, hourly (alphabetical on even hours, reverse alphabetical on odd hours), failedfirst, balanced and filesystem. + -+Odd/Even for hourly is determined at the time the of scanning the classpath, meaning it could change during a multi-module build. ++Odd/Even for hourly is determined at the time the of scanning the classpath, meaning it could change during a multi-module build. + -+Failed first will run tests that failed on previous run first, as well as new tests for this run. ++Failed first will run tests that failed on previous run first, as well as new tests for this run. + -+Balanced is only relevant with parallel=classes, and will try to optimize the run-order of the tests reducing the overall execution time. Initially a statistics file is created and every next test run will reorder classes. ++Balanced is only relevant with parallel=classes, and will try to optimize the run-order of the tests reducing the overall execution time. Initially a statistics file is created and every next test run will reorder classes. + +Note that the statistics are stored in a file named .surefire-XXXXXXXXX beside pom.xml and should not be checked into version control. The "XXXXX" is the SHA1 checksum of the entire surefire configuration, so different configurations will have different statistics files, meaning if you change any configuration settings you will re-run once before new statistics data can be established. + @@ -630,9 +511,9 @@ index 000000000..3b4bb7649 + 3.0.0-M6 + false + true -+ Sets the random seed that will be used to order the tests if failsafe.runOrder is set to random. ++ Sets the random seed that will be used to order the tests if failsafe.runOrder is set to random. + -+If no seeds are set and failsafe.runOrder is set to random, then the seed used will be outputted (search for "To reproduce ordering use flag -Dfailsafe.runOrder.random.seed"). ++If no seeds are set and failsafe.runOrder is set to random, then the seed used will be outputted (search for "To reproduce ordering use flag -Dfailsafe.runOrder.random.seed"). + +To deterministically reproduce any random test order that was run before, simply set the seed to be the same value. + @@ -642,11 +523,11 @@ index 000000000..3b4bb7649 + 2.19 + false + true -+ After the plugin process is shutdown by sending SIGTERM signal (CTRL+C), SHUTDOWN command is received by every forked JVM. -+The value is set to (shutdown=exit) by default (changed in version 3.0.0-M4). -+The parameter can be configured with other two values testset and kill. -+With(shutdown=testset) the test set may still continue to run in forked JVM. -+Using exit forked JVM executes System.exit(1) after the plugin process has received SIGTERM signal. ++ After the plugin process is shutdown by sending SIGTERM signal (CTRL+C), SHUTDOWN command is received by every forked JVM. ++The value is set to (shutdown=exit) by default (changed in version 3.0.0-M4). ++The parameter can be configured with other two values testset and kill. ++With(shutdown=testset) the test set may still continue to run in forked JVM. ++Using exit forked JVM executes System.exit(1) after the plugin process has received SIGTERM signal. +Using kill the JVM executes Runtime.halt(1) and kills itself. + + @@ -654,7 +535,7 @@ index 000000000..3b4bb7649 + boolean + false + true -+ Set this to "true" to bypass unit tests entirely. Its use is NOT RECOMMENDED, especially if you enable it using the "maven.test.skip" property, because maven.test.skip disables both running the tests and compiling the tests. Consider using the skipTests parameter instead. ++ + + + skipAfterFailureCount @@ -670,11 +551,10 @@ index 000000000..3b4bb7649 + + skipExec + boolean -+ 2.3 -+ Use skipTests instead. ++ No reason given + false + true -+ This old parameter is just like skipTests, but bound to the old property "maven.test.skip.exec". ++ + + + skipITs @@ -687,11 +567,9 @@ index 000000000..3b4bb7649 + + skipTests + boolean -+ 2.4 + false + true -+ Set this to "true" to skip running tests, but still compile them. Its use is NOT RECOMMENDED, but quite convenient on occasion. -+Failsafe plugin deprecated the parameter skipTests and the parameter will be removed in Failsafe 3.0.0 as it is a source of conflicts between Failsafe and Surefire plugin. ++ + + + statelessTestsetInfoReporter @@ -705,7 +583,7 @@ index 000000000..3b4bb7649 + org.apache.maven.plugin.surefire.extensions.SurefireStatelessReporter + false + true -+ Note: use the legacy system property disableXmlReport set to true to disable the report. ++ + + + suiteXmlFiles @@ -726,11 +604,10 @@ index 000000000..3b4bb7649 + + systemProperties + java.util.Properties -+ Use systemPropertyVariables instead. ++ No reason given + false + true -+ List of System properties to pass to a provider. -+See also: systemPropertyVariables for how the effective provider properties are calculated ++ + + + systemPropertiesFile @@ -743,43 +620,27 @@ index 000000000..3b4bb7649 + + systemPropertyVariables + java.util.Map<java.lang.String, java.lang.String> -+ 2.5 + false + true -+ List of System properties to pass to a provider. The effective system properties given to a provider are contributed from several sources: -+* properties set via argLine with -D (only for forked executions) -+* systemProperties -+* getSystemPropertiesFile() (set via parameter systemPropertiesFile on some goals) -+* systemPropertyVariables -+* User properties from org.apache.maven.execution.MavenSession.getUserProperties(), usually set via CLI options given with -D on the current Maven process (only used as source if promoteUserPropertiesToSystemProperties is true) Later sources may overwrite same named properties from earlier sources, that means for example that one cannot overwrite user properties with either systemProperties, getSystemPropertiesFile() or systemPropertyVariables. -+Certain properties may only be overwritten via argLine (applicable only for forked executions) because their values are cached and only evaluated at the start of the JRE. Those include: -+ -+* java.library.path -+* file.encoding -+* jdk.map.althashing.threshold -+* line.separator -+See also: systemProperties ++ + + + tempDir + java.lang.String -+ 2.20 + false + true -+ Relative path to temporary-surefire-boot directory containing internal Surefire temporary files. -+The temporary-surefire-boot directory is project.build.directory on most platforms or system default temporary-directory specified by the system property java.io.tmpdir on Windows (see SUREFIRE-1400 <https://issues.apache.org/jira/browse/SUREFIRE-1400>). -+It is deleted after the test set has completed. ++ + + + test + java.lang.String + false + true -+ Specify this parameter to run individual tests by file name, overriding parameter includes and excludes. Each pattern you specify here will be used to create an include pattern formatted like **/${it.test}.java, so you can just type -Dit.test=MyIT to run a single test file called "foo/MyIT.java". The test patterns prefixed with a ! will be excluded. -+This parameter overrides the parameter includes and excludes, and the TestNG parameter suiteXmlFiles. -+Since 2.7.3 You can execute a limited number of methods in the test with adding #myMethod or #my*ethod. E.g. type -Dit.test=MyIT#myMethod supported for junit 4.x and TestNg. -+Since 2.19 a complex syntax is supported in one parameter (JUnit 4, JUnit 4.7+, TestNG): "-Dit.test=???IT, !Unstable*, pkg/**/Ci*leIT.java, *IT#test*One+testTwo?????, #fast*+slowTest" or e.g. -+"-Dit.test=Basic*, !%regex[.*.Unstable.*], !%regex[.*.MyIT.class#one.*|two.*], %regex[#fast.*|slow.*]" ++ Specify this parameter to run individual tests by file name, overriding parameter includes and excludes. Each pattern you specify here will be used to create an include pattern formatted like **/${it.test}.java, so you can just type -Dit.test=MyIT to run a single test file called "foo/MyIT.java". The test patterns prefixed with a ! will be excluded. ++This parameter overrides the parameter includes and excludes, and the TestNG parameter suiteXmlFiles. ++Since 2.7.3 You can execute a limited number of methods in the test with adding #myMethod or #my*ethod. E.g. type -Dit.test=MyIT#myMethod supported for junit 4.x and TestNg. ++Since 2.19 a complex syntax is supported in one parameter (JUnit 4, JUnit 4.7+, TestNG): "-Dit.test=???IT, !Unstable*, pkg/**/Ci*leIT.java, *IT#test*One+testTwo?????, #fast*+slowTest" or e.g. ++"-Dit.test=Basic*, !%regex[.*.Unstable.*], !%regex[.*.MyIT.class#one.*|two.*], %regex[#fast.*|slow.*]" +The Parameterized JUnit runner describes test methods using an index in brackets, so the non-regex method pattern would become: #testMethod[*]. If using @Parameters(name="{index}: fib({0})={1}") and selecting the index e.g. 5 in pattern, the non-regex method pattern would become #testMethod[5:*]. + + @@ -787,74 +648,56 @@ index 000000000..3b4bb7649 + java.io.File + false + true -+ The directory containing generated test classes of the project being tested. This will be included at the beginning of the test classpath. ++ + + + testNGArtifactName + java.lang.String -+ 2.3.1 + false + true -+ Allows you to specify the name of the TestNG artifact. If not set, org.testng:testng will be used. ++ + + + testSourceDirectory + java.io.File -+ 2.2 + false + true -+ The test source directory containing test class sources. Important only for TestNG HTML reports. ++ + + + threadCount + int -+ 2.2 + false + true -+ (TestNG/JUnit 4.7 provider) The attribute thread-count allows you to specify how many threads should be allocated for this execution. Only makes sense to use in conjunction with the parallel parameter. ++ + + + threadCountClasses + int -+ 2.16 + false + true -+ (JUnit 4.7 provider) This attribute allows you to specify the concurrency in test classes, i.e.: -+* number of concurrent classes if threadCount is 0 or unspecified -+* limited classes concurrency if useUnlimitedThreads is set to true -+* if threadCount and certain thread-count parameters are > 0 for parallel, the concurrency is computed from ratio. For instance parallel=all and the ratio between threadCountSuites:threadCountClasses:threadCountMethods is 2:3:5, there is 30% of threadCount in concurrent classes. -+* as in the previous case but without this leaf thread-count. Example: parallel=suitesAndClasses, threadCount=16, threadCountSuites=5, threadCountClasses is unspecified leaf, the number of concurrent classes is varying from >= 11 to 14 or 15. The threadCountSuites become given number of threads. Only makes sense to use in conjunction with the parallel parameter. The default value 0 behaves same as unspecified one. ++ + + + threadCountMethods + int -+ 2.16 + false + true -+ (JUnit 4.7 provider) This attribute allows you to specify the concurrency in test methods, i.e.: -+* number of concurrent methods if threadCount is 0 or unspecified -+* limited concurrency of methods if useUnlimitedThreads is set to true -+* if threadCount and certain thread-count parameters are > 0 for parallel, the concurrency is computed from ratio. For instance parallel=all and the ratio between threadCountSuites:threadCountClasses:threadCountMethods is 2:3:5, there is 50% of threadCount which appears in concurrent methods. -+* as in the previous case but without this leaf thread-count. Example: parallel=all, threadCount=16, threadCountSuites=2, threadCountClasses=3, but threadCountMethods is unspecified leaf, the number of concurrent methods is varying from >= 11 to 14 or 15. The threadCountSuites and threadCountClasses become given number of threads. Only makes sense to use in conjunction with the parallel parameter. The default value 0 behaves same as unspecified one. ++ + + + threadCountSuites + int -+ 2.16 + false + true -+ (JUnit 4.7 provider) This attribute allows you to specify the concurrency in test suites, i.e.: -+* number of concurrent suites if threadCount is 0 or unspecified -+* limited suites concurrency if useUnlimitedThreads is set to true -+* if threadCount and certain thread-count parameters are > 0 for parallel, the concurrency is computed from ratio. For instance parallel=all and the ratio between threadCountSuites:threadCountClasses:threadCountMethods is 2:3:5, there is 20% of threadCount which appeared in concurrent suites. Only makes sense to use in conjunction with the parallel parameter. The default value 0 behaves same as unspecified one. ++ + + + trimStackTrace + boolean -+ 2.2 + false + true -+ Whether to trim the stack trace in the reports to just the lines within the test, or show the full trace. ++ + + + useFile @@ -869,7 +712,7 @@ index 000000000..3b4bb7649 + 2.4.3 + false + true -+ By default, Surefire forks your tests using a manifest-only JAR; set this parameter to "false" to force it to launch your tests with a plain old Java classpath. (See the http://maven.apache.org/plugins/maven-failsafe-plugin/examples/class-loading.html <http://maven.apache.org/plugins/maven-failsafe-plugin/examples/class-loading.html> for a more detailed explanation of manifest-only JARs and their benefits.) ++ By default, Surefire forks your tests using a manifest-only JAR; set this parameter to "false" to force it to launch your tests with a plain old Java classpath. (See the http://maven.apache.org/plugins/maven-failsafe-plugin/examples/class-loading.html <http://maven.apache.org/plugins/maven-failsafe-plugin/examples/class-loading.html> for a more detailed explanation of manifest-only JARs and their benefits.) +Beware, setting this to "false" may cause your tests to fail on Windows if your classpath is too long. + + @@ -878,7 +721,7 @@ index 000000000..3b4bb7649 + 3.0.0-M2 + false + true -+ When true, uses the modulepath when executing with JDK 9+ and module-info.java is present. When false, always uses the classpath. ++ When true, uses the modulepath when executing with JDK 9+ and module-info.java is present. When false, always uses the classpath. +Defaults to true. + + @@ -892,18 +735,16 @@ index 000000000..3b4bb7649 + + useUnlimitedThreads + boolean -+ 2.5 + false + true -+ (JUnit 4.7 provider) Indicates that the thread pool will be unlimited. The parallel parameter and the actual number of classes/methods will decide. Setting this to "true" effectively disables perCoreThreadCount and threadCount. Defaults to "false". ++ + + + workingDirectory + java.io.File -+ 2.1.3 + false + true -+ Command line working directory. ++ + + + @@ -914,7 +755,7 @@ index 000000000..3b4bb7649 + ${maven.test.dependency.excludes} + ${maven.failsafe.debug} + ${dependenciesToScan} -+ ${disableXmlReport} ++ ${disableXmlReport} + ${enableAssertions} + ${enableOutErrElements} + ${failsafe.enableProcessChecker} @@ -1114,12 +955,10 @@ index 000000000..3b4bb7649 + + + -diff --git a/maven-failsafe-plugin/src/main/filtered-resources/META-INF/maven/plugin.xml b/maven-failsafe-plugin/src/main/filtered-resources/META-INF/maven/plugin.xml -new file mode 100644 -index 000000000..6fff09c3b ---- /dev/null -+++ b/maven-failsafe-plugin/src/main/filtered-resources/META-INF/maven/plugin.xml -@@ -0,0 +1,1308 @@ +diff -urEbwBN a/maven-failsafe-plugin/src/main/filtered-resources/META-INF/maven/plugin.xml b/maven-failsafe-plugin/src/main/filtered-resources/META-INF/maven/plugin.xml +--- a/maven-failsafe-plugin/src/main/filtered-resources/META-INF/maven/plugin.xml 1970-01-01 01:00:00.000000000 +0100 ++++ b/maven-failsafe-plugin/src/main/filtered-resources/META-INF/maven/plugin.xml 2024-11-04 10:44:32.820687653 +0100 +@@ -0,0 +1,1175 @@ + + + @@ -1208,54 +1047,37 @@ index 000000000..6fff09c3b + + additionalClasspathDependencies + java.util.List -+ 3.2 + false + true -+ Additional Maven dependencies to be added to the test classpath at runtime. Each element supports the parametrization like documented in POM Reference: Dependencies <https://maven.apache.org/pom.html#dependencies>. -+Those dependencies are automatically collected (i.e. have their full dependency tree calculated) and then all underlying artifacts are resolved from the repository (including their transitive dependencies). Afterwards the resolved artifacts are filtered to only contain compile and runtime scoped ones and appended to the test classpath at runtime (after the ones from additionalClasspathElements). -+ -+The following differences to regular project dependency resolving apply: -+ -+* The dependency management from the project is not taken into account. -+* Conflicts between the different items and the project dependencies are not resolved. -+* Only external dependencies (outside the current Maven reactor) are supported. ++ + + + additionalClasspathElements + java.lang.String[] -+ 2.4 + false + true -+ Additional elements to be appended to the test classpath at runtime. Each element must be a file system path to a JAR file or a directory containing classes. No wildcards are allowed here. ++ + + + argLine + java.lang.String -+ 2.1 + false + true -+ Arbitrary JVM options to set on the command line. Only effective for forked executions. -+ -+Since the Version 2.17 using an alternate syntax for argLine, @{...} allows late replacement of properties when the plugin is executed, so properties that have been modified by other plugins will be picked up correctly. See the Frequently Asked Questions page with more details: -+http://maven.apache.org/surefire/maven-surefire-plugin/faq.html <http://maven.apache.org/surefire/maven-surefire-plugin/faq.html> -+http://maven.apache.org/surefire/maven-failsafe-plugin/faq.html <http://maven.apache.org/surefire/maven-failsafe-plugin/faq.html> -+See also: forkCount ++ + + + basedir + java.io.File + true + false -+ The base directory of the project being tested. This can be obtained in your integration test via System.getProperty("basedir"). ++ + + + childDelegation + boolean -+ 2.1 + false + true -+ When false it makes tests run using the standard classloader delegation instead of the default Maven isolated classloader. Only used when forking (forkCount is greater than zero). -+Setting it to false helps with some problems caused by conflicts between xml parsers in the classpath and the Java 5 provider parser. ++ + + + classesDirectory @@ -1267,27 +1089,16 @@ index 000000000..6fff09c3b + + classpathDependencyExcludes + java.lang.String[] -+ 2.6 + false + true -+ List of dependencies to exclude from the test classpath at runtime. Each item is passed as pattern to org.apache.maven.shared.artifact.filter.PatternIncludesArtifactFilter. The pattern is matched against the following artifact ids: -+* groupId:artifactId (Short ID) -+* groupId:artifactId:type:classifier (Dependency Conflict ID) -+* groupId:artifactId:type:classifier:version (Full ID) The matching algorithm is described in detail in Advanced Artifact-Matching <https://maven.apache.org/plugins/maven-assembly-plugin/advanced-descriptor-topics.html#advanced-artifact-matching-in-includes-and-excludes> for the maven-assembly-plugin. This parameter behaves the same as the excludes pattern described there. The dependency matching is applied to the project dependency IDs (including transitive ones) after resolving, i.e. excluding one dependency will not exclude its transitive dependencies! ++ + + + classpathDependencyScopeExclude + java.lang.String -+ 2.6 + false + true -+ A dependency scope to exclude from the test classpath at runtime. The scope should be one of the scopes defined by org.apache.maven.artifact.Artifact. This includes the following: -+ -+* compile - system, provided, compile -+* runtime - compile, runtime -+* compile+runtime - system, provided, compile, runtime -+* runtime+system - system, compile, runtime -+* test - system, provided, compile, runtime, test ++ + + + consoleOutputReporter @@ -1314,51 +1125,31 @@ index 000000000..6fff09c3b + + dependenciesToScan + java.lang.String[] -+ 2.15 + false + true -+ List of dependencies to scan for test classes to include in the test run. The child elements of this element must be <dependency> elements, and the contents of each of these elements must be a string which follows the general form: -+groupId[:artifactId[:type[:classifier][:version]]] -+ -+The wildcard character * can be used within the sub parts of those composite identifiers to do glob-like pattern matching. The classifier may be omitted when matching dependencies without a classifier. -+ -+Examples: -+ -+* group or, equivalently, group:* -+* g*p:*rtifac* -+* group:*:jar -+* group:artifact:*:1.0.0 (no classifier) -+* group:*:test-jar:tests -+* *:artifact:*:*:1.0.0 -+Since version 2.22.0 you can scan for test classes from a project dependency of your multi-module project. -+ -+In versions before 3.0.0-M4, only groupId:artifactId is supported. -+ ++ + + + disableXmlReport -+ boolean -+ 2.2 ++ java.lang.Boolean + No reason given + false + true -+ Flag to disable the generation of report files in xml format. Deprecated since 3.0.0-M4. Instead use disable within statelessTestsetReporter since of 3.0.0-M6. ++ + + + enableAssertions + boolean -+ 2.3.1 + false + true -+ By default, Surefire enables JVM assertions for the execution of your test cases. To disable the assertions, set this flag to "false". ++ + + + enableOutErrElements + boolean -+ 3.3.1 + false + true -+ Flag for including/excluding <system-out /> and <system-err /> elements for successfully passed tests in XML reports. Note that the default value may change to false is a future version. ++ + + + enableProcessChecker @@ -1366,24 +1157,23 @@ index 000000000..6fff09c3b + 3.0.0-M4 + false + true -+ Since 3.0.0-M4 the process checkers are disabled. You can enable them namely by setting ping and native or all in this parameter. -+The checker is useful in situations when you kill the build on a CI system and you want the Surefire forked JVM to kill the tests asap and free all handlers on the file system been previously used by the JVM and by the tests. -+The ping should be safely used together with ZGC or Shenandoah Garbage Collector. Due to the ping relies on timing of the PING (triggered every 30 seconds), slow GCs may pause the timers and pretend that the parent process of the forked JVM does not exist. -+The native is very fast checker. It is useful mechanism on Unix based systems, Linux distributions and Alpine/BusyBox Linux. See the JIRA SUREFIRE-1631 <https://issues.apache.org/jira/browse/SUREFIRE-1631> for Windows issues. -+Another useful configuration parameter is forkedProcessTimeoutInSeconds. ++ Since 3.0.0-M4 the process checkers are disabled. You can enable them namely by setting ping and native or all in this parameter. ++The checker is useful in situations when you kill the build on a CI system and you want the Surefire forked JVM to kill the tests asap and free all handlers on the file system been previously used by the JVM and by the tests. ++The ping should be safely used together with ZGC or Shenandoah Garbage Collector. Due to the ping relies on timing of the PING (triggered every 30 seconds), slow GCs may pause the timers and pretend that the parent process of the forked JVM does not exist. ++The native is very fast checker. It is useful mechanism on Unix based systems, Linux distributions and Alpine/BusyBox Linux. See the JIRA SUREFIRE-1631 <https://issues.apache.org/jira/browse/SUREFIRE-1631> for Windows issues. ++Another useful configuration parameter is forkedProcessTimeoutInSeconds. +See the Frequently Asked Questions page with more details: -+http://maven.apache.org/surefire/maven-surefire-plugin/faq.html#kill-jvm <http://maven.apache.org/surefire/maven-surefire-plugin/faq.html#kill-jvm> -+http://maven.apache.org/surefire/maven-failsafe-plugin/faq.html#kill-jvm <http://maven.apache.org/surefire/maven-failsafe-plugin/faq.html#kill-jvm> -+Example of use: ++http://maven.apache.org/surefire/maven-surefire-plugin/faq.html#kill-jvm <http://maven.apache.org/surefire/maven-surefire-plugin/faq.html#kill-jvm> ++http://maven.apache.org/surefire/maven-failsafe-plugin/faq.html#kill-jvm <http://maven.apache.org/surefire/maven-failsafe-plugin/faq.html#kill-jvm> ++Example of use: +mvn test -Dfailsafe.enableProcessChecker=all + + + enablePropertiesElement + boolean -+ 3.3.1 + false + true -+ Flag for including/excluding <properties /> element for successfully passed tests in XML reports. ++ + + + encoding @@ -1396,10 +1186,9 @@ index 000000000..6fff09c3b + + environmentVariables + java.util.Map -+ 2.1.3 + false + true -+ Additional environment variables to set on the command line. ++ + + + excludeJUnit5Engines @@ -1415,32 +1204,28 @@ index 000000000..6fff09c3b + 3.0.0-M4 + false + true -+ You can selectively exclude individual environment variables by enumerating their keys. -+The environment is a system-dependent mapping from keys to values which is inherited from the Maven process to the forked Surefire processes. The keys must literally (case sensitive) match in order to exclude their environment variable. -+Example to exclude three environment variables: ++ You can selectively exclude individual environment variables by enumerating their keys. ++The environment is a system-dependent mapping from keys to values which is inherited from the Maven process to the forked Surefire processes. The keys must literally (case sensitive) match in order to exclude their environment variable. ++Example to exclude three environment variables: +mvn test -Dfailsafe.excludedEnvironmentVariables=ACME1,ACME2,ACME3 + + + excludedGroups + java.lang.String -+ 2.2 + false + true -+ (TestNG/JUnit47 provider with JUnit4.8+ only and JUnit5+ provider since 2.22.0) Excluded groups/categories/tags. Any methods/classes/etc with one of the groups/categories/tags specified in this list will specifically not be run. -+For JUnit4, this parameter forces the use of the 4.7 provider. For JUnit5, this parameter forces the use of the JUnit platform provider. -+This parameter is ignored if the suiteXmlFiles parameter is specified. -+Since version 2.18.1 and JUnit 4.12, the @Category annotation type is automatically inherited from superclasses, see @java.lang.annotation.Inherited. Make sure that test class inheritance still makes sense together with @Category annotation of the JUnit 4.12 or higher appeared in superclass. ++ + + + excludes + java.util.List + false + true -+ A list of <exclude> elements specifying the tests (by pattern) that should be excluded in testing. When not specified and when the test parameter is not specified, the default excludes will be -+<excludes> <exclude>**/*$*</exclude> </excludes> (which excludes all inner classes). -+This parameter is ignored if the TestNG suiteXmlFiles parameter is specified. ++ A list of <exclude> elements specifying the tests (by pattern) that should be excluded in testing. When not specified and when the test parameter is not specified, the default excludes will be ++<excludes> <exclude>**/*$*</exclude> </excludes> (which excludes all inner classes). ++This parameter is ignored if the TestNG suiteXmlFiles parameter is specified. +Each exclude item may also contain a comma-separated sub-list of items, which will be treated as multiple <exclude> entries. -+Since 2.19 a complex syntax is supported in one parameter (JUnit 4, JUnit 4.7+, TestNG): <exclude>%regex[pkg.*Slow.*.class], Unstable*</exclude> ++Since 2.19 a complex syntax is supported in one parameter (JUnit 4, JUnit 4.7+, TestNG): <exclude>%regex[pkg.*Slow.*.class], Unstable*</exclude> +Notice that these values are relative to the directory containing generated test classes of the project being tested. This directory is declared by the parameter testClassesDirectory which defaults to the POM property ${project.build.testOutputDirectory}, typically src/test/java unless overridden. + + @@ -1449,7 +1234,7 @@ index 000000000..6fff09c3b + 2.13 + false + true -+ A file containing exclude patterns, each in a next line. Blank lines, or lines starting with # are ignored. If excludes are also specified, these patterns are appended. Example with path, simple and regex excludes: */it/* **/DontRunIT.* %regex[.*IT.*|.*Not.*] ++ A file containing exclude patterns, each in a next line. Blank lines, or lines starting with # are ignored. If excludes are also specified, these patterns are appended. Example with path, simple and regex excludes: */it/* **/DontRunIT.* %regex[.*IT.*|.*Not.*] +Since 3.0.0-M6, method filtering support is provided in the exclusions file as well, example: pkg.SomeIT#testMethod + + @@ -1472,22 +1257,16 @@ index 000000000..6fff09c3b + + failIfNoTests + boolean -+ 2.4 + false + true -+ Set this to "true" to cause a failure if there are no tests to run. Defaults to "false". ++ + + + forkCount + java.lang.String -+ 2.14 + false + true -+ Option to specify the number of VMs to fork in parallel in order to execute the tests. When terminated with "C", the number part is multiplied with the number of CPU cores. Floating point value are only accepted together with "C". If set to "0", no VM is forked and all tests are executed within the main process. -+ -+Example values: "1.5C", "4" -+ -+The system properties and the argLine of the forked processes may contain the place holder string ${surefire.forkNumber}, which is replaced with a fixed number for each of the parallel forks, ranging from 1 to the effective value of forkCount times the maximum number of parallel Surefire executions in maven parallel builds, i.e. the effective value of the -T command line argument of maven core. ++ + + + forkNode @@ -1495,7 +1274,7 @@ index 000000000..6fff09c3b + 3.0.0-M5 + false + true -+ This parameter configures the forked node. Currently, you can select the communication protocol, i.e. process pipes or TCP/IP sockets. The plugin uses process pipes by default which will be turned to TCP/IP in the version 3.0.0. Alternatively, you can implement your own factory and SPI. ++ This parameter configures the forked node. Currently, you can select the communication protocol, i.e. process pipes or TCP/IP sockets. The plugin uses process pipes by default which will be turned to TCP/IP in the version 3.0.0. Alternatively, you can implement your own factory and SPI. +See the documentation for more details: +https://maven.apache.org/plugins/maven-surefire-plugin/examples/process-communication.html <https://maven.apache.org/plugins/maven-surefire-plugin/examples/process-communication.html> + @@ -1518,13 +1297,9 @@ index 000000000..6fff09c3b + + groups + java.lang.String -+ 2.2 + false + true -+ (TestNG/JUnit47 provider with JUnit4.8+ only and JUnit5+ provider since 2.22.0) Groups/categories/tags for this test. Only classes/methods/etc decorated with one of the groups/categories/tags specified here will be included in test run, if specified. -+For JUnit4 tests, this parameter forces the use of the 4.7 provider. For JUnit5 tests, this parameter forces the use of the JUnit platform provider. -+This parameter is ignored if the suiteXmlFiles parameter is specified. -+Since version 2.18.1 and JUnit 4.12, the @Category annotation type is automatically inherited from superclasses, see @java.lang.annotation.Inherited. Make sure that test class inheritance still makes sense together with @Category annotation of the JUnit 4.12 or higher appeared in superclass. ++ + + + includeJUnit5Engines @@ -1539,9 +1314,9 @@ index 000000000..6fff09c3b + java.util.List + false + true -+ A list of <include> elements specifying the test filter (by pattern) of tests which should be included in testing. If it is not specified and the test parameter is unspecified as well, the default includes is <includes> <include>**/IT*.java</include> <include>**/*IT.java</include> <include>**/*ITCase.java</include> </includes> ++ A list of <include> elements specifying the test filter (by pattern) of tests which should be included in testing. If it is not specified and the test parameter is unspecified as well, the default includes is <includes> <include>**/IT*.java</include> <include>**/*IT.java</include> <include>**/*ITCase.java</include> </includes> +Each include item may also contain a comma-separated sublist of items, which will be treated as multiple <include> entries. -+Since 2.19 a complex syntax is supported in one parameter (JUnit 4, JUnit 4.7+, TestNG): <include>%regex[.*[Cat|Dog].*], Basic????, !Unstable*</include> <include>%regex[.*[Cat|Dog].*], !%regex[pkg.*Slow.*.class], pkg/**/*Fast*.java</include> ++Since 2.19 a complex syntax is supported in one parameter (JUnit 4, JUnit 4.7+, TestNG): <include>%regex[.*[Cat|Dog].*], Basic????, !Unstable*</include> <include>%regex[.*[Cat|Dog].*], !%regex[pkg.*Slow.*.class], pkg/**/*Fast*.java</include> +This parameter is ignored if the TestNG suiteXmlFiles parameter is specified. + +Notice that these values are relative to the directory containing generated test classes of the project being tested. This directory is declared by the parameter testClassesDirectory which defaults to the POM property ${project.build.testOutputDirectory}, typically src/test/java unless overridden. @@ -1552,75 +1327,57 @@ index 000000000..6fff09c3b + 2.13 + false + true -+ A file containing include patterns, each in a next line. Blank lines, or lines starting with # are ignored. If includes are also specified, these patterns are appended. Example with path, simple and regex includes: */it/* **/NotIncludedByDefault.java %regex[.*IT.*|.*Not.*] ++ A file containing include patterns, each in a next line. Blank lines, or lines starting with # are ignored. If includes are also specified, these patterns are appended. Example with path, simple and regex includes: */it/* **/NotIncludedByDefault.java %regex[.*IT.*|.*Not.*] +Since 3.0.0-M6, method filtering support is provided in the inclusions file as well, example: pkg.SomeIT#testMethod + + + jdkToolchain + java.util.Map -+ 3.0.0-M5 and Maven 3.3.x + false + true -+ -+Allow for configuration of the test jvm via maven toolchains. This permits a configuration where the project is built with one jvm and tested with another. This is similar to jvm, but avoids hardcoding paths. The two parameters are mutually exclusive (jvm wins) -+ -+Examples: -+(see Guide to Toolchains <https://maven.apache.org/guides/mini/guide-using-toolchains.html> for more info) <configuration> ... <jdkToolchain> <version>1.11</version> </jdkToolchain> </configuration> <configuration> ... <jdkToolchain> <version>1.8</version> <vendor>zulu</vendor> </jdkToolchain> </configuration> ++ + + + junitArtifactName + java.lang.String -+ 2.3.1 + false + true -+ Allows you to specify the name of the JUnit artifact. If not set, junit:junit will be used. ++ + + + jvm + java.lang.String -+ 2.1 + false + true -+ Option to specify the jvm (or path to the java executable) to use with the forking options. For the default, the jvm will be a new instance of the same VM as the one used to run Maven. JVM settings are not inherited from MAVEN_OPTS. ++ + + + objectFactory + java.lang.String -+ 2.5 + false + true -+ (TestNG only) Define the factory class used to create all test instances. ++ + + + parallel + java.lang.String -+ 2.2 + false + true -+ (TestNG provider) When you use the parameter parallel, TestNG will try to run all your test methods in separate threads, except for methods that depend on each other, which will be run in the same thread in order to respect their order of execution. Supports two values: classes or methods. -+(JUnit 4.7 provider) Supports values classes, methods, both to run in separate threads been controlled by threadCount. -+ -+Since version 2.16 (JUnit 4.7 provider), the value both is DEPRECATED. Use classesAndMethods instead. -+ -+Since version 2.16 (JUnit 4.7 provider), additional vales are available: -+suites, suitesAndClasses, suitesAndMethods, classesAndMethods, all. -+By default, Surefire does not execute tests in parallel. You can set the parameter parallel to none to explicitly disable parallel execution (e.g. when disabling parallel execution in special Maven profiles when executing coverage analysis). ++ + + + parallelMavenExecution + java.lang.Boolean + false + false -+ Parallel Maven Execution. ++ + + + parallelOptimized + boolean -+ 2.17 + false + true -+ (JUnit 4.7 / provider only) The thread counts do not exceed the number of parallel suite, class runners and average number of methods per class if set to true. -+True by default. ++ + + + parallelTestsTimeoutForcedInSeconds @@ -1628,7 +1385,7 @@ index 000000000..6fff09c3b + 2.16 + false + true -+ Stop executing queued parallel JUnit tests and interrupt currently running tests after a certain number of seconds. ++ Stop executing queued parallel JUnit tests and interrupt currently running tests after a certain number of seconds. +Example values: "3.5", "4" + +If set to 0, wait forever, never timing out. Makes sense with specified parallel different from "none". @@ -1639,7 +1396,7 @@ index 000000000..6fff09c3b + 2.16 + false + true -+ Stop executing queued parallel JUnit tests after a certain number of seconds. ++ Stop executing queued parallel JUnit tests after a certain number of seconds. +Example values: "3.5", "4" + +If set to 0, wait forever, never timing out. Makes sense with specified parallel different from "none". @@ -1647,25 +1404,23 @@ index 000000000..6fff09c3b + + perCoreThreadCount + boolean -+ 2.5 + false + true -+ (JUnit 4.7 provider) Indicates that threadCount, threadCountSuites, threadCountClasses, threadCountMethods are per cpu core. ++ + + + pluginArtifactMap + java.util.Map + true + false -+ Map of plugin artifacts. ++ + + + pluginDescriptor + org.apache.maven.plugin.descriptor.PluginDescriptor -+ 2.12 + true + false -+ Information about this plugin, mainly used to lookup this plugin's configuration from the currently executing project. ++ + + + printSummary @@ -1679,50 +1434,42 @@ index 000000000..6fff09c3b + org.apache.maven.project.MavenProject + true + false -+ The Maven Project Object. ++ + + + projectArtifactMap + java.util.Map + true + false -+ Map of project artifacts. ++ + + + projectBuildDirectory + java.io.File -+ 2.20 + true + false -+ Read-only parameter with value of Maven property project.build.directory. ++ + + + promoteUserPropertiesToSystemProperties + boolean -+ 3.4.0 + false + true -+ If set to true will also pass all user properties exposed via org.apache.maven.execution.MavenSession.getUserProperties() as system properties to a provider. Those always take precedence over same named system properties set via any other means. -+See also: systemPropertyVariables ++ + + + properties + java.util.Properties -+ 2.4 + false + true -+ List of properties for configuring the testing provider. This is the preferred method of configuring TestNG and JUnit platform providers. -+ -+JUnit platform properties may be defined in a configurationParameters element: <properties> <configurationParameters> junit.jupiter.execution.parallel.enabled = true junit.jupiter.execution.parallel.mode.default = concurrent </configurationParameters> </properties> -+TestNG properties may be defined as distinct element blocks: <properties> <property> <name>parallel</name> <value>methods</value> </property> </properties> ++ + + + redirectTestOutputToFile + boolean -+ 2.3 + false + true -+ Set this to "true" to redirect the unit test standard output to a file (found in reportsDirectory/testName-output.txt). ++ + + + reportFormat @@ -1736,7 +1483,7 @@ index 000000000..6fff09c3b + java.lang.String + false + true -+ Add custom text into report filename: TEST-testClassName-reportNameSuffix.xml, testClassName-reportNameSuffix.txt and testClassName-reportNameSuffix-output.txt. File TEST-testClassName-reportNameSuffix.xml has changed attributes 'testsuite'--'name' and 'testcase'--'classname' - reportNameSuffix is added to the attribute value. ++ + + + reportsDirectory @@ -1755,10 +1502,9 @@ index 000000000..6fff09c3b + + reuseForks + boolean -+ 2.13 + false + true -+ Indicates if forked VMs can be reused. If set to "false", a new VM is forked for each test class to be executed. If set to "true", up to forkCount VMs will be forked and then reused to execute all tests. ++ + + + runOrder @@ -1766,13 +1512,13 @@ index 000000000..6fff09c3b + 2.7 + false + true -+ Defines the order the tests will be run in. Supported values are alphabetical, reversealphabetical, random, hourly (alphabetical on even hours, reverse alphabetical on odd hours), failedfirst, balanced and filesystem. ++ Defines the order the tests will be run in. Supported values are alphabetical, reversealphabetical, random, hourly (alphabetical on even hours, reverse alphabetical on odd hours), failedfirst, balanced and filesystem. + -+Odd/Even for hourly is determined at the time the of scanning the classpath, meaning it could change during a multi-module build. ++Odd/Even for hourly is determined at the time the of scanning the classpath, meaning it could change during a multi-module build. + -+Failed first will run tests that failed on previous run first, as well as new tests for this run. ++Failed first will run tests that failed on previous run first, as well as new tests for this run. + -+Balanced is only relevant with parallel=classes, and will try to optimize the run-order of the tests reducing the overall execution time. Initially a statistics file is created and every next test run will reorder classes. ++Balanced is only relevant with parallel=classes, and will try to optimize the run-order of the tests reducing the overall execution time. Initially a statistics file is created and every next test run will reorder classes. + +Note that the statistics are stored in a file named .surefire-XXXXXXXXX beside pom.xml and should not be checked into version control. The "XXXXX" is the SHA1 checksum of the entire surefire configuration, so different configurations will have different statistics files, meaning if you change any configuration settings you will re-run once before new statistics data can be established. + @@ -1782,9 +1528,9 @@ index 000000000..6fff09c3b + 3.0.0-M6 + false + true -+ Sets the random seed that will be used to order the tests if failsafe.runOrder is set to random. ++ Sets the random seed that will be used to order the tests if failsafe.runOrder is set to random. + -+If no seeds are set and failsafe.runOrder is set to random, then the seed used will be outputted (search for "To reproduce ordering use flag -Dfailsafe.runOrder.random.seed"). ++If no seeds are set and failsafe.runOrder is set to random, then the seed used will be outputted (search for "To reproduce ordering use flag -Dfailsafe.runOrder.random.seed"). + +To deterministically reproduce any random test order that was run before, simply set the seed to be the same value. + @@ -1793,7 +1539,7 @@ index 000000000..6fff09c3b + org.apache.maven.execution.MavenSession + true + false -+ The current build session instance. ++ + + + shutdown @@ -1801,11 +1547,11 @@ index 000000000..6fff09c3b + 2.19 + false + true -+ After the plugin process is shutdown by sending SIGTERM signal (CTRL+C), SHUTDOWN command is received by every forked JVM. -+The value is set to (shutdown=exit) by default (changed in version 3.0.0-M4). -+The parameter can be configured with other two values testset and kill. -+With(shutdown=testset) the test set may still continue to run in forked JVM. -+Using exit forked JVM executes System.exit(1) after the plugin process has received SIGTERM signal. ++ After the plugin process is shutdown by sending SIGTERM signal (CTRL+C), SHUTDOWN command is received by every forked JVM. ++The value is set to (shutdown=exit) by default (changed in version 3.0.0-M4). ++The parameter can be configured with other two values testset and kill. ++With(shutdown=testset) the test set may still continue to run in forked JVM. ++Using exit forked JVM executes System.exit(1) after the plugin process has received SIGTERM signal. +Using kill the JVM executes Runtime.halt(1) and kills itself. + + @@ -1813,7 +1559,7 @@ index 000000000..6fff09c3b + boolean + false + true -+ Set this to "true" to bypass unit tests entirely. Its use is NOT RECOMMENDED, especially if you enable it using the "maven.test.skip" property, because maven.test.skip disables both running the tests and compiling the tests. Consider using the skipTests parameter instead. ++ + + + skipAfterFailureCount @@ -1829,11 +1575,10 @@ index 000000000..6fff09c3b + + skipExec + boolean -+ 2.3 -+ Use skipTests instead. ++ No reason given + false + true -+ This old parameter is just like skipTests, but bound to the old property "maven.test.skip.exec". ++ + + + skipITs @@ -1846,11 +1591,9 @@ index 000000000..6fff09c3b + + skipTests + boolean -+ 2.4 + false + true -+ Set this to "true" to skip running tests, but still compile them. Its use is NOT RECOMMENDED, but quite convenient on occasion. -+Failsafe plugin deprecated the parameter skipTests and the parameter will be removed in Failsafe 3.0.0 as it is a source of conflicts between Failsafe and Surefire plugin. ++ + + + statelessTestsetInfoReporter @@ -1864,7 +1607,7 @@ index 000000000..6fff09c3b + org.apache.maven.plugin.surefire.extensions.SurefireStatelessReporter + false + true -+ Note: use the legacy system property disableXmlReport set to true to disable the report. ++ + + + suiteXmlFiles @@ -1885,11 +1628,10 @@ index 000000000..6fff09c3b + + systemProperties + java.util.Properties -+ Use systemPropertyVariables instead. ++ No reason given + false + true -+ List of System properties to pass to a provider. -+See also: systemPropertyVariables for how the effective provider properties are calculated ++ + + + systemPropertiesFile @@ -1902,43 +1644,27 @@ index 000000000..6fff09c3b + + systemPropertyVariables + java.util.Map -+ 2.5 + false + true -+ List of System properties to pass to a provider. The effective system properties given to a provider are contributed from several sources: -+* properties set via argLine with -D (only for forked executions) -+* systemProperties -+* getSystemPropertiesFile() (set via parameter systemPropertiesFile on some goals) -+* systemPropertyVariables -+* User properties from org.apache.maven.execution.MavenSession.getUserProperties(), usually set via CLI options given with -D on the current Maven process (only used as source if promoteUserPropertiesToSystemProperties is true) Later sources may overwrite same named properties from earlier sources, that means for example that one cannot overwrite user properties with either systemProperties, getSystemPropertiesFile() or systemPropertyVariables. -+Certain properties may only be overwritten via argLine (applicable only for forked executions) because their values are cached and only evaluated at the start of the JRE. Those include: -+ -+* java.library.path -+* file.encoding -+* jdk.map.althashing.threshold -+* line.separator -+See also: systemProperties ++ + + + tempDir + java.lang.String -+ 2.20 + false + true -+ Relative path to temporary-surefire-boot directory containing internal Surefire temporary files. -+The temporary-surefire-boot directory is project.build.directory on most platforms or system default temporary-directory specified by the system property java.io.tmpdir on Windows (see SUREFIRE-1400 <https://issues.apache.org/jira/browse/SUREFIRE-1400>). -+It is deleted after the test set has completed. ++ + + + test + java.lang.String + false + true -+ Specify this parameter to run individual tests by file name, overriding parameter includes and excludes. Each pattern you specify here will be used to create an include pattern formatted like **/${it.test}.java, so you can just type -Dit.test=MyIT to run a single test file called "foo/MyIT.java". The test patterns prefixed with a ! will be excluded. -+This parameter overrides the parameter includes and excludes, and the TestNG parameter suiteXmlFiles. -+Since 2.7.3 You can execute a limited number of methods in the test with adding #myMethod or #my*ethod. E.g. type -Dit.test=MyIT#myMethod supported for junit 4.x and TestNg. -+Since 2.19 a complex syntax is supported in one parameter (JUnit 4, JUnit 4.7+, TestNG): "-Dit.test=???IT, !Unstable*, pkg/**/Ci*leIT.java, *IT#test*One+testTwo?????, #fast*+slowTest" or e.g. -+"-Dit.test=Basic*, !%regex[.*.Unstable.*], !%regex[.*.MyIT.class#one.*|two.*], %regex[#fast.*|slow.*]" ++ Specify this parameter to run individual tests by file name, overriding parameter includes and excludes. Each pattern you specify here will be used to create an include pattern formatted like **/${it.test}.java, so you can just type -Dit.test=MyIT to run a single test file called "foo/MyIT.java". The test patterns prefixed with a ! will be excluded. ++This parameter overrides the parameter includes and excludes, and the TestNG parameter suiteXmlFiles. ++Since 2.7.3 You can execute a limited number of methods in the test with adding #myMethod or #my*ethod. E.g. type -Dit.test=MyIT#myMethod supported for junit 4.x and TestNg. ++Since 2.19 a complex syntax is supported in one parameter (JUnit 4, JUnit 4.7+, TestNG): "-Dit.test=???IT, !Unstable*, pkg/**/Ci*leIT.java, *IT#test*One+testTwo?????, #fast*+slowTest" or e.g. ++"-Dit.test=Basic*, !%regex[.*.Unstable.*], !%regex[.*.MyIT.class#one.*|two.*], %regex[#fast.*|slow.*]" +The Parameterized JUnit runner describes test methods using an index in brackets, so the non-regex method pattern would become: #testMethod[*]. If using @Parameters(name="{index}: fib({0})={1}") and selecting the index e.g. 5 in pattern, the non-regex method pattern would become #testMethod[5:*]. + + @@ -1946,74 +1672,56 @@ index 000000000..6fff09c3b + java.io.File + false + true -+ The directory containing generated test classes of the project being tested. This will be included at the beginning of the test classpath. ++ + + + testNGArtifactName + java.lang.String -+ 2.3.1 + false + true -+ Allows you to specify the name of the TestNG artifact. If not set, org.testng:testng will be used. ++ + + + testSourceDirectory + java.io.File -+ 2.2 + false + true -+ The test source directory containing test class sources. Important only for TestNG HTML reports. ++ + + + threadCount + int -+ 2.2 + false + true -+ (TestNG/JUnit 4.7 provider) The attribute thread-count allows you to specify how many threads should be allocated for this execution. Only makes sense to use in conjunction with the parallel parameter. ++ + + + threadCountClasses + int -+ 2.16 + false + true -+ (JUnit 4.7 provider) This attribute allows you to specify the concurrency in test classes, i.e.: -+* number of concurrent classes if threadCount is 0 or unspecified -+* limited classes concurrency if useUnlimitedThreads is set to true -+* if threadCount and certain thread-count parameters are > 0 for parallel, the concurrency is computed from ratio. For instance parallel=all and the ratio between threadCountSuites:threadCountClasses:threadCountMethods is 2:3:5, there is 30% of threadCount in concurrent classes. -+* as in the previous case but without this leaf thread-count. Example: parallel=suitesAndClasses, threadCount=16, threadCountSuites=5, threadCountClasses is unspecified leaf, the number of concurrent classes is varying from >= 11 to 14 or 15. The threadCountSuites become given number of threads. Only makes sense to use in conjunction with the parallel parameter. The default value 0 behaves same as unspecified one. ++ + + + threadCountMethods + int -+ 2.16 + false + true -+ (JUnit 4.7 provider) This attribute allows you to specify the concurrency in test methods, i.e.: -+* number of concurrent methods if threadCount is 0 or unspecified -+* limited concurrency of methods if useUnlimitedThreads is set to true -+* if threadCount and certain thread-count parameters are > 0 for parallel, the concurrency is computed from ratio. For instance parallel=all and the ratio between threadCountSuites:threadCountClasses:threadCountMethods is 2:3:5, there is 50% of threadCount which appears in concurrent methods. -+* as in the previous case but without this leaf thread-count. Example: parallel=all, threadCount=16, threadCountSuites=2, threadCountClasses=3, but threadCountMethods is unspecified leaf, the number of concurrent methods is varying from >= 11 to 14 or 15. The threadCountSuites and threadCountClasses become given number of threads. Only makes sense to use in conjunction with the parallel parameter. The default value 0 behaves same as unspecified one. ++ + + + threadCountSuites + int -+ 2.16 + false + true -+ (JUnit 4.7 provider) This attribute allows you to specify the concurrency in test suites, i.e.: -+* number of concurrent suites if threadCount is 0 or unspecified -+* limited suites concurrency if useUnlimitedThreads is set to true -+* if threadCount and certain thread-count parameters are > 0 for parallel, the concurrency is computed from ratio. For instance parallel=all and the ratio between threadCountSuites:threadCountClasses:threadCountMethods is 2:3:5, there is 20% of threadCount which appeared in concurrent suites. Only makes sense to use in conjunction with the parallel parameter. The default value 0 behaves same as unspecified one. ++ + + + trimStackTrace + boolean -+ 2.2 + false + true -+ Whether to trim the stack trace in the reports to just the lines within the test, or show the full trace. ++ + + + useFile @@ -2028,7 +1736,7 @@ index 000000000..6fff09c3b + 2.4.3 + false + true -+ By default, Surefire forks your tests using a manifest-only JAR; set this parameter to "false" to force it to launch your tests with a plain old Java classpath. (See the http://maven.apache.org/plugins/maven-failsafe-plugin/examples/class-loading.html <http://maven.apache.org/plugins/maven-failsafe-plugin/examples/class-loading.html> for a more detailed explanation of manifest-only JARs and their benefits.) ++ By default, Surefire forks your tests using a manifest-only JAR; set this parameter to "false" to force it to launch your tests with a plain old Java classpath. (See the http://maven.apache.org/plugins/maven-failsafe-plugin/examples/class-loading.html <http://maven.apache.org/plugins/maven-failsafe-plugin/examples/class-loading.html> for a more detailed explanation of manifest-only JARs and their benefits.) +Beware, setting this to "false" may cause your tests to fail on Windows if your classpath is too long. + + @@ -2037,7 +1745,7 @@ index 000000000..6fff09c3b + 3.0.0-M2 + false + true -+ When true, uses the modulepath when executing with JDK 9+ and module-info.java is present. When false, always uses the classpath. ++ When true, uses the modulepath when executing with JDK 9+ and module-info.java is present. When false, always uses the classpath. +Defaults to true. + + @@ -2051,18 +1759,16 @@ index 000000000..6fff09c3b + + useUnlimitedThreads + boolean -+ 2.5 + false + true -+ (JUnit 4.7 provider) Indicates that the thread pool will be unlimited. The parallel parameter and the actual number of classes/methods will decide. Setting this to "true" effectively disables perCoreThreadCount and threadCount. Defaults to "false". ++ + + + workingDirectory + java.io.File -+ 2.1.3 + false + true -+ Command line working directory. ++ + + + @@ -2075,7 +1781,7 @@ index 000000000..6fff09c3b + ${maven.failsafe.debug} + + ${dependenciesToScan} -+ ${disableXmlReport} ++ ${disableXmlReport} + ${enableAssertions} + ${enableOutErrElements} + ${failsafe.enableProcessChecker} @@ -2319,22 +2025,10 @@ index 000000000..6fff09c3b + + + -+ org.apache.maven.surefire -+ surefire-api -+ jar -+ 3.5.0 -+ -+ + org.apache.commons + commons-lang3 + jar -+ 3.16.0 -+ -+ -+ org.apache.maven.surefire -+ surefire-logger-api -+ jar -+ 3.5.0 ++ 3.17.0 + + + org.apache.maven.shared @@ -2346,31 +2040,67 @@ index 000000000..6fff09c3b + commons-io + commons-io + jar -+ 2.16.1 ++ 2.17.0 ++ ++ ++ org.slf4j ++ slf4j-api ++ jar ++ 1.7.36 ++ ++ ++ org.apache.maven.surefire ++ surefire-api ++ jar ++ 3.5.2 ++ ++ ++ org.apache.maven.surefire ++ surefire-logger-api ++ jar ++ 3.5.2 + + + org.apache.maven.surefire + surefire-booter + jar -+ 3.5.0 ++ 3.5.2 + + + org.apache.maven.surefire + surefire-extensions-spi + jar -+ 3.5.0 ++ 3.5.2 + + + org.apache.maven.surefire + surefire-extensions-api + jar -+ 3.5.0 ++ 3.5.2 + + + org.apache.maven.surefire + maven-surefire-common + jar -+ 3.5.0 ++ 3.5.2 ++ ++ ++ org.codehaus.plexus ++ plexus-java ++ jar ++ 1.3.0 ++ ++ ++ org.ow2.asm ++ asm ++ jar ++ 9.6 ++ ++ ++ com.thoughtworks.qdox ++ qdox ++ jar ++ 2.0.3 + + + org.apache.commons @@ -2397,30 +2127,6 @@ index 000000000..6fff09c3b + 3.4.0 + + -+ org.codehaus.plexus -+ plexus-java -+ jar -+ 1.2.0 -+ -+ -+ org.ow2.asm -+ asm -+ jar -+ 9.6 -+ -+ -+ com.thoughtworks.qdox -+ qdox -+ jar -+ 2.0.3 -+ -+ -+ org.slf4j -+ slf4j-api -+ jar -+ 1.7.36 -+ -+ + org.apache.maven.resolver + maven-resolver-api + jar @@ -2428,11 +2134,9 @@ index 000000000..6fff09c3b + + + -diff --git a/maven-failsafe-plugin/src/main/java/org/apache/maven/plugin/maven_failsafe_plugin/HelpMojo.java b/maven-failsafe-plugin/src/main/java/org/apache/maven/plugin/maven_failsafe_plugin/HelpMojo.java -new file mode 100644 -index 000000000..272580024 ---- /dev/null -+++ b/maven-failsafe-plugin/src/main/java/org/apache/maven/plugin/maven_failsafe_plugin/HelpMojo.java +diff -urEbwBN a/maven-failsafe-plugin/src/main/java/org/apache/maven/plugin/maven_failsafe_plugin/HelpMojo.java b/maven-failsafe-plugin/src/main/java/org/apache/maven/plugin/maven_failsafe_plugin/HelpMojo.java +--- a/maven-failsafe-plugin/src/main/java/org/apache/maven/plugin/maven_failsafe_plugin/HelpMojo.java 1970-01-01 01:00:00.000000000 +0100 ++++ b/maven-failsafe-plugin/src/main/java/org/apache/maven/plugin/maven_failsafe_plugin/HelpMojo.java 2024-11-04 10:37:46.084598212 +0100 @@ -0,0 +1,448 @@ +package org.apache.maven.plugins.maven_failsafe_plugin; + @@ -2882,12 +2586,10 @@ index 000000000..272580024 + return null; + } +} -diff --git a/maven-surefire-plugin/src/main/filtered-resources/META-INF/maven/org.apache.maven.plugins/maven-surefire-plugin/plugin-help.xml b/maven-surefire-plugin/src/main/filtered-resources/META-INF/maven/org.apache.maven.plugins/maven-surefire-plugin/plugin-help.xml -new file mode 100644 -index 000000000..3d369f203 ---- /dev/null -+++ b/maven-surefire-plugin/src/main/filtered-resources/META-INF/maven/org.apache.maven.plugins/maven-surefire-plugin/plugin-help.xml -@@ -0,0 +1,943 @@ +diff -urEbwBN a/maven-surefire-plugin/src/main/filtered-resources/META-INF/maven/org.apache.maven.plugins/maven-surefire-plugin/plugin-help.xml b/maven-surefire-plugin/src/main/filtered-resources/META-INF/maven/org.apache.maven.plugins/maven-surefire-plugin/plugin-help.xml +--- a/maven-surefire-plugin/src/main/filtered-resources/META-INF/maven/org.apache.maven.plugins/maven-surefire-plugin/plugin-help.xml 1970-01-01 01:00:00.000000000 +0100 ++++ b/maven-surefire-plugin/src/main/filtered-resources/META-INF/maven/org.apache.maven.plugins/maven-surefire-plugin/plugin-help.xml 2024-11-04 10:47:52.325388910 +0100 +@@ -0,0 +1,812 @@ + + + @@ -2972,47 +2674,30 @@ index 000000000..3d369f203 + + additionalClasspathDependencies + java.util.List<org.apache.maven.model.Dependency> -+ 3.2 + false + true -+ Additional Maven dependencies to be added to the test classpath at runtime. Each element supports the parametrization like documented in POM Reference: Dependencies <https://maven.apache.org/pom.html#dependencies>. -+Those dependencies are automatically collected (i.e. have their full dependency tree calculated) and then all underlying artifacts are resolved from the repository (including their transitive dependencies). Afterwards the resolved artifacts are filtered to only contain compile and runtime scoped ones and appended to the test classpath at runtime (after the ones from additionalClasspathElements). -+ -+The following differences to regular project dependency resolving apply: -+ -+* The dependency management from the project is not taken into account. -+* Conflicts between the different items and the project dependencies are not resolved. -+* Only external dependencies (outside the current Maven reactor) are supported. ++ + + + additionalClasspathElements + java.lang.String[] -+ 2.4 + false + true -+ Additional elements to be appended to the test classpath at runtime. Each element must be a file system path to a JAR file or a directory containing classes. No wildcards are allowed here. ++ + + + argLine + java.lang.String -+ 2.1 + false + true -+ Arbitrary JVM options to set on the command line. Only effective for forked executions. -+ -+Since the Version 2.17 using an alternate syntax for argLine, @{...} allows late replacement of properties when the plugin is executed, so properties that have been modified by other plugins will be picked up correctly. See the Frequently Asked Questions page with more details: -+http://maven.apache.org/surefire/maven-surefire-plugin/faq.html <http://maven.apache.org/surefire/maven-surefire-plugin/faq.html> -+http://maven.apache.org/surefire/maven-failsafe-plugin/faq.html <http://maven.apache.org/surefire/maven-failsafe-plugin/faq.html> -+See also: forkCount ++ + + + childDelegation + boolean -+ 2.1 + false + true -+ When false it makes tests run using the standard classloader delegation instead of the default Maven isolated classloader. Only used when forking (forkCount is greater than zero). -+Setting it to false helps with some problems caused by conflicts between xml parsers in the classpath and the Java 5 provider parser. ++ + + + classesDirectory @@ -3024,27 +2709,16 @@ index 000000000..3d369f203 + + classpathDependencyExcludes + java.lang.String[] -+ 2.6 + false + true -+ List of dependencies to exclude from the test classpath at runtime. Each item is passed as pattern to org.apache.maven.shared.artifact.filter.PatternIncludesArtifactFilter. The pattern is matched against the following artifact ids: -+* groupId:artifactId (Short ID) -+* groupId:artifactId:type:classifier (Dependency Conflict ID) -+* groupId:artifactId:type:classifier:version (Full ID) The matching algorithm is described in detail in Advanced Artifact-Matching <https://maven.apache.org/plugins/maven-assembly-plugin/advanced-descriptor-topics.html#advanced-artifact-matching-in-includes-and-excludes> for the maven-assembly-plugin. This parameter behaves the same as the excludes pattern described there. The dependency matching is applied to the project dependency IDs (including transitive ones) after resolving, i.e. excluding one dependency will not exclude its transitive dependencies! ++ + + + classpathDependencyScopeExclude + java.lang.String -+ 2.6 + false + true -+ A dependency scope to exclude from the test classpath at runtime. The scope should be one of the scopes defined by org.apache.maven.artifact.Artifact. This includes the following: -+ -+* compile - system, provided, compile -+* runtime - compile, runtime -+* compile+runtime - system, provided, compile, runtime -+* runtime+system - system, compile, runtime -+* test - system, provided, compile, runtime, test ++ + + + consoleOutputReporter @@ -3064,51 +2738,31 @@ index 000000000..3d369f203 + + dependenciesToScan + java.lang.String[] -+ 2.15 + false + true -+ List of dependencies to scan for test classes to include in the test run. The child elements of this element must be <dependency> elements, and the contents of each of these elements must be a string which follows the general form: -+groupId[:artifactId[:type[:classifier][:version]]] -+ -+The wildcard character * can be used within the sub parts of those composite identifiers to do glob-like pattern matching. The classifier may be omitted when matching dependencies without a classifier. -+ -+Examples: -+ -+* group or, equivalently, group:* -+* g*p:*rtifac* -+* group:*:jar -+* group:artifact:*:1.0.0 (no classifier) -+* group:*:test-jar:tests -+* *:artifact:*:*:1.0.0 -+Since version 2.22.0 you can scan for test classes from a project dependency of your multi-module project. -+ -+In versions before 3.0.0-M4, only groupId:artifactId is supported. -+ ++ + + + disableXmlReport -+ boolean -+ 2.2 ++ java.lang.Boolean + No reason given + false + true -+ Flag to disable the generation of report files in xml format. Deprecated since 3.0.0-M4. Instead use disable within statelessTestsetReporter since of 3.0.0-M6. ++ + + + enableAssertions + boolean -+ 2.3.1 + false + true -+ By default, Surefire enables JVM assertions for the execution of your test cases. To disable the assertions, set this flag to "false". ++ + + + enableOutErrElements + boolean -+ 3.3.1 + false + true -+ Flag for including/excluding <system-out /> and <system-err /> elements for successfully passed tests in XML reports. Note that the default value may change to false is a future version. ++ + + + enableProcessChecker @@ -3116,24 +2770,23 @@ index 000000000..3d369f203 + 3.0.0-M4 + false + true -+ Since 3.0.0-M4 the process checkers are disabled. You can enable them namely by setting ping and native or all in this parameter. -+The checker is useful in situations when you kill the build on a CI system and you want the Surefire forked JVM to kill the tests asap and free all handlers on the file system been previously used by the JVM and by the tests. -+The ping should be safely used together with ZGC or Shenandoah Garbage Collector. Due to the ping relies on timing of the PING (triggered every 30 seconds), slow GCs may pause the timers and pretend that the parent process of the forked JVM does not exist. -+The native is very fast checker. It is useful mechanism on Unix based systems, Linux distributions and Alpine/BusyBox Linux. See the JIRA SUREFIRE-1631 <https://issues.apache.org/jira/browse/SUREFIRE-1631> for Windows issues. -+Another useful configuration parameter is forkedProcessTimeoutInSeconds. ++ Since 3.0.0-M4 the process checkers are disabled. You can enable them namely by setting ping and native or all in this parameter. ++The checker is useful in situations when you kill the build on a CI system and you want the Surefire forked JVM to kill the tests asap and free all handlers on the file system been previously used by the JVM and by the tests. ++The ping should be safely used together with ZGC or Shenandoah Garbage Collector. Due to the ping relies on timing of the PING (triggered every 30 seconds), slow GCs may pause the timers and pretend that the parent process of the forked JVM does not exist. ++The native is very fast checker. It is useful mechanism on Unix based systems, Linux distributions and Alpine/BusyBox Linux. See the JIRA SUREFIRE-1631 <https://issues.apache.org/jira/browse/SUREFIRE-1631> for Windows issues. ++Another useful configuration parameter is forkedProcessTimeoutInSeconds. +See the Frequently Asked Questions page with more details: -+http://maven.apache.org/surefire/maven-surefire-plugin/faq.html#kill-jvm <http://maven.apache.org/surefire/maven-surefire-plugin/faq.html#kill-jvm> -+http://maven.apache.org/surefire/maven-failsafe-plugin/faq.html#kill-jvm <http://maven.apache.org/surefire/maven-failsafe-plugin/faq.html#kill-jvm> -+Example of use: ++http://maven.apache.org/surefire/maven-surefire-plugin/faq.html#kill-jvm <http://maven.apache.org/surefire/maven-surefire-plugin/faq.html#kill-jvm> ++http://maven.apache.org/surefire/maven-failsafe-plugin/faq.html#kill-jvm <http://maven.apache.org/surefire/maven-failsafe-plugin/faq.html#kill-jvm> ++Example of use: +mvn test -Dsurefire.enableProcessChecker=all + + + enablePropertiesElement + boolean -+ 3.3.1 + false + true -+ Flag for including/excluding <properties /> element for successfully passed tests in XML reports. ++ + + + encoding @@ -3146,10 +2799,9 @@ index 000000000..3d369f203 + + environmentVariables + java.util.Map<java.lang.String, java.lang.String> -+ 2.1.3 + false + true -+ Additional environment variables to set on the command line. ++ + + + excludeJUnit5Engines @@ -3165,32 +2817,28 @@ index 000000000..3d369f203 + 3.0.0-M4 + false + true -+ You can selectively exclude individual environment variables by enumerating their keys. -+The environment is a system-dependent mapping from keys to values which is inherited from the Maven process to the forked Surefire processes. The keys must literally (case sensitive) match in order to exclude their environment variable. -+Example to exclude three environment variables: ++ You can selectively exclude individual environment variables by enumerating their keys. ++The environment is a system-dependent mapping from keys to values which is inherited from the Maven process to the forked Surefire processes. The keys must literally (case sensitive) match in order to exclude their environment variable. ++Example to exclude three environment variables: +mvn test -Dsurefire.excludedEnvironmentVariables=ACME1,ACME2,ACME3 + + + excludedGroups + java.lang.String -+ 2.2 + false + true -+ (TestNG/JUnit47 provider with JUnit4.8+ only and JUnit5+ provider since 2.22.0) Excluded groups/categories/tags. Any methods/classes/etc with one of the groups/categories/tags specified in this list will specifically not be run. -+For JUnit4, this parameter forces the use of the 4.7 provider. For JUnit5, this parameter forces the use of the JUnit platform provider. -+This parameter is ignored if the suiteXmlFiles parameter is specified. -+Since version 2.18.1 and JUnit 4.12, the @Category annotation type is automatically inherited from superclasses, see @java.lang.annotation.Inherited. Make sure that test class inheritance still makes sense together with @Category annotation of the JUnit 4.12 or higher appeared in superclass. ++ + + + excludes + java.util.List<java.lang.String> + false + true -+ A list of <exclude> elements specifying the tests (by pattern) that should be excluded in testing. When not specified and when the test parameter is not specified, the default excludes will be -+<excludes> <exclude>**/*$*</exclude> </excludes> (which excludes all inner classes). -+This parameter is ignored if the TestNG suiteXmlFiles parameter is specified. ++ A list of <exclude> elements specifying the tests (by pattern) that should be excluded in testing. When not specified and when the test parameter is not specified, the default excludes will be ++<excludes> <exclude>**/*$*</exclude> </excludes> (which excludes all inner classes). ++This parameter is ignored if the TestNG suiteXmlFiles parameter is specified. +Each exclude item may also contain a comma-separated sub-list of items, which will be treated as multiple <exclude> entries. -+Since 2.19 a complex syntax is supported in one parameter (JUnit 4, JUnit 4.7+, TestNG): <exclude>%regex[pkg.*Slow.*.class], Unstable*</exclude> ++Since 2.19 a complex syntax is supported in one parameter (JUnit 4, JUnit 4.7+, TestNG): <exclude>%regex[pkg.*Slow.*.class], Unstable*</exclude> +Notice that these values are relative to the directory containing generated test classes of the project being tested. This directory is declared by the parameter testClassesDirectory which defaults to the POM property ${project.build.testOutputDirectory}, typically src/test/java unless overridden. + + @@ -3213,10 +2861,9 @@ index 000000000..3d369f203 + + failIfNoTests + boolean -+ 2.4 + false + true -+ Set this to "true" to cause a failure if there are no tests to run. Defaults to "false". ++ + + + failOnFlakeCount @@ -3229,14 +2876,9 @@ index 000000000..3d369f203 + + forkCount + java.lang.String -+ 2.14 + false + true -+ Option to specify the number of VMs to fork in parallel in order to execute the tests. When terminated with "C", the number part is multiplied with the number of CPU cores. Floating point value are only accepted together with "C". If set to "0", no VM is forked and all tests are executed within the main process. -+ -+Example values: "1.5C", "4" -+ -+The system properties and the argLine of the forked processes may contain the place holder string ${surefire.forkNumber}, which is replaced with a fixed number for each of the parallel forks, ranging from 1 to the effective value of forkCount times the maximum number of parallel Surefire executions in maven parallel builds, i.e. the effective value of the -T command line argument of maven core. ++ + + + forkNode @@ -3244,7 +2886,7 @@ index 000000000..3d369f203 + 3.0.0-M5 + false + true -+ This parameter configures the forked node. Currently, you can select the communication protocol, i.e. process pipes or TCP/IP sockets. The plugin uses process pipes by default which will be turned to TCP/IP in the version 3.0.0. Alternatively, you can implement your own factory and SPI. ++ This parameter configures the forked node. Currently, you can select the communication protocol, i.e. process pipes or TCP/IP sockets. The plugin uses process pipes by default which will be turned to TCP/IP in the version 3.0.0. Alternatively, you can implement your own factory and SPI. +See the documentation for more details: +https://maven.apache.org/plugins/maven-surefire-plugin/examples/process-communication.html <https://maven.apache.org/plugins/maven-surefire-plugin/examples/process-communication.html> + @@ -3267,13 +2909,9 @@ index 000000000..3d369f203 + + groups + java.lang.String -+ 2.2 + false + true -+ (TestNG/JUnit47 provider with JUnit4.8+ only and JUnit5+ provider since 2.22.0) Groups/categories/tags for this test. Only classes/methods/etc decorated with one of the groups/categories/tags specified here will be included in test run, if specified. -+For JUnit4 tests, this parameter forces the use of the 4.7 provider. For JUnit5 tests, this parameter forces the use of the JUnit platform provider. -+This parameter is ignored if the suiteXmlFiles parameter is specified. -+Since version 2.18.1 and JUnit 4.12, the @Category annotation type is automatically inherited from superclasses, see @java.lang.annotation.Inherited. Make sure that test class inheritance still makes sense together with @Category annotation of the JUnit 4.12 or higher appeared in superclass. ++ + + + includeJUnit5Engines @@ -3289,7 +2927,7 @@ index 000000000..3d369f203 + false + true + A list of <include> elements specifying the tests (by pattern) that should be included in testing. When not specified and when the test parameter is not specified, the default includes will be <includes> <include>**/Test*.java</include> <include>**/*Test.java</include> <include>**/*Tests.java</include> <include>**/*TestCase.java</include> </includes> Each include item may also contain a comma-separated sub-list of items, which will be treated as multiple <include> entries. -+Since 2.19 a complex syntax is supported in one parameter (JUnit 4, JUnit 4.7+, TestNG): <include>%regex[.*[Cat|Dog].*], Basic????, !Unstable*</include> <include>%regex[.*[Cat|Dog].*], !%regex[pkg.*Slow.*.class], pkg/**/*Fast*.java</include> ++Since 2.19 a complex syntax is supported in one parameter (JUnit 4, JUnit 4.7+, TestNG): <include>%regex[.*[Cat|Dog].*], Basic????, !Unstable*</include> <include>%regex[.*[Cat|Dog].*], !%regex[pkg.*Slow.*.class], pkg/**/*Fast*.java</include> +This parameter is ignored if the TestNG suiteXmlFiles parameter is specified. + +Notice that these values are relative to the directory containing generated test classes of the project being tested. This directory is declared by the parameter testClassesDirectory which defaults to the POM property ${project.build.testOutputDirectory}, typically src/test/java unless overridden. @@ -3300,68 +2938,50 @@ index 000000000..3d369f203 + 2.13 + false + true -+ A file containing include patterns. Blank lines, or lines starting with # are ignored. If includes are also specified, these patterns are appended. Example with path, simple and regex includes: */test/* **/NotIncludedByDefault.java %regex[.*Test.*|.*Not.*] ++ A file containing include patterns. Blank lines, or lines starting with # are ignored. If includes are also specified, these patterns are appended. Example with path, simple and regex includes: */test/* **/NotIncludedByDefault.java %regex[.*Test.*|.*Not.*] +Since 3.0.0-M6, method filtering support is provided in the inclusions file as well, example: pkg.SomeTest#testMethod + + + jdkToolchain + java.util.Map<java.lang.String, java.lang.String> -+ 3.0.0-M5 and Maven 3.3.x + false + true -+ -+Allow for configuration of the test jvm via maven toolchains. This permits a configuration where the project is built with one jvm and tested with another. This is similar to jvm, but avoids hardcoding paths. The two parameters are mutually exclusive (jvm wins) -+ -+Examples: -+(see Guide to Toolchains <https://maven.apache.org/guides/mini/guide-using-toolchains.html> for more info) <configuration> ... <jdkToolchain> <version>1.11</version> </jdkToolchain> </configuration> <configuration> ... <jdkToolchain> <version>1.8</version> <vendor>zulu</vendor> </jdkToolchain> </configuration> ++ + + + junitArtifactName + java.lang.String -+ 2.3.1 + false + true -+ Allows you to specify the name of the JUnit artifact. If not set, junit:junit will be used. ++ + + + jvm + java.lang.String -+ 2.1 + false + true -+ Option to specify the jvm (or path to the java executable) to use with the forking options. For the default, the jvm will be a new instance of the same VM as the one used to run Maven. JVM settings are not inherited from MAVEN_OPTS. ++ + + + objectFactory + java.lang.String -+ 2.5 + false + true -+ (TestNG only) Define the factory class used to create all test instances. ++ + + + parallel + java.lang.String -+ 2.2 + false + true -+ (TestNG provider) When you use the parameter parallel, TestNG will try to run all your test methods in separate threads, except for methods that depend on each other, which will be run in the same thread in order to respect their order of execution. Supports two values: classes or methods. -+(JUnit 4.7 provider) Supports values classes, methods, both to run in separate threads been controlled by threadCount. -+ -+Since version 2.16 (JUnit 4.7 provider), the value both is DEPRECATED. Use classesAndMethods instead. -+ -+Since version 2.16 (JUnit 4.7 provider), additional vales are available: -+suites, suitesAndClasses, suitesAndMethods, classesAndMethods, all. -+By default, Surefire does not execute tests in parallel. You can set the parameter parallel to none to explicitly disable parallel execution (e.g. when disabling parallel execution in special Maven profiles when executing coverage analysis). ++ + + + parallelOptimized + boolean -+ 2.17 + false + true -+ (JUnit 4.7 / provider only) The thread counts do not exceed the number of parallel suite, class runners and average number of methods per class if set to true. -+True by default. ++ + + + parallelTestsTimeoutForcedInSeconds @@ -3369,7 +2989,7 @@ index 000000000..3d369f203 + 2.16 + false + true -+ Stop executing queued parallel JUnit tests and interrupt currently running tests after a certain number of seconds. ++ Stop executing queued parallel JUnit tests and interrupt currently running tests after a certain number of seconds. +Example values: "3.5", "4" + +If set to 0, wait forever, never timing out. Makes sense with specified parallel different from "none". @@ -3380,7 +3000,7 @@ index 000000000..3d369f203 + 2.16 + false + true -+ Stop executing queued parallel JUnit tests after a certain number of seconds. ++ Stop executing queued parallel JUnit tests after a certain number of seconds. +Example values: "3.5", "4" + +If set to 0, wait forever, never timing out. Makes sense with specified parallel different from "none". @@ -3388,10 +3008,9 @@ index 000000000..3d369f203 + + perCoreThreadCount + boolean -+ 2.5 + false + true -+ (JUnit 4.7 provider) Indicates that threadCount, threadCountSuites, threadCountClasses, threadCountMethods are per cpu core. ++ + + + printSummary @@ -3403,30 +3022,23 @@ index 000000000..3d369f203 + + promoteUserPropertiesToSystemProperties + boolean -+ 3.4.0 + false + true -+ If set to true will also pass all user properties exposed via MavenSession#getUserProperties() as system properties to a provider. Those always take precedence over same named system properties set via any other means. -+See also: systemPropertyVariables ++ + + + properties + java.util.Properties -+ 2.4 + false + true -+ List of properties for configuring the testing provider. This is the preferred method of configuring TestNG and JUnit platform providers. -+ -+JUnit platform properties may be defined in a configurationParameters element: <properties> <configurationParameters> junit.jupiter.execution.parallel.enabled = true junit.jupiter.execution.parallel.mode.default = concurrent </configurationParameters> </properties> -+TestNG properties may be defined as distinct element blocks: <properties> <property> <name>parallel</name> <value>methods</value> </property> </properties> ++ + + + redirectTestOutputToFile + boolean -+ 2.3 + false + true -+ Set this to "true" to redirect the unit test standard output to a file (found in reportsDirectory/testName-output.txt). ++ + + + reportFormat @@ -3440,7 +3052,7 @@ index 000000000..3d369f203 + java.lang.String + false + true -+ Add custom text into report filename: TEST-testClassName-reportNameSuffix.xml, testClassName-reportNameSuffix.txt and testClassName-reportNameSuffix-output.txt. File TEST-testClassName-reportNameSuffix.xml has changed attributes 'testsuite'--'name' and 'testcase'--'classname' - reportNameSuffix is added to the attribute value. ++ + + + reportsDirectory @@ -3459,10 +3071,9 @@ index 000000000..3d369f203 + + reuseForks + boolean -+ 2.13 + false + true -+ Indicates if forked VMs can be reused. If set to "false", a new VM is forked for each test class to be executed. If set to "true", up to forkCount VMs will be forked and then reused to execute all tests. ++ + + + runOrder @@ -3470,13 +3081,13 @@ index 000000000..3d369f203 + 2.7 + false + true -+ Defines the order the tests will be run in. Supported values are alphabetical, reversealphabetical, random, hourly (alphabetical on even hours, reverse alphabetical on odd hours), failedfirst, balanced and filesystem. ++ Defines the order the tests will be run in. Supported values are alphabetical, reversealphabetical, random, hourly (alphabetical on even hours, reverse alphabetical on odd hours), failedfirst, balanced and filesystem. + -+Odd/Even for hourly is determined at the time the of scanning the classpath, meaning it could change during a multi-module build. ++Odd/Even for hourly is determined at the time the of scanning the classpath, meaning it could change during a multi-module build. + -+Failed first will run tests that failed on previous run first, as well as new tests for this run. ++Failed first will run tests that failed on previous run first, as well as new tests for this run. + -+Balanced is only relevant with parallel=classes, and will try to optimize the run-order of the tests reducing the overall execution time. Initially a statistics file is created and every next test run will reorder classes. ++Balanced is only relevant with parallel=classes, and will try to optimize the run-order of the tests reducing the overall execution time. Initially a statistics file is created and every next test run will reorder classes. + +Note that the statistics are stored in a file named .surefire-XXXXXXXXX beside pom.xml and should not be checked into version control. The "XXXXX" is the SHA1 checksum of the entire surefire configuration, so different configurations will have different statistics files, meaning if you change any configuration settings you will re-run once before new statistics data can be established. + @@ -3486,9 +3097,9 @@ index 000000000..3d369f203 + 3.0.0-M6 + false + true -+ Sets the random seed that will be used to order the tests if surefire.runOrder is set to random. ++ Sets the random seed that will be used to order the tests if surefire.runOrder is set to random. + -+If no seeds are set and surefire.runOrder is set to random, then the seed used will be outputted (search for "To reproduce ordering use flag -Dsurefire.runOrder.random.seed"). ++If no seeds are set and surefire.runOrder is set to random, then the seed used will be outputted (search for "To reproduce ordering use flag -Dsurefire.runOrder.random.seed"). + +To deterministically reproduce any random test order that was run before, simply set the seed to be the same value. + @@ -3498,11 +3109,11 @@ index 000000000..3d369f203 + 2.19 + false + true -+ After the plugin process is shutdown by sending SIGTERM signal (CTRL+C), SHUTDOWN command is received by every forked JVM. -+The value is set to (shutdown=exit) by default (changed in version 3.0.0-M4). -+The parameter can be configured with other two values testset and kill. -+With(shutdown=testset) the test set may still continue to run in forked JVM. -+Using exit forked JVM executes System.exit(1) after the plugin process has received SIGTERM signal. ++ After the plugin process is shutdown by sending SIGTERM signal (CTRL+C), SHUTDOWN command is received by every forked JVM. ++The value is set to (shutdown=exit) by default (changed in version 3.0.0-M4). ++The parameter can be configured with other two values testset and kill. ++With(shutdown=testset) the test set may still continue to run in forked JVM. ++Using exit forked JVM executes System.exit(1) after the plugin process has received SIGTERM signal. +Using kill the JVM executes Runtime.halt(1) and kills itself. + + @@ -3510,7 +3121,7 @@ index 000000000..3d369f203 + boolean + false + true -+ Set this to "true" to bypass unit tests entirely. Its use is NOT RECOMMENDED, especially if you enable it using the "maven.test.skip" property, because maven.test.skip disables both running the tests and compiling the tests. Consider using the skipTests parameter instead. ++ + + + skipAfterFailureCount @@ -3526,20 +3137,17 @@ index 000000000..3d369f203 + + skipExec + boolean -+ 2.3 -+ Use skipTests instead. ++ No reason given + false + true -+ This old parameter is just like skipTests, but bound to the old property "maven.test.skip.exec". ++ + + + skipTests + boolean -+ 2.4 + false + true -+ Set this to "true" to skip running tests, but still compile them. Its use is NOT RECOMMENDED, but quite convenient on occasion. -+Failsafe plugin deprecated the parameter skipTests and the parameter will be removed in Failsafe 3.0.0 as it is a source of conflicts between Failsafe and Surefire plugin. ++ + + + statelessTestsetInfoReporter @@ -3553,7 +3161,7 @@ index 000000000..3d369f203 + org.apache.maven.plugin.surefire.extensions.SurefireStatelessReporter + false + true -+ Note: use the legacy system property disableXmlReport set to true to disable the report. ++ + + + suiteXmlFiles @@ -3567,11 +3175,10 @@ index 000000000..3d369f203 + + systemProperties + java.util.Properties -+ Use systemPropertyVariables instead. ++ No reason given + false + true -+ List of System properties to pass to a provider. -+See also: systemPropertyVariables for how the effective provider properties are calculated ++ + + + systemPropertiesFile @@ -3579,48 +3186,32 @@ index 000000000..3d369f203 + false + true + Properties file being used as system properties passed to the provider. -+See also: systemPropertyVariables for how the effective provider properties are calculated ++See also: AbstractSurefireMojo#systemPropertyVariables systemPropertyVariables for how the effective provider properties are calculated + + + systemPropertyVariables + java.util.Map<java.lang.String, java.lang.String> -+ 2.5 + false + true -+ List of System properties to pass to a provider. The effective system properties given to a provider are contributed from several sources: -+* properties set via argLine with -D (only for forked executions) -+* systemProperties -+* getSystemPropertiesFile() (set via parameter systemPropertiesFile on some goals) -+* systemPropertyVariables -+* User properties from MavenSession#getUserProperties(), usually set via CLI options given with -D on the current Maven process (only used as source if promoteUserPropertiesToSystemProperties is true) Later sources may overwrite same named properties from earlier sources, that means for example that one cannot overwrite user properties with either systemProperties, getSystemPropertiesFile() or systemPropertyVariables. -+Certain properties may only be overwritten via argLine (applicable only for forked executions) because their values are cached and only evaluated at the start of the JRE. Those include: -+ -+* java.library.path -+* file.encoding -+* jdk.map.althashing.threshold -+* line.separator -+See also: systemProperties ++ + + + tempDir + java.lang.String -+ 2.20 + false + true -+ Relative path to temporary-surefire-boot directory containing internal Surefire temporary files. -+The temporary-surefire-boot directory is project.build.directory on most platforms or system default temporary-directory specified by the system property java.io.tmpdir on Windows (see SUREFIRE-1400 <https://issues.apache.org/jira/browse/SUREFIRE-1400>). -+It is deleted after the test set has completed. ++ + + + test + java.lang.String + false + true -+ Specify this parameter to run individual tests by file name, overriding the parameter includes and excludes. Each pattern you specify here will be used to create an include pattern formatted like **/${test}.java, so you can just type -Dtest=MyTest to run a single test called "foo/MyTest.java". The test patterns prefixed with a ! will be excluded. -+This parameter overrides the parameter includes, excludes, and the TestNG parameter suiteXmlFiles. ++ Specify this parameter to run individual tests by file name, overriding the parameter includes and excludes. Each pattern you specify here will be used to create an include pattern formatted like **/${test}.java, so you can just type -Dtest=MyTest to run a single test called "foo/MyTest.java". The test patterns prefixed with a ! will be excluded. ++This parameter overrides the parameter includes, excludes, and the TestNG parameter suiteXmlFiles. +Since 2.7.3, you can execute a limited number of methods in the test by adding #myMethod or #my*ethod. For example, -Dtest=MyTest#myMethod. This is supported for junit 4.x and TestNg. + -+Since 2.19 a complex syntax is supported in one parameter (JUnit 4, JUnit 4.7+, TestNG): "-Dtest=???Test, !Unstable*, pkg/**/Ci*leTest.java, *Test#test*One+testTwo?????, #fast*+slowTest" or e.g. "-Dtest=Basic*, !%regex[.*.Unstable.*], !%regex[.*.MyTest.class#one.*|two.*], %regex[#fast.*|slow.*]" ++Since 2.19 a complex syntax is supported in one parameter (JUnit 4, JUnit 4.7+, TestNG): "-Dtest=???Test, !Unstable*, pkg/**/Ci*leTest.java, *Test#test*One+testTwo?????, #fast*+slowTest" or e.g. "-Dtest=Basic*, !%regex[.*.Unstable.*], !%regex[.*.MyTest.class#one.*|two.*], %regex[#fast.*|slow.*]" +The Parameterized JUnit runner describes test methods using an index in brackets, so the non-regex method pattern would become: #testMethod[*]. If using @Parameters(name="{index}: fib({0})={1}") and selecting the index e.g. 5 in pattern, the non-regex method pattern would become #testMethod[5:*]. + + @@ -3628,7 +3219,7 @@ index 000000000..3d369f203 + java.io.File + false + true -+ The directory containing generated test classes of the project being tested. This will be included at the beginning of the test classpath. ++ + + + testFailureIgnore @@ -3640,69 +3231,51 @@ index 000000000..3d369f203 + + testNGArtifactName + java.lang.String -+ 2.3.1 + false + true -+ Allows you to specify the name of the TestNG artifact. If not set, org.testng:testng will be used. ++ + + + testSourceDirectory + java.io.File -+ 2.2 + false + true -+ The test source directory containing test class sources. Important only for TestNG HTML reports. ++ + + + threadCount + int -+ 2.2 + false + true -+ (TestNG/JUnit 4.7 provider) The attribute thread-count allows you to specify how many threads should be allocated for this execution. Only makes sense to use in conjunction with the parallel parameter. ++ + + + threadCountClasses + int -+ 2.16 + false + true -+ (JUnit 4.7 provider) This attribute allows you to specify the concurrency in test classes, i.e.: -+* number of concurrent classes if threadCount is 0 or unspecified -+* limited classes concurrency if useUnlimitedThreads is set to true -+* if threadCount and certain thread-count parameters are > 0 for parallel, the concurrency is computed from ratio. For instance parallel=all and the ratio between threadCountSuites:threadCountClasses:threadCountMethods is 2:3:5, there is 30% of threadCount in concurrent classes. -+* as in the previous case but without this leaf thread-count. Example: parallel=suitesAndClasses, threadCount=16, threadCountSuites=5, threadCountClasses is unspecified leaf, the number of concurrent classes is varying from >= 11 to 14 or 15. The threadCountSuites become given number of threads. Only makes sense to use in conjunction with the parallel parameter. The default value 0 behaves same as unspecified one. ++ + + + threadCountMethods + int -+ 2.16 + false + true -+ (JUnit 4.7 provider) This attribute allows you to specify the concurrency in test methods, i.e.: -+* number of concurrent methods if threadCount is 0 or unspecified -+* limited concurrency of methods if useUnlimitedThreads is set to true -+* if threadCount and certain thread-count parameters are > 0 for parallel, the concurrency is computed from ratio. For instance parallel=all and the ratio between threadCountSuites:threadCountClasses:threadCountMethods is 2:3:5, there is 50% of threadCount which appears in concurrent methods. -+* as in the previous case but without this leaf thread-count. Example: parallel=all, threadCount=16, threadCountSuites=2, threadCountClasses=3, but threadCountMethods is unspecified leaf, the number of concurrent methods is varying from >= 11 to 14 or 15. The threadCountSuites and threadCountClasses become given number of threads. Only makes sense to use in conjunction with the parallel parameter. The default value 0 behaves same as unspecified one. ++ + + + threadCountSuites + int -+ 2.16 + false + true -+ (JUnit 4.7 provider) This attribute allows you to specify the concurrency in test suites, i.e.: -+* number of concurrent suites if threadCount is 0 or unspecified -+* limited suites concurrency if useUnlimitedThreads is set to true -+* if threadCount and certain thread-count parameters are > 0 for parallel, the concurrency is computed from ratio. For instance parallel=all and the ratio between threadCountSuites:threadCountClasses:threadCountMethods is 2:3:5, there is 20% of threadCount which appeared in concurrent suites. Only makes sense to use in conjunction with the parallel parameter. The default value 0 behaves same as unspecified one. ++ + + + trimStackTrace + boolean -+ 2.2 + false + true -+ Whether to trim the stack trace in the reports to just the lines within the test, or show the full trace. ++ + + + useFile @@ -3717,7 +3290,7 @@ index 000000000..3d369f203 + 2.4.3 + false + true -+ By default, Surefire forks your tests using a manifest-only JAR; set this parameter to "false" to force it to launch your tests with a plain old Java classpath. (See the http://maven.apache.org/plugins/maven-surefire-plugin/examples/class-loading.html <http://maven.apache.org/plugins/maven-surefire-plugin/examples/class-loading.html> for a more detailed explanation of manifest-only JARs and their benefits.) ++ By default, Surefire forks your tests using a manifest-only JAR; set this parameter to "false" to force it to launch your tests with a plain old Java classpath. (See the http://maven.apache.org/plugins/maven-surefire-plugin/examples/class-loading.html <http://maven.apache.org/plugins/maven-surefire-plugin/examples/class-loading.html> for a more detailed explanation of manifest-only JARs and their benefits.) +Beware, setting this to "false" may cause your tests to fail on Windows if your classpath is too long. + + @@ -3726,7 +3299,7 @@ index 000000000..3d369f203 + 3.0.0-M2 + false + true -+ When true, uses the modulepath when executing with JDK 9+ and module-info.java is present. When false, always uses the classpath. ++ When true, uses the modulepath when executing with JDK 9+ and module-info.java is present. When false, always uses the classpath. +Defaults to true. + + @@ -3740,18 +3313,16 @@ index 000000000..3d369f203 + + useUnlimitedThreads + boolean -+ 2.5 + false + true -+ (JUnit 4.7 provider) Indicates that the thread pool will be unlimited. The parallel parameter and the actual number of classes/methods will decide. Setting this to "true" effectively disables perCoreThreadCount and threadCount. Defaults to "false". ++ + + + workingDirectory + java.io.File -+ 2.1.3 + false + true -+ Command line working directory. ++ + + + @@ -3763,7 +3334,7 @@ index 000000000..3d369f203 + ${maven.test.dependency.excludes} + ${maven.surefire.debug} + ${dependenciesToScan} -+ ${disableXmlReport} ++ ${disableXmlReport} + ${enableAssertions} + ${enableOutErrElements} + ${surefire.enableProcessChecker} @@ -3831,12 +3402,10 @@ index 000000000..3d369f203 + + + -diff --git a/maven-surefire-plugin/src/main/filtered-resources/META-INF/maven/plugin.xml b/maven-surefire-plugin/src/main/filtered-resources/META-INF/maven/plugin.xml -new file mode 100644 -index 000000000..3a76ee7b9 ---- /dev/null -+++ b/maven-surefire-plugin/src/main/filtered-resources/META-INF/maven/plugin.xml -@@ -0,0 +1,1145 @@ +diff -urEbwBN a/maven-surefire-plugin/src/main/filtered-resources/META-INF/maven/plugin.xml b/maven-surefire-plugin/src/main/filtered-resources/META-INF/maven/plugin.xml +--- a/maven-surefire-plugin/src/main/filtered-resources/META-INF/maven/plugin.xml 1970-01-01 01:00:00.000000000 +0100 ++++ b/maven-surefire-plugin/src/main/filtered-resources/META-INF/maven/plugin.xml 2024-11-04 10:48:40.175717003 +0100 +@@ -0,0 +1,1012 @@ + + + @@ -3925,54 +3494,37 @@ index 000000000..3a76ee7b9 + + additionalClasspathDependencies + java.util.List -+ 3.2 + false + true -+ Additional Maven dependencies to be added to the test classpath at runtime. Each element supports the parametrization like documented in POM Reference: Dependencies <https://maven.apache.org/pom.html#dependencies>. -+Those dependencies are automatically collected (i.e. have their full dependency tree calculated) and then all underlying artifacts are resolved from the repository (including their transitive dependencies). Afterwards the resolved artifacts are filtered to only contain compile and runtime scoped ones and appended to the test classpath at runtime (after the ones from additionalClasspathElements). -+ -+The following differences to regular project dependency resolving apply: -+ -+* The dependency management from the project is not taken into account. -+* Conflicts between the different items and the project dependencies are not resolved. -+* Only external dependencies (outside the current Maven reactor) are supported. ++ + + + additionalClasspathElements + java.lang.String[] -+ 2.4 + false + true -+ Additional elements to be appended to the test classpath at runtime. Each element must be a file system path to a JAR file or a directory containing classes. No wildcards are allowed here. ++ + + + argLine + java.lang.String -+ 2.1 + false + true -+ Arbitrary JVM options to set on the command line. Only effective for forked executions. -+ -+Since the Version 2.17 using an alternate syntax for argLine, @{...} allows late replacement of properties when the plugin is executed, so properties that have been modified by other plugins will be picked up correctly. See the Frequently Asked Questions page with more details: -+http://maven.apache.org/surefire/maven-surefire-plugin/faq.html <http://maven.apache.org/surefire/maven-surefire-plugin/faq.html> -+http://maven.apache.org/surefire/maven-failsafe-plugin/faq.html <http://maven.apache.org/surefire/maven-failsafe-plugin/faq.html> -+See also: forkCount ++ + + + basedir + java.io.File + true + false -+ The base directory of the project being tested. This can be obtained in your integration test via System.getProperty("basedir"). ++ + + + childDelegation + boolean -+ 2.1 + false + true -+ When false it makes tests run using the standard classloader delegation instead of the default Maven isolated classloader. Only used when forking (forkCount is greater than zero). -+Setting it to false helps with some problems caused by conflicts between xml parsers in the classpath and the Java 5 provider parser. ++ + + + classesDirectory @@ -3984,27 +3536,16 @@ index 000000000..3a76ee7b9 + + classpathDependencyExcludes + java.lang.String[] -+ 2.6 + false + true -+ List of dependencies to exclude from the test classpath at runtime. Each item is passed as pattern to org.apache.maven.shared.artifact.filter.PatternIncludesArtifactFilter. The pattern is matched against the following artifact ids: -+* groupId:artifactId (Short ID) -+* groupId:artifactId:type:classifier (Dependency Conflict ID) -+* groupId:artifactId:type:classifier:version (Full ID) The matching algorithm is described in detail in Advanced Artifact-Matching <https://maven.apache.org/plugins/maven-assembly-plugin/advanced-descriptor-topics.html#advanced-artifact-matching-in-includes-and-excludes> for the maven-assembly-plugin. This parameter behaves the same as the excludes pattern described there. The dependency matching is applied to the project dependency IDs (including transitive ones) after resolving, i.e. excluding one dependency will not exclude its transitive dependencies! ++ + + + classpathDependencyScopeExclude + java.lang.String -+ 2.6 + false + true -+ A dependency scope to exclude from the test classpath at runtime. The scope should be one of the scopes defined by org.apache.maven.artifact.Artifact. This includes the following: -+ -+* compile - system, provided, compile -+* runtime - compile, runtime -+* compile+runtime - system, provided, compile, runtime -+* runtime+system - system, compile, runtime -+* test - system, provided, compile, runtime, test ++ + + + consoleOutputReporter @@ -4024,51 +3565,31 @@ index 000000000..3a76ee7b9 + + dependenciesToScan + java.lang.String[] -+ 2.15 + false + true -+ List of dependencies to scan for test classes to include in the test run. The child elements of this element must be <dependency> elements, and the contents of each of these elements must be a string which follows the general form: -+groupId[:artifactId[:type[:classifier][:version]]] -+ -+The wildcard character * can be used within the sub parts of those composite identifiers to do glob-like pattern matching. The classifier may be omitted when matching dependencies without a classifier. -+ -+Examples: -+ -+* group or, equivalently, group:* -+* g*p:*rtifac* -+* group:*:jar -+* group:artifact:*:1.0.0 (no classifier) -+* group:*:test-jar:tests -+* *:artifact:*:*:1.0.0 -+Since version 2.22.0 you can scan for test classes from a project dependency of your multi-module project. -+ -+In versions before 3.0.0-M4, only groupId:artifactId is supported. -+ ++ + + + disableXmlReport -+ boolean -+ 2.2 ++ java.lang.Boolean + No reason given + false + true -+ Flag to disable the generation of report files in xml format. Deprecated since 3.0.0-M4. Instead use disable within statelessTestsetReporter since of 3.0.0-M6. ++ + + + enableAssertions + boolean -+ 2.3.1 + false + true -+ By default, Surefire enables JVM assertions for the execution of your test cases. To disable the assertions, set this flag to "false". ++ + + + enableOutErrElements + boolean -+ 3.3.1 + false + true -+ Flag for including/excluding <system-out /> and <system-err /> elements for successfully passed tests in XML reports. Note that the default value may change to false is a future version. ++ + + + enableProcessChecker @@ -4076,24 +3597,23 @@ index 000000000..3a76ee7b9 + 3.0.0-M4 + false + true -+ Since 3.0.0-M4 the process checkers are disabled. You can enable them namely by setting ping and native or all in this parameter. -+The checker is useful in situations when you kill the build on a CI system and you want the Surefire forked JVM to kill the tests asap and free all handlers on the file system been previously used by the JVM and by the tests. -+The ping should be safely used together with ZGC or Shenandoah Garbage Collector. Due to the ping relies on timing of the PING (triggered every 30 seconds), slow GCs may pause the timers and pretend that the parent process of the forked JVM does not exist. -+The native is very fast checker. It is useful mechanism on Unix based systems, Linux distributions and Alpine/BusyBox Linux. See the JIRA SUREFIRE-1631 <https://issues.apache.org/jira/browse/SUREFIRE-1631> for Windows issues. -+Another useful configuration parameter is forkedProcessTimeoutInSeconds. ++ Since 3.0.0-M4 the process checkers are disabled. You can enable them namely by setting ping and native or all in this parameter. ++The checker is useful in situations when you kill the build on a CI system and you want the Surefire forked JVM to kill the tests asap and free all handlers on the file system been previously used by the JVM and by the tests. ++The ping should be safely used together with ZGC or Shenandoah Garbage Collector. Due to the ping relies on timing of the PING (triggered every 30 seconds), slow GCs may pause the timers and pretend that the parent process of the forked JVM does not exist. ++The native is very fast checker. It is useful mechanism on Unix based systems, Linux distributions and Alpine/BusyBox Linux. See the JIRA SUREFIRE-1631 <https://issues.apache.org/jira/browse/SUREFIRE-1631> for Windows issues. ++Another useful configuration parameter is forkedProcessTimeoutInSeconds. +See the Frequently Asked Questions page with more details: -+http://maven.apache.org/surefire/maven-surefire-plugin/faq.html#kill-jvm <http://maven.apache.org/surefire/maven-surefire-plugin/faq.html#kill-jvm> -+http://maven.apache.org/surefire/maven-failsafe-plugin/faq.html#kill-jvm <http://maven.apache.org/surefire/maven-failsafe-plugin/faq.html#kill-jvm> -+Example of use: ++http://maven.apache.org/surefire/maven-surefire-plugin/faq.html#kill-jvm <http://maven.apache.org/surefire/maven-surefire-plugin/faq.html#kill-jvm> ++http://maven.apache.org/surefire/maven-failsafe-plugin/faq.html#kill-jvm <http://maven.apache.org/surefire/maven-failsafe-plugin/faq.html#kill-jvm> ++Example of use: +mvn test -Dsurefire.enableProcessChecker=all + + + enablePropertiesElement + boolean -+ 3.3.1 + false + true -+ Flag for including/excluding <properties /> element for successfully passed tests in XML reports. ++ + + + encoding @@ -4106,10 +3626,9 @@ index 000000000..3a76ee7b9 + + environmentVariables + java.util.Map -+ 2.1.3 + false + true -+ Additional environment variables to set on the command line. ++ + + + excludeJUnit5Engines @@ -4125,32 +3644,28 @@ index 000000000..3a76ee7b9 + 3.0.0-M4 + false + true -+ You can selectively exclude individual environment variables by enumerating their keys. -+The environment is a system-dependent mapping from keys to values which is inherited from the Maven process to the forked Surefire processes. The keys must literally (case sensitive) match in order to exclude their environment variable. -+Example to exclude three environment variables: ++ You can selectively exclude individual environment variables by enumerating their keys. ++The environment is a system-dependent mapping from keys to values which is inherited from the Maven process to the forked Surefire processes. The keys must literally (case sensitive) match in order to exclude their environment variable. ++Example to exclude three environment variables: +mvn test -Dsurefire.excludedEnvironmentVariables=ACME1,ACME2,ACME3 + + + excludedGroups + java.lang.String -+ 2.2 + false + true -+ (TestNG/JUnit47 provider with JUnit4.8+ only and JUnit5+ provider since 2.22.0) Excluded groups/categories/tags. Any methods/classes/etc with one of the groups/categories/tags specified in this list will specifically not be run. -+For JUnit4, this parameter forces the use of the 4.7 provider. For JUnit5, this parameter forces the use of the JUnit platform provider. -+This parameter is ignored if the suiteXmlFiles parameter is specified. -+Since version 2.18.1 and JUnit 4.12, the @Category annotation type is automatically inherited from superclasses, see @java.lang.annotation.Inherited. Make sure that test class inheritance still makes sense together with @Category annotation of the JUnit 4.12 or higher appeared in superclass. ++ + + + excludes + java.util.List + false + true -+ A list of <exclude> elements specifying the tests (by pattern) that should be excluded in testing. When not specified and when the test parameter is not specified, the default excludes will be -+<excludes> <exclude>**/*$*</exclude> </excludes> (which excludes all inner classes). -+This parameter is ignored if the TestNG suiteXmlFiles parameter is specified. ++ A list of <exclude> elements specifying the tests (by pattern) that should be excluded in testing. When not specified and when the test parameter is not specified, the default excludes will be ++<excludes> <exclude>**/*$*</exclude> </excludes> (which excludes all inner classes). ++This parameter is ignored if the TestNG suiteXmlFiles parameter is specified. +Each exclude item may also contain a comma-separated sub-list of items, which will be treated as multiple <exclude> entries. -+Since 2.19 a complex syntax is supported in one parameter (JUnit 4, JUnit 4.7+, TestNG): <exclude>%regex[pkg.*Slow.*.class], Unstable*</exclude> ++Since 2.19 a complex syntax is supported in one parameter (JUnit 4, JUnit 4.7+, TestNG): <exclude>%regex[pkg.*Slow.*.class], Unstable*</exclude> +Notice that these values are relative to the directory containing generated test classes of the project being tested. This directory is declared by the parameter testClassesDirectory which defaults to the POM property ${project.build.testOutputDirectory}, typically src/test/java unless overridden. + + @@ -4173,10 +3688,9 @@ index 000000000..3a76ee7b9 + + failIfNoTests + boolean -+ 2.4 + false + true -+ Set this to "true" to cause a failure if there are no tests to run. Defaults to "false". ++ + + + failOnFlakeCount @@ -4189,14 +3703,9 @@ index 000000000..3a76ee7b9 + + forkCount + java.lang.String -+ 2.14 + false + true -+ Option to specify the number of VMs to fork in parallel in order to execute the tests. When terminated with "C", the number part is multiplied with the number of CPU cores. Floating point value are only accepted together with "C". If set to "0", no VM is forked and all tests are executed within the main process. -+ -+Example values: "1.5C", "4" -+ -+The system properties and the argLine of the forked processes may contain the place holder string ${surefire.forkNumber}, which is replaced with a fixed number for each of the parallel forks, ranging from 1 to the effective value of forkCount times the maximum number of parallel Surefire executions in maven parallel builds, i.e. the effective value of the -T command line argument of maven core. ++ + + + forkNode @@ -4204,7 +3713,7 @@ index 000000000..3a76ee7b9 + 3.0.0-M5 + false + true -+ This parameter configures the forked node. Currently, you can select the communication protocol, i.e. process pipes or TCP/IP sockets. The plugin uses process pipes by default which will be turned to TCP/IP in the version 3.0.0. Alternatively, you can implement your own factory and SPI. ++ This parameter configures the forked node. Currently, you can select the communication protocol, i.e. process pipes or TCP/IP sockets. The plugin uses process pipes by default which will be turned to TCP/IP in the version 3.0.0. Alternatively, you can implement your own factory and SPI. +See the documentation for more details: +https://maven.apache.org/plugins/maven-surefire-plugin/examples/process-communication.html <https://maven.apache.org/plugins/maven-surefire-plugin/examples/process-communication.html> + @@ -4227,13 +3736,9 @@ index 000000000..3a76ee7b9 + + groups + java.lang.String -+ 2.2 + false + true -+ (TestNG/JUnit47 provider with JUnit4.8+ only and JUnit5+ provider since 2.22.0) Groups/categories/tags for this test. Only classes/methods/etc decorated with one of the groups/categories/tags specified here will be included in test run, if specified. -+For JUnit4 tests, this parameter forces the use of the 4.7 provider. For JUnit5 tests, this parameter forces the use of the JUnit platform provider. -+This parameter is ignored if the suiteXmlFiles parameter is specified. -+Since version 2.18.1 and JUnit 4.12, the @Category annotation type is automatically inherited from superclasses, see @java.lang.annotation.Inherited. Make sure that test class inheritance still makes sense together with @Category annotation of the JUnit 4.12 or higher appeared in superclass. ++ + + + includeJUnit5Engines @@ -4249,7 +3754,7 @@ index 000000000..3a76ee7b9 + false + true + A list of <include> elements specifying the tests (by pattern) that should be included in testing. When not specified and when the test parameter is not specified, the default includes will be <includes> <include>**/Test*.java</include> <include>**/*Test.java</include> <include>**/*Tests.java</include> <include>**/*TestCase.java</include> </includes> Each include item may also contain a comma-separated sub-list of items, which will be treated as multiple <include> entries. -+Since 2.19 a complex syntax is supported in one parameter (JUnit 4, JUnit 4.7+, TestNG): <include>%regex[.*[Cat|Dog].*], Basic????, !Unstable*</include> <include>%regex[.*[Cat|Dog].*], !%regex[pkg.*Slow.*.class], pkg/**/*Fast*.java</include> ++Since 2.19 a complex syntax is supported in one parameter (JUnit 4, JUnit 4.7+, TestNG): <include>%regex[.*[Cat|Dog].*], Basic????, !Unstable*</include> <include>%regex[.*[Cat|Dog].*], !%regex[pkg.*Slow.*.class], pkg/**/*Fast*.java</include> +This parameter is ignored if the TestNG suiteXmlFiles parameter is specified. + +Notice that these values are relative to the directory containing generated test classes of the project being tested. This directory is declared by the parameter testClassesDirectory which defaults to the POM property ${project.build.testOutputDirectory}, typically src/test/java unless overridden. @@ -4260,75 +3765,57 @@ index 000000000..3a76ee7b9 + 2.13 + false + true -+ A file containing include patterns. Blank lines, or lines starting with # are ignored. If includes are also specified, these patterns are appended. Example with path, simple and regex includes: */test/* **/NotIncludedByDefault.java %regex[.*Test.*|.*Not.*] ++ A file containing include patterns. Blank lines, or lines starting with # are ignored. If includes are also specified, these patterns are appended. Example with path, simple and regex includes: */test/* **/NotIncludedByDefault.java %regex[.*Test.*|.*Not.*] +Since 3.0.0-M6, method filtering support is provided in the inclusions file as well, example: pkg.SomeTest#testMethod + + + jdkToolchain + java.util.Map -+ 3.0.0-M5 and Maven 3.3.x + false + true -+ -+Allow for configuration of the test jvm via maven toolchains. This permits a configuration where the project is built with one jvm and tested with another. This is similar to jvm, but avoids hardcoding paths. The two parameters are mutually exclusive (jvm wins) -+ -+Examples: -+(see Guide to Toolchains <https://maven.apache.org/guides/mini/guide-using-toolchains.html> for more info) <configuration> ... <jdkToolchain> <version>1.11</version> </jdkToolchain> </configuration> <configuration> ... <jdkToolchain> <version>1.8</version> <vendor>zulu</vendor> </jdkToolchain> </configuration> ++ + + + junitArtifactName + java.lang.String -+ 2.3.1 + false + true -+ Allows you to specify the name of the JUnit artifact. If not set, junit:junit will be used. ++ + + + jvm + java.lang.String -+ 2.1 + false + true -+ Option to specify the jvm (or path to the java executable) to use with the forking options. For the default, the jvm will be a new instance of the same VM as the one used to run Maven. JVM settings are not inherited from MAVEN_OPTS. ++ + + + objectFactory + java.lang.String -+ 2.5 + false + true -+ (TestNG only) Define the factory class used to create all test instances. ++ + + + parallel + java.lang.String -+ 2.2 + false + true -+ (TestNG provider) When you use the parameter parallel, TestNG will try to run all your test methods in separate threads, except for methods that depend on each other, which will be run in the same thread in order to respect their order of execution. Supports two values: classes or methods. -+(JUnit 4.7 provider) Supports values classes, methods, both to run in separate threads been controlled by threadCount. -+ -+Since version 2.16 (JUnit 4.7 provider), the value both is DEPRECATED. Use classesAndMethods instead. -+ -+Since version 2.16 (JUnit 4.7 provider), additional vales are available: -+suites, suitesAndClasses, suitesAndMethods, classesAndMethods, all. -+By default, Surefire does not execute tests in parallel. You can set the parameter parallel to none to explicitly disable parallel execution (e.g. when disabling parallel execution in special Maven profiles when executing coverage analysis). ++ + + + parallelMavenExecution + java.lang.Boolean + false + false -+ Parallel Maven Execution. ++ + + + parallelOptimized + boolean -+ 2.17 + false + true -+ (JUnit 4.7 / provider only) The thread counts do not exceed the number of parallel suite, class runners and average number of methods per class if set to true. -+True by default. ++ + + + parallelTestsTimeoutForcedInSeconds @@ -4336,7 +3823,7 @@ index 000000000..3a76ee7b9 + 2.16 + false + true -+ Stop executing queued parallel JUnit tests and interrupt currently running tests after a certain number of seconds. ++ Stop executing queued parallel JUnit tests and interrupt currently running tests after a certain number of seconds. +Example values: "3.5", "4" + +If set to 0, wait forever, never timing out. Makes sense with specified parallel different from "none". @@ -4347,7 +3834,7 @@ index 000000000..3a76ee7b9 + 2.16 + false + true -+ Stop executing queued parallel JUnit tests after a certain number of seconds. ++ Stop executing queued parallel JUnit tests after a certain number of seconds. +Example values: "3.5", "4" + +If set to 0, wait forever, never timing out. Makes sense with specified parallel different from "none". @@ -4355,25 +3842,23 @@ index 000000000..3a76ee7b9 + + perCoreThreadCount + boolean -+ 2.5 + false + true -+ (JUnit 4.7 provider) Indicates that threadCount, threadCountSuites, threadCountClasses, threadCountMethods are per cpu core. ++ + + + pluginArtifactMap + java.util.Map + true + false -+ Map of plugin artifacts. ++ + + + pluginDescriptor + org.apache.maven.plugin.descriptor.PluginDescriptor -+ 2.12 + true + false -+ Information about this plugin, mainly used to lookup this plugin's configuration from the currently executing project. ++ + + + printSummary @@ -4387,50 +3872,42 @@ index 000000000..3a76ee7b9 + org.apache.maven.project.MavenProject + true + false -+ The Maven Project Object. ++ + + + projectArtifactMap + java.util.Map + true + false -+ Map of project artifacts. ++ + + + projectBuildDirectory + java.io.File -+ 2.20 + true + false -+ Read-only parameter with value of Maven property project.build.directory. ++ + + + promoteUserPropertiesToSystemProperties + boolean -+ 3.4.0 + false + true -+ If set to true will also pass all user properties exposed via MavenSession#getUserProperties() as system properties to a provider. Those always take precedence over same named system properties set via any other means. -+See also: systemPropertyVariables ++ + + + properties + java.util.Properties -+ 2.4 + false + true -+ List of properties for configuring the testing provider. This is the preferred method of configuring TestNG and JUnit platform providers. -+ -+JUnit platform properties may be defined in a configurationParameters element: <properties> <configurationParameters> junit.jupiter.execution.parallel.enabled = true junit.jupiter.execution.parallel.mode.default = concurrent </configurationParameters> </properties> -+TestNG properties may be defined as distinct element blocks: <properties> <property> <name>parallel</name> <value>methods</value> </property> </properties> ++ + + + redirectTestOutputToFile + boolean -+ 2.3 + false + true -+ Set this to "true" to redirect the unit test standard output to a file (found in reportsDirectory/testName-output.txt). ++ + + + reportFormat @@ -4444,7 +3921,7 @@ index 000000000..3a76ee7b9 + java.lang.String + false + true -+ Add custom text into report filename: TEST-testClassName-reportNameSuffix.xml, testClassName-reportNameSuffix.txt and testClassName-reportNameSuffix-output.txt. File TEST-testClassName-reportNameSuffix.xml has changed attributes 'testsuite'--'name' and 'testcase'--'classname' - reportNameSuffix is added to the attribute value. ++ + + + reportsDirectory @@ -4463,10 +3940,9 @@ index 000000000..3a76ee7b9 + + reuseForks + boolean -+ 2.13 + false + true -+ Indicates if forked VMs can be reused. If set to "false", a new VM is forked for each test class to be executed. If set to "true", up to forkCount VMs will be forked and then reused to execute all tests. ++ + + + runOrder @@ -4474,13 +3950,13 @@ index 000000000..3a76ee7b9 + 2.7 + false + true -+ Defines the order the tests will be run in. Supported values are alphabetical, reversealphabetical, random, hourly (alphabetical on even hours, reverse alphabetical on odd hours), failedfirst, balanced and filesystem. ++ Defines the order the tests will be run in. Supported values are alphabetical, reversealphabetical, random, hourly (alphabetical on even hours, reverse alphabetical on odd hours), failedfirst, balanced and filesystem. + -+Odd/Even for hourly is determined at the time the of scanning the classpath, meaning it could change during a multi-module build. ++Odd/Even for hourly is determined at the time the of scanning the classpath, meaning it could change during a multi-module build. + -+Failed first will run tests that failed on previous run first, as well as new tests for this run. ++Failed first will run tests that failed on previous run first, as well as new tests for this run. + -+Balanced is only relevant with parallel=classes, and will try to optimize the run-order of the tests reducing the overall execution time. Initially a statistics file is created and every next test run will reorder classes. ++Balanced is only relevant with parallel=classes, and will try to optimize the run-order of the tests reducing the overall execution time. Initially a statistics file is created and every next test run will reorder classes. + +Note that the statistics are stored in a file named .surefire-XXXXXXXXX beside pom.xml and should not be checked into version control. The "XXXXX" is the SHA1 checksum of the entire surefire configuration, so different configurations will have different statistics files, meaning if you change any configuration settings you will re-run once before new statistics data can be established. + @@ -4490,9 +3966,9 @@ index 000000000..3a76ee7b9 + 3.0.0-M6 + false + true -+ Sets the random seed that will be used to order the tests if surefire.runOrder is set to random. ++ Sets the random seed that will be used to order the tests if surefire.runOrder is set to random. + -+If no seeds are set and surefire.runOrder is set to random, then the seed used will be outputted (search for "To reproduce ordering use flag -Dsurefire.runOrder.random.seed"). ++If no seeds are set and surefire.runOrder is set to random, then the seed used will be outputted (search for "To reproduce ordering use flag -Dsurefire.runOrder.random.seed"). + +To deterministically reproduce any random test order that was run before, simply set the seed to be the same value. + @@ -4501,7 +3977,7 @@ index 000000000..3a76ee7b9 + org.apache.maven.execution.MavenSession + true + false -+ The current build session instance. ++ + + + shutdown @@ -4509,11 +3985,11 @@ index 000000000..3a76ee7b9 + 2.19 + false + true -+ After the plugin process is shutdown by sending SIGTERM signal (CTRL+C), SHUTDOWN command is received by every forked JVM. -+The value is set to (shutdown=exit) by default (changed in version 3.0.0-M4). -+The parameter can be configured with other two values testset and kill. -+With(shutdown=testset) the test set may still continue to run in forked JVM. -+Using exit forked JVM executes System.exit(1) after the plugin process has received SIGTERM signal. ++ After the plugin process is shutdown by sending SIGTERM signal (CTRL+C), SHUTDOWN command is received by every forked JVM. ++The value is set to (shutdown=exit) by default (changed in version 3.0.0-M4). ++The parameter can be configured with other two values testset and kill. ++With(shutdown=testset) the test set may still continue to run in forked JVM. ++Using exit forked JVM executes System.exit(1) after the plugin process has received SIGTERM signal. +Using kill the JVM executes Runtime.halt(1) and kills itself. + + @@ -4521,7 +3997,7 @@ index 000000000..3a76ee7b9 + boolean + false + true -+ Set this to "true" to bypass unit tests entirely. Its use is NOT RECOMMENDED, especially if you enable it using the "maven.test.skip" property, because maven.test.skip disables both running the tests and compiling the tests. Consider using the skipTests parameter instead. ++ + + + skipAfterFailureCount @@ -4537,20 +4013,17 @@ index 000000000..3a76ee7b9 + + skipExec + boolean -+ 2.3 -+ Use skipTests instead. ++ No reason given + false + true -+ This old parameter is just like skipTests, but bound to the old property "maven.test.skip.exec". ++ + + + skipTests + boolean -+ 2.4 + false + true -+ Set this to "true" to skip running tests, but still compile them. Its use is NOT RECOMMENDED, but quite convenient on occasion. -+Failsafe plugin deprecated the parameter skipTests and the parameter will be removed in Failsafe 3.0.0 as it is a source of conflicts between Failsafe and Surefire plugin. ++ + + + statelessTestsetInfoReporter @@ -4564,7 +4037,7 @@ index 000000000..3a76ee7b9 + org.apache.maven.plugin.surefire.extensions.SurefireStatelessReporter + false + true -+ Note: use the legacy system property disableXmlReport set to true to disable the report. ++ + + + suiteXmlFiles @@ -4578,11 +4051,10 @@ index 000000000..3a76ee7b9 + + systemProperties + java.util.Properties -+ Use systemPropertyVariables instead. ++ No reason given + false + true -+ List of System properties to pass to a provider. -+See also: systemPropertyVariables for how the effective provider properties are calculated ++ + + + systemPropertiesFile @@ -4590,48 +4062,32 @@ index 000000000..3a76ee7b9 + false + true + Properties file being used as system properties passed to the provider. -+See also: systemPropertyVariables for how the effective provider properties are calculated ++See also: AbstractSurefireMojo#systemPropertyVariables systemPropertyVariables for how the effective provider properties are calculated + + + systemPropertyVariables + java.util.Map -+ 2.5 + false + true -+ List of System properties to pass to a provider. The effective system properties given to a provider are contributed from several sources: -+* properties set via argLine with -D (only for forked executions) -+* systemProperties -+* getSystemPropertiesFile() (set via parameter systemPropertiesFile on some goals) -+* systemPropertyVariables -+* User properties from MavenSession#getUserProperties(), usually set via CLI options given with -D on the current Maven process (only used as source if promoteUserPropertiesToSystemProperties is true) Later sources may overwrite same named properties from earlier sources, that means for example that one cannot overwrite user properties with either systemProperties, getSystemPropertiesFile() or systemPropertyVariables. -+Certain properties may only be overwritten via argLine (applicable only for forked executions) because their values are cached and only evaluated at the start of the JRE. Those include: -+ -+* java.library.path -+* file.encoding -+* jdk.map.althashing.threshold -+* line.separator -+See also: systemProperties ++ + + + tempDir + java.lang.String -+ 2.20 + false + true -+ Relative path to temporary-surefire-boot directory containing internal Surefire temporary files. -+The temporary-surefire-boot directory is project.build.directory on most platforms or system default temporary-directory specified by the system property java.io.tmpdir on Windows (see SUREFIRE-1400 <https://issues.apache.org/jira/browse/SUREFIRE-1400>). -+It is deleted after the test set has completed. ++ + + + test + java.lang.String + false + true -+ Specify this parameter to run individual tests by file name, overriding the parameter includes and excludes. Each pattern you specify here will be used to create an include pattern formatted like **/${test}.java, so you can just type -Dtest=MyTest to run a single test called "foo/MyTest.java". The test patterns prefixed with a ! will be excluded. -+This parameter overrides the parameter includes, excludes, and the TestNG parameter suiteXmlFiles. ++ Specify this parameter to run individual tests by file name, overriding the parameter includes and excludes. Each pattern you specify here will be used to create an include pattern formatted like **/${test}.java, so you can just type -Dtest=MyTest to run a single test called "foo/MyTest.java". The test patterns prefixed with a ! will be excluded. ++This parameter overrides the parameter includes, excludes, and the TestNG parameter suiteXmlFiles. +Since 2.7.3, you can execute a limited number of methods in the test by adding #myMethod or #my*ethod. For example, -Dtest=MyTest#myMethod. This is supported for junit 4.x and TestNg. + -+Since 2.19 a complex syntax is supported in one parameter (JUnit 4, JUnit 4.7+, TestNG): "-Dtest=???Test, !Unstable*, pkg/**/Ci*leTest.java, *Test#test*One+testTwo?????, #fast*+slowTest" or e.g. "-Dtest=Basic*, !%regex[.*.Unstable.*], !%regex[.*.MyTest.class#one.*|two.*], %regex[#fast.*|slow.*]" ++Since 2.19 a complex syntax is supported in one parameter (JUnit 4, JUnit 4.7+, TestNG): "-Dtest=???Test, !Unstable*, pkg/**/Ci*leTest.java, *Test#test*One+testTwo?????, #fast*+slowTest" or e.g. "-Dtest=Basic*, !%regex[.*.Unstable.*], !%regex[.*.MyTest.class#one.*|two.*], %regex[#fast.*|slow.*]" +The Parameterized JUnit runner describes test methods using an index in brackets, so the non-regex method pattern would become: #testMethod[*]. If using @Parameters(name="{index}: fib({0})={1}") and selecting the index e.g. 5 in pattern, the non-regex method pattern would become #testMethod[5:*]. + + @@ -4639,7 +4095,7 @@ index 000000000..3a76ee7b9 + java.io.File + false + true -+ The directory containing generated test classes of the project being tested. This will be included at the beginning of the test classpath. ++ + + + testFailureIgnore @@ -4651,69 +4107,51 @@ index 000000000..3a76ee7b9 + + testNGArtifactName + java.lang.String -+ 2.3.1 + false + true -+ Allows you to specify the name of the TestNG artifact. If not set, org.testng:testng will be used. ++ + + + testSourceDirectory + java.io.File -+ 2.2 + false + true -+ The test source directory containing test class sources. Important only for TestNG HTML reports. ++ + + + threadCount + int -+ 2.2 + false + true -+ (TestNG/JUnit 4.7 provider) The attribute thread-count allows you to specify how many threads should be allocated for this execution. Only makes sense to use in conjunction with the parallel parameter. ++ + + + threadCountClasses + int -+ 2.16 + false + true -+ (JUnit 4.7 provider) This attribute allows you to specify the concurrency in test classes, i.e.: -+* number of concurrent classes if threadCount is 0 or unspecified -+* limited classes concurrency if useUnlimitedThreads is set to true -+* if threadCount and certain thread-count parameters are > 0 for parallel, the concurrency is computed from ratio. For instance parallel=all and the ratio between threadCountSuites:threadCountClasses:threadCountMethods is 2:3:5, there is 30% of threadCount in concurrent classes. -+* as in the previous case but without this leaf thread-count. Example: parallel=suitesAndClasses, threadCount=16, threadCountSuites=5, threadCountClasses is unspecified leaf, the number of concurrent classes is varying from >= 11 to 14 or 15. The threadCountSuites become given number of threads. Only makes sense to use in conjunction with the parallel parameter. The default value 0 behaves same as unspecified one. ++ + + + threadCountMethods + int -+ 2.16 + false + true -+ (JUnit 4.7 provider) This attribute allows you to specify the concurrency in test methods, i.e.: -+* number of concurrent methods if threadCount is 0 or unspecified -+* limited concurrency of methods if useUnlimitedThreads is set to true -+* if threadCount and certain thread-count parameters are > 0 for parallel, the concurrency is computed from ratio. For instance parallel=all and the ratio between threadCountSuites:threadCountClasses:threadCountMethods is 2:3:5, there is 50% of threadCount which appears in concurrent methods. -+* as in the previous case but without this leaf thread-count. Example: parallel=all, threadCount=16, threadCountSuites=2, threadCountClasses=3, but threadCountMethods is unspecified leaf, the number of concurrent methods is varying from >= 11 to 14 or 15. The threadCountSuites and threadCountClasses become given number of threads. Only makes sense to use in conjunction with the parallel parameter. The default value 0 behaves same as unspecified one. ++ + + + threadCountSuites + int -+ 2.16 + false + true -+ (JUnit 4.7 provider) This attribute allows you to specify the concurrency in test suites, i.e.: -+* number of concurrent suites if threadCount is 0 or unspecified -+* limited suites concurrency if useUnlimitedThreads is set to true -+* if threadCount and certain thread-count parameters are > 0 for parallel, the concurrency is computed from ratio. For instance parallel=all and the ratio between threadCountSuites:threadCountClasses:threadCountMethods is 2:3:5, there is 20% of threadCount which appeared in concurrent suites. Only makes sense to use in conjunction with the parallel parameter. The default value 0 behaves same as unspecified one. ++ + + + trimStackTrace + boolean -+ 2.2 + false + true -+ Whether to trim the stack trace in the reports to just the lines within the test, or show the full trace. ++ + + + useFile @@ -4728,7 +4166,7 @@ index 000000000..3a76ee7b9 + 2.4.3 + false + true -+ By default, Surefire forks your tests using a manifest-only JAR; set this parameter to "false" to force it to launch your tests with a plain old Java classpath. (See the http://maven.apache.org/plugins/maven-surefire-plugin/examples/class-loading.html <http://maven.apache.org/plugins/maven-surefire-plugin/examples/class-loading.html> for a more detailed explanation of manifest-only JARs and their benefits.) ++ By default, Surefire forks your tests using a manifest-only JAR; set this parameter to "false" to force it to launch your tests with a plain old Java classpath. (See the http://maven.apache.org/plugins/maven-surefire-plugin/examples/class-loading.html <http://maven.apache.org/plugins/maven-surefire-plugin/examples/class-loading.html> for a more detailed explanation of manifest-only JARs and their benefits.) +Beware, setting this to "false" may cause your tests to fail on Windows if your classpath is too long. + + @@ -4737,7 +4175,7 @@ index 000000000..3a76ee7b9 + 3.0.0-M2 + false + true -+ When true, uses the modulepath when executing with JDK 9+ and module-info.java is present. When false, always uses the classpath. ++ When true, uses the modulepath when executing with JDK 9+ and module-info.java is present. When false, always uses the classpath. +Defaults to true. + + @@ -4751,18 +4189,16 @@ index 000000000..3a76ee7b9 + + useUnlimitedThreads + boolean -+ 2.5 + false + true -+ (JUnit 4.7 provider) Indicates that the thread pool will be unlimited. The parallel parameter and the actual number of classes/methods will decide. Setting this to "true" effectively disables perCoreThreadCount and threadCount. Defaults to "false". ++ + + + workingDirectory + java.io.File -+ 2.1.3 + false + true -+ Command line working directory. ++ + + + @@ -4775,7 +4211,7 @@ index 000000000..3a76ee7b9 + ${maven.test.dependency.excludes} + ${maven.surefire.debug} + ${dependenciesToScan} -+ ${disableXmlReport} ++ ${disableXmlReport} + ${enableAssertions} + ${enableOutErrElements} + ${surefire.enableProcessChecker} @@ -4876,19 +4312,7 @@ index 000000000..3a76ee7b9 + org.apache.maven.surefire + surefire-api + jar -+ 3.5.0 -+ -+ -+ org.apache.commons -+ commons-lang3 -+ jar -+ 3.16.0 -+ -+ -+ org.apache.maven.surefire -+ surefire-logger-api -+ jar -+ 3.5.0 ++ 3.5.2 + + + org.apache.maven.shared @@ -4897,28 +4321,58 @@ index 000000000..3a76ee7b9 + 3.3.4 + + ++ commons-io ++ commons-io ++ jar ++ 2.17.0 ++ ++ + org.slf4j + slf4j-api + jar + 1.7.36 + + -+ commons-io -+ commons-io ++ org.apache.maven.surefire ++ surefire-logger-api + jar -+ 2.16.1 ++ 3.5.2 ++ ++ ++ org.apache.commons ++ commons-lang3 ++ jar ++ 3.17.0 + + + org.apache.maven.surefire + surefire-extensions-api + jar -+ 3.5.0 ++ 3.5.2 + + + org.apache.maven.surefire + maven-surefire-common + jar -+ 3.5.0 ++ 3.5.2 ++ ++ ++ org.codehaus.plexus ++ plexus-java ++ jar ++ 1.3.0 ++ ++ ++ org.ow2.asm ++ asm ++ jar ++ 9.6 ++ ++ ++ com.thoughtworks.qdox ++ qdox ++ jar ++ 2.0.3 + + + org.apache.commons @@ -4933,18 +4387,6 @@ index 000000000..3a76ee7b9 + 1.16.1 + + -+ org.apache.maven.surefire -+ surefire-booter -+ jar -+ 3.5.0 -+ -+ -+ org.apache.maven.surefire -+ surefire-extensions-spi -+ jar -+ 3.5.0 -+ -+ + org.apache.maven.resolver + maven-resolver-util + jar @@ -4957,36 +4399,28 @@ index 000000000..3a76ee7b9 + 1.9.22 + + ++ org.apache.maven.surefire ++ surefire-booter ++ jar ++ 3.5.2 ++ ++ ++ org.apache.maven.surefire ++ surefire-extensions-spi ++ jar ++ 3.5.2 ++ ++ + org.apache.maven.shared + maven-common-artifact-filters + jar + 3.4.0 + -+ -+ org.codehaus.plexus -+ plexus-java -+ jar -+ 1.2.0 -+ -+ -+ org.ow2.asm -+ asm -+ jar -+ 9.6 -+ -+ -+ com.thoughtworks.qdox -+ qdox -+ jar -+ 2.0.3 -+ + + -diff --git a/maven-surefire-plugin/src/main/java/org/apache/maven/plugin/maven_surefire_plugin/HelpMojo.java b/maven-surefire-plugin/src/main/java/org/apache/maven/plugin/maven_surefire_plugin/HelpMojo.java -new file mode 100644 -index 000000000..fc1065a39 ---- /dev/null -+++ b/maven-surefire-plugin/src/main/java/org/apache/maven/plugin/maven_surefire_plugin/HelpMojo.java +diff -urEbwBN a/maven-surefire-plugin/src/main/java/org/apache/maven/plugin/maven_surefire_plugin/HelpMojo.java b/maven-surefire-plugin/src/main/java/org/apache/maven/plugin/maven_surefire_plugin/HelpMojo.java +--- a/maven-surefire-plugin/src/main/java/org/apache/maven/plugin/maven_surefire_plugin/HelpMojo.java 1970-01-01 01:00:00.000000000 +0100 ++++ b/maven-surefire-plugin/src/main/java/org/apache/maven/plugin/maven_surefire_plugin/HelpMojo.java 2024-11-04 10:41:36.879493528 +0100 @@ -0,0 +1,448 @@ +package org.apache.maven.plugins.maven_surefire_plugin; + @@ -5436,11 +4870,9 @@ index 000000000..fc1065a39 + return null; + } +} -diff --git a/maven-surefire-report-plugin/src/main/filtered-resources/META-INF/maven/org.apache.maven.plugins/maven-surefire-report-plugin/plugin-help.xml b/maven-surefire-report-plugin/src/main/filtered-resources/META-INF/maven/org.apache.maven.plugins/maven-surefire-report-plugin/plugin-help.xml -new file mode 100644 -index 000000000..e93a949b0 ---- /dev/null -+++ b/maven-surefire-report-plugin/src/main/filtered-resources/META-INF/maven/org.apache.maven.plugins/maven-surefire-report-plugin/plugin-help.xml +diff -urEbwBN a/maven-surefire-report-plugin/src/main/filtered-resources/META-INF/maven/org.apache.maven.plugins/maven-surefire-report-plugin/plugin-help.xml b/maven-surefire-report-plugin/src/main/filtered-resources/META-INF/maven/org.apache.maven.plugins/maven-surefire-report-plugin/plugin-help.xml +--- a/maven-surefire-report-plugin/src/main/filtered-resources/META-INF/maven/org.apache.maven.plugins/maven-surefire-report-plugin/plugin-help.xml 1970-01-01 01:00:00.000000000 +0100 ++++ b/maven-surefire-report-plugin/src/main/filtered-resources/META-INF/maven/org.apache.maven.plugins/maven-surefire-report-plugin/plugin-help.xml 2024-11-04 10:45:39.894480900 +0100 @@ -0,0 +1,496 @@ + + @@ -5491,7 +4923,7 @@ index 000000000..e93a949b0 + 3.1.0 + false + true -+ Path for a custom bundle instead of using the default one. ++ Path for a custom bundle instead of using the default one. +Using this field, you could change the texts in the generated reports. + + @@ -5578,7 +5010,7 @@ index 000000000..e93a949b0 + java.io.File + false + true -+ Location where Test Source XRef is generated for this project. ++ Location where Test Source XRef is generated for this project. +Default: org.apache.maven.reporting.AbstractMavenReport.getReportOutputDirectory() + /xref-test + + @@ -5687,7 +5119,7 @@ index 000000000..e93a949b0 + 3.1.0 + false + true -+ Path for a custom bundle instead of using the default one. ++ Path for a custom bundle instead of using the default one. +Using this field, you could change the texts in the generated reports. + + @@ -5774,7 +5206,7 @@ index 000000000..e93a949b0 + java.io.File + false + true -+ Location where Test Source XRef is generated for this project. ++ Location where Test Source XRef is generated for this project. +Default: org.apache.maven.reporting.AbstractMavenReport.getReportOutputDirectory() + /xref-test + + @@ -5830,7 +5262,7 @@ index 000000000..e93a949b0 + 3.1.0 + false + true -+ Path for a custom bundle instead of using the default one. ++ Path for a custom bundle instead of using the default one. +Using this field, you could change the texts in the generated reports. + + @@ -5917,7 +5349,7 @@ index 000000000..e93a949b0 + java.io.File + false + true -+ Location where Test Source XRef is generated for this project. ++ Location where Test Source XRef is generated for this project. +Default: org.apache.maven.reporting.AbstractMavenReport.getReportOutputDirectory() + /xref-test + + @@ -5938,11 +5370,9 @@ index 000000000..e93a949b0 + + + -diff --git a/maven-surefire-report-plugin/src/main/filtered-resources/META-INF/maven/plugin.xml b/maven-surefire-report-plugin/src/main/filtered-resources/META-INF/maven/plugin.xml -new file mode 100644 -index 000000000..744c56d5b ---- /dev/null -+++ b/maven-surefire-report-plugin/src/main/filtered-resources/META-INF/maven/plugin.xml +diff -urEbwBN a/maven-surefire-report-plugin/src/main/filtered-resources/META-INF/maven/plugin.xml b/maven-surefire-report-plugin/src/main/filtered-resources/META-INF/maven/plugin.xml +--- a/maven-surefire-report-plugin/src/main/filtered-resources/META-INF/maven/plugin.xml 1970-01-01 01:00:00.000000000 +0100 ++++ b/maven-surefire-report-plugin/src/main/filtered-resources/META-INF/maven/plugin.xml 2024-11-04 10:46:55.558333020 +0100 @@ -0,0 +1,958 @@ + + @@ -5997,7 +5427,7 @@ index 000000000..744c56d5b + 3.1.0 + false + true -+ Path for a custom bundle instead of using the default one. ++ Path for a custom bundle instead of using the default one. +Using this field, you could change the texts in the generated reports. + + @@ -6140,7 +5570,7 @@ index 000000000..744c56d5b + java.io.File + false + true -+ Location where Test Source XRef is generated for this project. ++ Location where Test Source XRef is generated for this project. +Default: org.apache.maven.reporting.AbstractMavenReport.getReportOutputDirectory() + /xref-test + + @@ -6275,7 +5705,7 @@ index 000000000..744c56d5b + 3.1.0 + false + true -+ Path for a custom bundle instead of using the default one. ++ Path for a custom bundle instead of using the default one. +Using this field, you could change the texts in the generated reports. + + @@ -6418,7 +5848,7 @@ index 000000000..744c56d5b + java.io.File + false + true -+ Location where Test Source XRef is generated for this project. ++ Location where Test Source XRef is generated for this project. +Default: org.apache.maven.reporting.AbstractMavenReport.getReportOutputDirectory() + /xref-test + + @@ -6500,7 +5930,7 @@ index 000000000..744c56d5b + 3.1.0 + false + true -+ Path for a custom bundle instead of using the default one. ++ Path for a custom bundle instead of using the default one. +Using this field, you could change the texts in the generated reports. + + @@ -6643,7 +6073,7 @@ index 000000000..744c56d5b + java.io.File + false + true -+ Location where Test Source XRef is generated for this project. ++ Location where Test Source XRef is generated for this project. +Default: org.apache.maven.reporting.AbstractMavenReport.getReportOutputDirectory() + /xref-test + + @@ -6694,19 +6124,19 @@ index 000000000..744c56d5b + org.apache.maven.surefire + surefire-logger-api + jar -+ 3.5.0 ++ 3.5.2 + + + org.apache.maven.surefire + surefire-report-parser + jar -+ 3.5.0 ++ 3.5.2 + + + org.eclipse.sisu + org.eclipse.sisu.plexus + jar -+ 0.9.0.M2 ++ 0.9.0.M3 + + + org.slf4j @@ -6730,13 +6160,13 @@ index 000000000..744c56d5b + org.eclipse.sisu + org.eclipse.sisu.inject + jar -+ 0.9.0.M2 ++ 0.9.0.M3 + + + org.codehaus.plexus + plexus-utils + jar -+ 4.0.0 ++ 4.0.1 + + + javax.inject @@ -6745,6 +6175,12 @@ index 000000000..744c56d5b + 1 + + ++ org.codehaus.plexus ++ plexus-xml ++ jar ++ 3.0.1 ++ ++ + org.apache.maven.shared + maven-shared-utils + jar @@ -6754,25 +6190,25 @@ index 000000000..744c56d5b + commons-io + commons-io + jar -+ 2.16.1 ++ 2.17.0 + + + org.apache.maven.doxia + doxia-sink-api + jar -+ 2.0.0-M12 ++ 2.0.0 + + + org.apache.maven.doxia + doxia-core + jar -+ 2.0.0-M12 ++ 2.0.0 + + + org.apache.commons + commons-lang3 + jar -+ 3.16.0 ++ 3.17.0 + + + org.apache.commons @@ -6784,55 +6220,55 @@ index 000000000..744c56d5b + org.apache.maven.reporting + maven-reporting-impl + jar -+ 4.0.0-M15 ++ 4.0.0 + + + org.apache.maven.doxia + doxia-site-renderer + jar -+ 2.0.0-M19 -+ -+ -+ org.apache.velocity -+ velocity-engine-core -+ jar -+ 2.3 ++ 2.0.0 + + + org.apache.maven.doxia + doxia-skin-model + jar -+ 2.0.0-M19 ++ 2.0.0 ++ ++ ++ org.apache.velocity ++ velocity-engine-core ++ jar ++ 2.4 + + + org.codehaus.plexus + plexus-velocity + jar -+ 2.1.0 ++ 2.2.0 + + + org.apache.maven.doxia + doxia-module-xhtml5 + jar -+ 2.0.0-M12 ++ 2.0.0 + + + org.apache.maven.doxia + doxia-module-xdoc + jar -+ 2.0.0-M12 ++ 2.0.0 + + + org.apache.maven.doxia + doxia-integration-tools + jar -+ 2.0.0-M19 ++ 2.0.0 + + + org.apache.maven.reporting + maven-reporting-api + jar -+ 4.0.0-M12 ++ 4.0.0 + + + org.apache.maven @@ -6844,7 +6280,7 @@ index 000000000..744c56d5b + org.codehaus.plexus + plexus-archiver + jar -+ 4.8.0 ++ 4.10.0 + + + org.codehaus.plexus @@ -6874,19 +6310,13 @@ index 000000000..744c56d5b + org.apache.maven.doxia + doxia-site-model + jar -+ 2.0.0-M19 ++ 2.0.0 + + + org.apache.maven.doxia + doxia-module-apt + jar -+ 2.0.0-M12 -+ -+ -+ org.codehaus.plexus -+ plexus-xml -+ jar -+ 4.0.0 ++ 2.0.0 + + + org.codehaus.plexus @@ -6902,11 +6332,9 @@ index 000000000..744c56d5b + + + -diff --git a/maven-surefire-report-plugin/src/main/java/org/apache/maven/plugin/maven_surefire_report_plugin/HelpMojo.java b/maven-surefire-report-plugin/src/main/java/org/apache/maven/plugin/maven_surefire_report_plugin/HelpMojo.java -new file mode 100644 -index 000000000..b0fcb4b3a ---- /dev/null -+++ b/maven-surefire-report-plugin/src/main/java/org/apache/maven/plugin/maven_surefire_report_plugin/HelpMojo.java +diff -urEbwBN a/maven-surefire-report-plugin/src/main/java/org/apache/maven/plugin/maven_surefire_report_plugin/HelpMojo.java b/maven-surefire-report-plugin/src/main/java/org/apache/maven/plugin/maven_surefire_report_plugin/HelpMojo.java +--- a/maven-surefire-report-plugin/src/main/java/org/apache/maven/plugin/maven_surefire_report_plugin/HelpMojo.java 1970-01-01 01:00:00.000000000 +0100 ++++ b/maven-surefire-report-plugin/src/main/java/org/apache/maven/plugin/maven_surefire_report_plugin/HelpMojo.java 2024-11-04 10:39:38.158690041 +0100 @@ -0,0 +1,448 @@ +package org.apache.maven.plugins.maven_surefire_report_plugin; + @@ -7356,6 +6784,3 @@ index 000000000..b0fcb4b3a + return null; + } +} --- -2.46.1 -