diff --git a/0001-Maven-3.patch b/0001-Maven-3.patch deleted file mode 100644 index c20df40..0000000 --- a/0001-Maven-3.patch +++ /dev/null @@ -1,34 +0,0 @@ -From 3bb1ab3a99b7db611b5d265701e1ba293413b027 Mon Sep 17 00:00:00 2001 -From: Michael Simacek -Date: Thu, 5 May 2016 11:20:48 +0200 -Subject: [PATCH 1/4] Maven 3 - ---- - .../apache/maven/plugin/surefire/SurefireHelper.java | 11 +---------- - 1 file changed, 1 insertion(+), 10 deletions(-) - -diff --git a/maven-surefire-common/src/main/java/org/apache/maven/plugin/surefire/SurefireHelper.java b/maven-surefire-common/src/main/java/org/apache/maven/plugin/surefire/SurefireHelper.java -index dd29cb4..dc7915c 100644 ---- a/maven-surefire-common/src/main/java/org/apache/maven/plugin/surefire/SurefireHelper.java -+++ b/maven-surefire-common/src/main/java/org/apache/maven/plugin/surefire/SurefireHelper.java -@@ -204,16 +204,7 @@ public final class SurefireHelper - private static String getFailureBehavior( MavenExecutionRequest request ) - throws NoSuchMethodException, InvocationTargetException, IllegalAccessException - { -- try -- { -- return request.getFailureBehavior(); -- } -- catch ( NoSuchMethodError e ) -- { -- return (String) request.getClass() -- .getMethod( "getReactorFailureBehavior" ) -- .invoke( request ); -- } -+ return request.getReactorFailureBehavior(); - } - - private static boolean failIfNoTests( SurefireReportParameters reportParameters ) --- -2.17.1 - diff --git a/0001-Port-to-TestNG-7.4.0.patch b/0001-Port-to-TestNG-7.4.0.patch new file mode 100644 index 0000000..be0600e --- /dev/null +++ b/0001-Port-to-TestNG-7.4.0.patch @@ -0,0 +1,66 @@ +From 2506b32ba90ef0e336f088e7aa8c12d3273ba242 Mon Sep 17 00:00:00 2001 +From: Mikolaj Izdebski +Date: Mon, 10 Jul 2017 10:37:50 +0200 +Subject: [PATCH 1/4] Port to TestNG 7.4.0 + +--- + pom.xml | 2 +- + surefire-providers/surefire-testng/pom.xml | 1 - + .../maven/surefire/testng/conf/AbstractDirectConfigurator.java | 2 +- + .../maven/surefire/testng/conf/TestNGMapConfigurator.java | 2 +- + 4 files changed, 3 insertions(+), 4 deletions(-) + +diff --git a/pom.xml b/pom.xml +index cb15de8f7..2f9a061e7 100644 +--- a/pom.xml ++++ b/pom.xml +@@ -97,7 +97,7 @@ + 3.3.4 + 2.0.9 + 0.8.11 +- 5.11 ++ 7.4.0 + ${project.version} + scm:git:https://gitbox.apache.org/repos/asf/maven-surefire.git + surefire-archives/surefire-LATEST +diff --git a/surefire-providers/surefire-testng/pom.xml b/surefire-providers/surefire-testng/pom.xml +index c7633d60c..00f22400c 100644 +--- a/surefire-providers/surefire-testng/pom.xml ++++ b/surefire-providers/surefire-testng/pom.xml +@@ -56,7 +56,6 @@ + org.testng + testng + ${testngVersion} +- jdk15 + provided + + +diff --git a/surefire-providers/surefire-testng/src/main/java/org/apache/maven/surefire/testng/conf/AbstractDirectConfigurator.java b/surefire-providers/surefire-testng/src/main/java/org/apache/maven/surefire/testng/conf/AbstractDirectConfigurator.java +index b73b9bacd..ab187b6d5 100644 +--- a/surefire-providers/surefire-testng/src/main/java/org/apache/maven/surefire/testng/conf/AbstractDirectConfigurator.java ++++ b/surefire-providers/surefire-testng/src/main/java/org/apache/maven/surefire/testng/conf/AbstractDirectConfigurator.java +@@ -57,7 +57,7 @@ public void configure(TestNG testng, Map options) throws TestSet + testng.setUseDefaultListeners(false); + configureInstance(testng, options); + // TODO: we should have the Profile so that we can decide if this is needed or not +- testng.setListenerClasses(loadListenerClasses(listeners)); ++ testng.setListenerClasses((List)loadListenerClasses(listeners)); + } + + @Override +diff --git a/surefire-providers/surefire-testng/src/main/java/org/apache/maven/surefire/testng/conf/TestNGMapConfigurator.java b/surefire-providers/surefire-testng/src/main/java/org/apache/maven/surefire/testng/conf/TestNGMapConfigurator.java +index d91e76afc..06dbd2316 100755 +--- a/surefire-providers/surefire-testng/src/main/java/org/apache/maven/surefire/testng/conf/TestNGMapConfigurator.java ++++ b/surefire-providers/surefire-testng/src/main/java/org/apache/maven/surefire/testng/conf/TestNGMapConfigurator.java +@@ -71,7 +71,7 @@ protected void configureThreadCount(XmlSuite suite, Map options) + protected void configureParallel(XmlSuite suite, Map options) throws TestSetFailedException { + String parallel = options.get(PARALLEL_PROP); + if (parallel != null) { +- suite.setParallel(parallel); ++ suite.setParallel(XmlSuite.ParallelMode.getValidParallel(parallel)); + } + } + +-- +2.44.0 + diff --git a/0002-Port-to-current-doxia.patch b/0002-Port-to-current-doxia.patch deleted file mode 100644 index e5bcea2..0000000 --- a/0002-Port-to-current-doxia.patch +++ /dev/null @@ -1,25 +0,0 @@ -From 16e1a53ff612f4a9a777e09cdc45988e9abbe2e2 Mon Sep 17 00:00:00 2001 -From: Michael Simacek -Date: Fri, 29 Jun 2018 12:44:37 +0200 -Subject: [PATCH 2/4] Port to current doxia - ---- - .../maven/plugins/surefire/report/SurefireReportGenerator.java | 2 +- - 1 file changed, 1 insertion(+), 1 deletion(-) - -diff --git a/maven-surefire-report-plugin/src/main/java/org/apache/maven/plugins/surefire/report/SurefireReportGenerator.java b/maven-surefire-report-plugin/src/main/java/org/apache/maven/plugins/surefire/report/SurefireReportGenerator.java -index f9b9480..f142c8d 100644 ---- a/maven-surefire-report-plugin/src/main/java/org/apache/maven/plugins/surefire/report/SurefireReportGenerator.java -+++ b/maven-surefire-report-plugin/src/main/java/org/apache/maven/plugins/surefire/report/SurefireReportGenerator.java -@@ -26,7 +26,7 @@ import java.util.Locale; - import java.util.Map; - import org.apache.maven.doxia.markup.HtmlMarkup; - import org.apache.maven.doxia.sink.Sink; --import org.apache.maven.doxia.sink.SinkEventAttributeSet; -+import org.apache.maven.doxia.sink.impl.SinkEventAttributeSet; - import org.apache.maven.doxia.util.DoxiaUtils; - import org.apache.maven.plugin.surefire.log.api.ConsoleLogger; - import org.apache.maven.reporting.MavenReportException; --- -2.17.1 - diff --git a/0003-Port-to-TestNG-7.4.0.patch b/0003-Port-to-TestNG-7.4.0.patch deleted file mode 100644 index 791a4f4..0000000 --- a/0003-Port-to-TestNG-7.4.0.patch +++ /dev/null @@ -1,34 +0,0 @@ ---- a/surefire-providers/surefire-testng/pom.xml -+++ b/surefire-providers/surefire-testng/pom.xml -@@ -51,8 +51,7 @@ - - org.testng - testng -- 5.10 -- jdk15 -+ 7.4.0 - provided - - ---- a/surefire-providers/surefire-testng/src/main/java/org/apache/maven/surefire/testng/conf/AbstractDirectConfigurator.java -+++ b/surefire-providers/surefire-testng/src/main/java/org/apache/maven/surefire/testng/conf/AbstractDirectConfigurator.java -@@ -63,7 +63,7 @@ public void configure( TestNG testng, Map options ) - testng.setUseDefaultListeners( false ); - configureInstance( testng, options ); - // TODO: we should have the Profile so that we can decide if this is needed or not -- testng.setListenerClasses( loadListenerClasses( listeners ) ); -+ testng.setListenerClasses( ( List ) loadListenerClasses( listeners ) ); - } - - @Override ---- a/surefire-providers/surefire-testng/src/main/java/org/apache/maven/surefire/testng/conf/TestNGMapConfigurator.java -+++ b/surefire-providers/surefire-testng/src/main/java/org/apache/maven/surefire/testng/conf/TestNGMapConfigurator.java -@@ -68,7 +68,7 @@ public void configure( XmlSuite suite, Map options ) - String parallel = options.get( PARALLEL_PROP ); - if ( parallel != null ) - { -- suite.setParallel( parallel ); -+ suite.setParallel( XmlSuite.ParallelMode.getValidParallel( parallel ) ); - } - } - diff --git a/0004-Port-to-current-maven-shared-utils.patch b/0004-Port-to-current-maven-shared-utils.patch deleted file mode 100644 index 0a01e3e..0000000 --- a/0004-Port-to-current-maven-shared-utils.patch +++ /dev/null @@ -1,109 +0,0 @@ ---- a/maven-surefire-common/src/main/java/org/apache/maven/plugin/surefire/booterclient/DefaultForkConfiguration.java 2022-04-26 11:44:38.061316377 +0200 -+++ b/maven-surefire-common/src/main/java/org/apache/maven/plugin/surefire/booterclient/DefaultForkConfiguration.java 2022-04-26 11:50:27.427430853 +0200 -@@ -130,14 +130,24 @@ - String jvmArgLine = newJvmArgLine( forkNumber ); - if ( !jvmArgLine.isEmpty() ) - { -- cli.createArg() -- .setLine( jvmArgLine ); -+ try -+ { -+ cli.createArg().setLine( jvmArgLine ); -+ } -+ catch (Exception e) -+ { -+ } - } - - if ( getDebugLine() != null && !getDebugLine().isEmpty() ) - { -- cli.createArg() -- .setLine( getDebugLine() ); -+ try -+ { -+ cli.createArg().setLine( getDebugLine() ); -+ } -+ catch (Exception e) -+ { -+ } - } - - resolveClasspath( cli, findStartClass( config ), config ); ---- a/maven-surefire-common/src/main/java/org/apache/maven/plugin/surefire/report/StatelessXmlReporter.java -+++ b/maven-surefire-common/src/main/java/org/apache/maven/plugin/surefire/report/StatelessXmlReporter.java -@@ -237,6 +237,10 @@ public class StatelessXmlReporter - } - ppw.endElement(); // TestSuite - } -+ catch (IOException e) -+ { -+ throw new RuntimeException(e); -+ } - finally - { - closeQuietly( fw ); -@@ -323,7 +327,7 @@ public class StatelessXmlReporter - } - - private static void startTestElement( XMLWriter ppw, WrappedReportEntry report, String reportNameSuffix, -- String timeAsString ) -+ String timeAsString ) throws IOException - { - ppw.startElement( "testcase" ); - ppw.addAttribute( "name", report.getReportName() ); -@@ -346,7 +350,7 @@ public class StatelessXmlReporter - } - - private void createTestSuiteElement( XMLWriter ppw, WrappedReportEntry report, TestSetStats testSetStats, -- String timeAsString ) -+ String timeAsString ) throws IOException - { - ppw.startElement( "testsuite" ); - -@@ -373,7 +377,7 @@ public class StatelessXmlReporter - - private static void getTestProblems( OutputStreamWriter outputStreamWriter, XMLWriter ppw, - WrappedReportEntry report, boolean trimStackTrace, OutputStream fw, -- String testErrorType, boolean createOutErrElementsInside ) -+ String testErrorType, boolean createOutErrElementsInside ) throws IOException - { - ppw.startElement( testErrorType ); - -@@ -418,7 +422,7 @@ public class StatelessXmlReporter - - // Create system-out and system-err elements - private static void createOutErrElements( OutputStreamWriter outputStreamWriter, XMLWriter ppw, -- WrappedReportEntry report, OutputStream fw ) -+ WrappedReportEntry report, OutputStream fw ) throws IOException - { - EncodingOutputStream eos = new EncodingOutputStream( fw ); - addOutputStreamElement( outputStreamWriter, eos, ppw, report.getStdout(), "system-out" ); -@@ -428,7 +432,7 @@ public class StatelessXmlReporter - private static void addOutputStreamElement( OutputStreamWriter outputStreamWriter, - EncodingOutputStream eos, XMLWriter xmlWriter, - Utf8RecodingDeferredFileOutputStream utf8RecodingDeferredFileOutputStream, -- String name ) -+ String name ) throws IOException - { - if ( utf8RecodingDeferredFileOutputStream != null && utf8RecodingDeferredFileOutputStream.getByteCount() > 0 ) - { -@@ -458,7 +462,7 @@ public class StatelessXmlReporter - * - * @param xmlWriter The test suite to report to - */ -- private static void showProperties( XMLWriter xmlWriter, Map systemProperties ) -+ private static void showProperties( XMLWriter xmlWriter, Map systemProperties ) throws IOException - { - xmlWriter.startElement( "properties" ); - for ( final Entry entry : systemProperties.entrySet() ) ---- a/pom.xml -+++ b/pom.xml -@@ -91,7 +91,7 @@ - 3.5 - 3.5 - 2.5 -- 0.9 -+ 3.3.3 - 2.0.0-beta.5 - scm:git:https://gitbox.apache.org/repos/asf/maven-surefire.git - surefire-archives/surefire-LATEST diff --git a/LICENSE-2.0.txt b/LICENSE-2.0.txt new file mode 100644 index 0000000..81fbaf6 --- /dev/null +++ b/LICENSE-2.0.txt @@ -0,0 +1,202 @@ + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. diff --git a/_service b/_service new file mode 100644 index 0000000..5be7cbe --- /dev/null +++ b/_service @@ -0,0 +1,17 @@ + + + git + https://github.com/apache/maven-surefire.git + surefire-3.2.5 + surefire-* + @PARENT_TAG@ + surefire-(.*) + **/*.jar + **/*.class + + + *.tar + xz + + + diff --git a/cpl-v10.html b/cpl-v10.html index e6ddbb7..25310dd 100644 --- a/cpl-v10.html +++ b/cpl-v10.html @@ -2,13 +2,19 @@ Common Public License - v 1.0 - +

Common Public License - v 1.0 + +

Updated 16 Apr 2009 + +

As of 25 Feb 2009, IBM has assigned the Agreement Steward role for the CPL to the Eclipse Foundation. +Eclipse has designated the Eclipse Public License (EPL) as the follow-on version of the CPL. +

THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS COMMON PUBLIC LICENSE ("AGREEMENT"). ANY USE, REPRODUCTION OR DISTRIBUTION OF THE PROGRAM CONSTITUTES RECIPIENT'S ACCEPTANCE OF THIS AGREEMENT.

diff --git a/generate-tarball.sh b/generate-tarball.sh deleted file mode 100644 index 40efd8d..0000000 --- a/generate-tarball.sh +++ /dev/null @@ -1,21 +0,0 @@ -#!/bin/bash -set -e - -name=maven-surefire -version="$(sed -n 's/Version:\s*//p' ${name}.spec)" - -# RETRIEVE -wget "https://archive.apache.org/dist/maven/surefire/surefire-${version}-source-release.zip" -O "${name}-${version}.orig.zip" - -rm -rf tarball-tmp -mkdir tarball-tmp -cd tarball-tmp -unzip "../${name}-${version}.orig.zip" - -# CLEAN TARBALL -find -name '*.jar' -delete -find -name '*.class' -delete - -tar czf "../${name}-${version}.tar.gz" * -cd .. -rm -r tarball-tmp "${name}-${version}.orig.zip" diff --git a/maven-surefire-2.22.0.tar.gz b/maven-surefire-2.22.0.tar.gz deleted file mode 100644 index ab23d98..0000000 --- a/maven-surefire-2.22.0.tar.gz +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:5b64c028912a6a5825fa75ed138ba24e83986eb1623ec81d58ca9739ecd1ea32 -size 1099470 diff --git a/maven-surefire-3.2.5.tar.xz b/maven-surefire-3.2.5.tar.xz new file mode 100644 index 0000000..5a427d4 --- /dev/null +++ b/maven-surefire-3.2.5.tar.xz @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:e6d25c539061ce3a441a1654a98ae262a05ed324e2eb904d64d17693d2ef9df6 +size 906352 diff --git a/maven-surefire-bootstrap-resources.patch b/maven-surefire-bootstrap-resources.patch index 1ae1878..6b64582 100644 --- a/maven-surefire-bootstrap-resources.patch +++ b/maven-surefire-bootstrap-resources.patch @@ -1,7 +1,10 @@ ---- surefire-2.22.0/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 -+++ surefire-2.22.0/maven-failsafe-plugin/src/main/filtered-resources/META-INF/maven/org.apache.maven.plugins/maven-failsafe-plugin/plugin-help.xml 2019-04-01 16:35:39.493479592 +0200 -@@ -0,0 +1,816 @@ +--- /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,1038 @@ + ++ ++ ++ + + ${project.name} + ${project.description} @@ -20,7 +23,7 @@ + false + false + true -+ org.apache.maven.plugin.failsafe.HelpMojo ++ org.apache.maven.plugins.maven_failsafe_plugin.HelpMojo + java + per-lookup + once-per-session @@ -31,32 +34,28 @@ + boolean + false + true -+ Display help information on maven-failsafe-plugin. -+Call mvn failsafe:help -Ddetail=true -Dgoal=<goal-name> to display parameter details. ++ If true, display all settable properties for each goal. + + + goal + java.lang.String + false + true -+ Display help information on maven-failsafe-plugin. -+Call mvn failsafe:help -Ddetail=true -Dgoal=<goal-name> to display parameter details. ++ The name of the goal for which to show help. If unspecified, all goals will be displayed. + + + indentSize + int + false + true -+ Display help information on maven-failsafe-plugin. -+Call mvn failsafe:help -Ddetail=true -Dgoal=<goal-name> to display parameter details. ++ The number of spaces per indentation level, should be positive. + + + lineLength + int + false + true -+ Display help information on maven-failsafe-plugin. -+Call mvn failsafe:help -Ddetail=true -Dgoal=<goal-name> to display parameter details. ++ The maximum length of a display line, should be positive. + + + @@ -84,12 +83,27 @@ + true + + ++ 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 -+ Abstract base class for running tests using Surefire. ++ 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 @@ -97,14 +111,11 @@ + 2.1 + false + true -+ Abstract base class for running tests using Surefire. -+ -+ -+ basedir -+ java.io.File -+ false -+ true -+ Abstract base class for running tests using Surefire. ++ Arbitrary JVM options to set on the command line. ++ ++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> + + + childDelegation @@ -112,14 +123,15 @@ + 2.1 + false + true -+ Abstract base class for running tests using Surefire. ++ 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 + java.io.File + false + true -+ Run integration tests using Surefire. ++ The path representing project JAR file, if exists; Otherwise the directory containing generated classes of the project being tested. This will be included after the test classes in the test classpath. Defaults to built artifact JAR file or ${project.build.outputDirectory}. + + + classpathDependencyExcludes @@ -127,7 +139,10 @@ + 2.6 + false + true -+ Abstract base class for running tests using Surefire. ++ 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 @@ -135,7 +150,20 @@ + 2.6 + false + true -+ Abstract base class for running tests using Surefire. ++ 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 ++ org.apache.maven.plugin.surefire.extensions.SurefireConsoleOutputReporter ++ false ++ true ++ + + + debugForkedProcess @@ -143,7 +171,7 @@ + 2.4 + false + true -+ Run integration tests using Surefire. ++ Attach a debugger to the forked JVM. If set to "true", the process will suspend and wait for a debugger to attach on port 5005. If set to some other string, that string will be appended to the argLine, allowing you to configure arbitrary debugging ability options (without overwriting the other options specified through the argLine parameter). + + + dependenciesToScan @@ -151,15 +179,32 @@ + 2.15 + false + true -+ Abstract base class for running tests using Surefire. ++ 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 ++ No reason given + false + true -+ Abstract base class for running tests using Surefire. ++ 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 @@ -167,7 +212,24 @@ + 2.3.1 + false + true -+ Abstract base class for running tests using Surefire. ++ By default, Surefire enables JVM assertions for the execution of your test cases. To disable the assertions, set this flag to "false". ++ ++ ++ enableProcessChecker ++ java.lang.String ++ 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. ++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: ++mvn test -Dfailsafe.enableProcessChecker=all + + + encoding @@ -175,15 +237,26 @@ + 3.0.0-M1 + false + true -+ Run integration tests using Surefire. ++ The character encoding scheme to be applied while generating test report files (see target/surefire-reports/yourTestName.txt). The report output files (*-out.txt) are still encoded with JVM's encoding used in standard out/err pipes. + + + environmentVariables -+ java.util.Map ++ java.util.Map<java.lang.String, java.lang.String> + 2.1.3 + false + true -+ Abstract base class for running tests using Surefire. ++ Additional environment variables to set on the command line. ++ ++ ++ excludedEnvironmentVariables ++ java.lang.String[] ++ 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: ++mvn test -Dfailsafe.excludedEnvironmentVariables=ACME1,ACME2,ACME3 + + + excludedGroups @@ -191,37 +264,64 @@ + 2.2 + false + true -+ Abstract base class for running tests using Surefire. ++ (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. ++ ++ ++ excludeJUnit5Engines ++ java.lang.String[] ++ 3.0.0-M6 ++ false ++ true ++ Provide the ID/s of an JUnit engine to be excluded in the test run. + + + excludes -+ java.util.List ++ java.util.List<java.lang.String> + false + true -+ Abstract base class for running tests using Surefire. ++ 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> ++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. + + + excludesFile + java.io.File ++ 2.13 + false + true -+ Run integration tests using Surefire. ++ 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 + + + failIfNoSpecifiedTests -+ java.lang.Boolean -+ 2.12 ++ boolean ++ 3.0.0-M8 + false + true -+ Run integration tests using Surefire. ++ Set this to "false" to prevent a failure if none of the tests specified in -Dit.test=... are run. Defaults to "true". Replacing "it.failIfNoSpecifiedTests" to be consistent with surefire plugin. ++ ++ ++ failIfNoSpecifiedTestsDeprecated ++ boolean ++ 2.12 ++ Since 3.0.0-M8, use "failsafe.failIfNoSpecifiedTests" instead. ++ false ++ true ++ Set this to "false" to prevent a failure if none of the tests specified in -Dit.test=... are run. Defaults to "true". + + + failIfNoTests -+ java.lang.Boolean ++ boolean + 2.4 + false + true -+ Abstract base class for running tests using Surefire. ++ Set this to "true" to cause a failure if there are no tests to run. Defaults to "false". + + + forkCount @@ -229,7 +329,11 @@ + 2.14 + false + true -+ Abstract base class for running tests using Surefire. ++ 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. + + + forkedProcessExitTimeoutInSeconds @@ -237,7 +341,7 @@ + 2.20 + false + true -+ Run integration tests using Surefire. ++ Forked process is normally terminated without any significant delay after given tests have completed. If the particular tests started non-daemon Thread(s), the process hangs instead of been properly terminated by System.exit(). Use this parameter in order to determine the timeout of terminating the process. see the documentation: http://maven.apache.org/surefire/maven-failsafe-plugin/examples/shutdown.html <http://maven.apache.org/surefire/maven-failsafe-plugin/examples/shutdown.html> + + + forkedProcessTimeoutInSeconds @@ -245,15 +349,17 @@ + 2.4 + false + true -+ Run integration tests using Surefire. ++ Kill the forked test process after a certain number of seconds. If set to 0, wait forever for the process, never timing out. + + -+ forkMode -+ java.lang.String -+ 2.1 ++ forkNode ++ org.apache.maven.surefire.extensions.ForkNodeFactory ++ 3.0.0-M5 + false + true -+ Abstract base class for running tests using Surefire. ++ 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> + + + groups @@ -261,21 +367,51 @@ + 2.2 + false + true -+ Abstract base class for running tests using Surefire. ++ (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 ++ java.lang.String[] ++ 3.0.0-M6 ++ false ++ true ++ Provide the ID/s of an JUnit engine to be included in the test run. + + + includes -+ java.util.List ++ java.util.List<java.lang.String> + false + true -+ Run integration tests using Surefire. ++ 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> ++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. + + + includesFile + java.io.File ++ 2.13 + false + true -+ Run integration tests using Surefire. ++ 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 @@ -283,15 +419,7 @@ + 2.3.1 + false + true -+ Abstract base class for running tests using Surefire. -+ -+ -+ junitPlatformArtifactName -+ java.lang.String -+ 2.22.0 -+ false -+ true -+ Abstract base class for running tests using Surefire. ++ Allows you to specify the name of the JUnit artifact. If not set, junit:junit will be used. + + + jvm @@ -299,7 +427,7 @@ + 2.1 + false + true -+ Abstract base class for running tests using Surefire. ++ 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 @@ -307,7 +435,7 @@ + 2.5 + false + true -+ Abstract base class for running tests using Surefire. ++ (TestNG only) Define the factory class used to create all test instances. + + + parallel @@ -315,7 +443,14 @@ + 2.2 + false + true -+ Abstract base class for running tests using Surefire. ++ (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 @@ -323,7 +458,8 @@ + 2.17 + false + true -+ Abstract base class for running tests using Surefire. ++ (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 @@ -331,7 +467,10 @@ + 2.16 + false + true -+ Run integration tests using Surefire. ++ 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". + + + parallelTestsTimeoutInSeconds @@ -339,7 +478,10 @@ + 2.16 + false + true -+ Run integration tests using Surefire. ++ 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". + + + perCoreThreadCount @@ -347,14 +489,14 @@ + 2.5 + false + true -+ Abstract base class for running tests using Surefire. ++ (JUnit 4.7 provider) Indicates that threadCount, threadCountSuites, threadCountClasses, threadCountMethods are per cpu core. + + + printSummary + boolean + false + true -+ Run integration tests using Surefire. ++ Option to print summary of test suites or just print the test cases that have errors. + + + properties @@ -362,7 +504,7 @@ + 2.4 + false + true -+ Abstract base class for running tests using Surefire. ++ List of properties for configuring all TestNG related configurations. This is the new preferred method of configuring TestNG. + + + redirectTestOutputToFile @@ -370,43 +512,35 @@ + 2.3 + false + true -+ Abstract base class for running tests using Surefire. -+ -+ -+ remoteRepositories -+ java.util.List -+ 2.2 -+ false -+ true -+ Abstract base class for running tests using Surefire. ++ Set this to "true" to redirect the unit test standard output to a file (found in reportsDirectory/testName-output.txt). + + + reportFormat + java.lang.String + false + true -+ Run integration tests using Surefire. ++ Selects the formatting for the test report to be generated. Can be set as "brief" or "plain". Only applies to the output format of the output files (target/surefire-reports/testName.txt) + + + reportNameSuffix + java.lang.String + false + true -+ Abstract base class for running tests using Surefire. ++ 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 + java.io.File + false + true -+ Run integration tests using Surefire. ++ Base directory where all reports are written to. + + + rerunFailingTestsCount + int + false + true -+ Run integration tests using Surefire. ++ (JUnit 4+ providers and JUnit 5+ providers since 3.0.0-M4) The number of times each failing test will be rerun. If set larger than 0, rerun failing tests immediately after they fail. If a failing test passes in any of those reruns, it will be marked as pass and reported as a "flake". However, all the failing attempts will be recorded. + + + reuseForks @@ -414,7 +548,7 @@ + 2.13 + false + true -+ Abstract base class for running tests using Surefire. ++ 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 @@ -422,7 +556,27 @@ + 2.7 + false + true -+ Run integration tests using Surefire. ++ 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. ++ ++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. ++ ++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. ++ ++ ++ runOrderRandomSeed ++ java.lang.Long ++ 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. ++ ++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. + + + shutdown @@ -430,14 +584,19 @@ + 2.19 + false + true -+ Run integration tests using Surefire. ++ 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. + + + skip + boolean + false + true -+ Abstract base class for running tests using Surefire. ++ 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 @@ -445,7 +604,10 @@ + 2.19 + false + true -+ Run integration tests using Surefire. ++ Set to error/failure count in order to skip remaining tests. Due to race conditions in parallel/forked execution this may not be fully guaranteed. ++Enable with system property -Dfailsafe.skipAfterFailureCount=1 or any number greater than zero. Defaults to "0". ++See the prerequisites and limitations in documentation: ++http://maven.apache.org/plugins/maven-failsafe-plugin/examples/skip-after-failure.html <http://maven.apache.org/plugins/maven-failsafe-plugin/examples/skip-after-failure.html> + + + skipExec @@ -454,7 +616,7 @@ + Use skipTests instead. + false + true -+ Abstract base class for running tests using Surefire. ++ This old parameter is just like skipTests, but bound to the old property "maven.test.skip.exec". + + + skipITs @@ -462,7 +624,7 @@ + 2.4.3-alpha-2 + false + true -+ Run integration tests using Surefire. ++ Set this to "true" to skip running integration tests, but still compile them. Its use is NOT RECOMMENDED, but quite convenient on occasion. + + + skipTests @@ -470,7 +632,22 @@ + 2.4 + false + true -+ Abstract base class for running tests using Surefire. ++ 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 ++ org.apache.maven.plugin.surefire.extensions.SurefireStatelessTestsetInfoReporter ++ false ++ true ++ ++ ++ ++ statelessTestsetReporter ++ org.apache.maven.plugin.surefire.extensions.SurefireStatelessReporter ++ false ++ true ++ Note: use the legacy system property disableXmlReport set to true to disable the report. + + + suiteXmlFiles @@ -478,14 +655,15 @@ + 2.2 + false + true -+ Run integration tests using Surefire. ++ (TestNG) List of <suiteXmlFile> elements specifying TestNG suite xml file locations. Note that suiteXmlFiles is incompatible with several other parameters of this plugin, like includes and excludes. ++This parameter is ignored if the test parameter is specified (allowing you to run a single test instead of an entire suite). + + + summaryFile + java.io.File + true + true -+ Run integration tests using Surefire. ++ The summary file to write integration test results to. + + + systemProperties @@ -493,23 +671,22 @@ + Use systemPropertyVariables instead. + false + true -+ Abstract base class for running tests using Surefire. ++ List of System properties to pass to a provider. + + + systemPropertiesFile + java.io.File -+ 2.8.2 + false + true -+ Abstract base class for running tests using Surefire. ++ + + + systemPropertyVariables -+ java.util.Map ++ java.util.Map<java.lang.String, java.lang.String> + 2.5 + false + true -+ Abstract base class for running tests using Surefire. ++ List of System properties to pass to a provider. + + + tempDir @@ -517,21 +694,28 @@ + 2.20 + false + true -+ Abstract base class for running tests using Surefire. ++ 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 -+ Run integration tests using Surefire. ++ 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:*]. + + + testClassesDirectory + java.io.File + false + true -+ Abstract base class for running tests using Surefire. ++ The directory containing generated test classes of the project being tested. This will be included at the beginning of the test classpath. + + + testNGArtifactName @@ -539,15 +723,15 @@ + 2.3.1 + false + true -+ Abstract base class for running tests using Surefire. ++ 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 -+ true ++ false + true -+ Abstract base class for running tests using Surefire. ++ The test source directory containing test class sources. Important only for TestNG HTML reports. + + + threadCount @@ -555,7 +739,7 @@ + 2.2 + false + true -+ Abstract base class for running tests using Surefire. ++ (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 @@ -563,7 +747,11 @@ + 2.16 + false + true -+ Abstract base class for running tests using Surefire. ++ (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 @@ -571,7 +759,11 @@ + 2.16 + false + true -+ Abstract base class for running tests using Surefire. ++ (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 @@ -579,7 +771,10 @@ + 2.16 + false + true -+ Abstract base class for running tests using Surefire. ++ (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 @@ -587,14 +782,14 @@ + 2.2 + false + true -+ Abstract base class for running tests using Surefire. ++ Whether to trim the stack trace in the reports to just the lines within the test, or show the full trace. + + + useFile + boolean + false + true -+ Run integration tests using Surefire. ++ Option to generate a file test report or just output the test report to the console. + + + useManifestOnlyJar @@ -602,7 +797,17 @@ + 2.4.3 + false + true -+ Run integration tests using Surefire. ++ 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. ++ ++ ++ useModulePath ++ boolean ++ 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. ++Defaults to true. + + + useSystemClassLoader @@ -610,7 +815,7 @@ + 2.3 + false + true -+ Run integration tests using Surefire. ++ Option to pass dependencies to the system's classloader instead of using an isolated class loader when forking. Prevents problems with JDKs which implement the service provider lookup mechanism by using the system's classloader. + + + useUnlimitedThreads @@ -618,7 +823,7 @@ + 2.5 + false + true -+ Abstract base class for running tests using Surefire. ++ (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 @@ -626,32 +831,38 @@ + 2.1.3 + false + true -+ Abstract base class for running tests using Surefire. ++ Command line working directory. + + + ++ ${maven.test.additionalClasspathDependencies} + ${maven.test.additionalClasspath} + ${argLine} -+ + ${childDelegation} + ${maven.test.dependency.excludes} + ${maven.failsafe.debug} + ${dependenciesToScan} + ${disableXmlReport} + ${enableAssertions} ++ ${failsafe.enableProcessChecker} + ${encoding} ++ ${failsafe.excludedEnvironmentVariables} + ${excludedGroups} ++ ${failsafe.excludeJUnit5Engines} ++ ${failsafe.excludes} + ${failsafe.excludesFile} -+ ${it.failIfNoSpecifiedTests} -+ ${failIfNoTests} ++ ${failsafe.failIfNoSpecifiedTests} ++ ${it.failIfNoSpecifiedTests} ++ ${failIfNoTests} + ${forkCount} + ${failsafe.exitTimeout} + ${failsafe.timeout} -+ ${forkMode} ++ ${failsafe.forkNode} + ${groups} ++ ${failsafe.includeJUnit5Engines} ++ ${failsafe.includes} + ${failsafe.includesFile} + ${junitArtifactName} -+ ${junitPlatformArtifactName} + ${jvm} + ${objectFactory} + ${parallel} @@ -661,14 +872,14 @@ + ${perCoreThreadCount} + ${failsafe.printSummary} + ${maven.test.redirectTestOutputToFile} -+ + ${failsafe.reportFormat} + ${surefire.reportNameSuffix} + + ${failsafe.rerunFailingTestsCount} + ${reuseForks} + ${failsafe.runOrder} -+ ${failsafe.shutdown} ++ ${failsafe.runOrder.random.seed} ++ ${failsafe.shutdown} + ${maven.test.skip} + ${failsafe.skipAfterFailureCount} + ${maven.test.skip.exec} @@ -676,6 +887,7 @@ + ${skipTests} + ${failsafe.suiteXmlFiles} + ++ ${failsafe.systemPropertiesFile} + ${tempDir} + ${it.test} + @@ -685,9 +897,10 @@ + ${threadCountClasses} + ${threadCountMethods} + ${threadCountSuites} -+ ${trimStackTrace} ++ ${trimStackTrace} + ${failsafe.useFile} + ${failsafe.useManifestOnlyJar} ++ ${failsafe.useModulePath} + ${failsafe.useSystemClassLoader} + ${useUnlimitedThreads} + ${basedir} @@ -714,7 +927,7 @@ + java.io.File + false + true -+ Verify integration tests ran using Surefire. ++ The base directory of the project being tested. This can be obtained in your unit test by System.getProperty("basedir"). + + + encoding @@ -722,29 +935,37 @@ + since of 2.20.1 + false + true -+ Verify integration tests ran using Surefire. ++ The character encoding scheme to be applied. Deprecated since 2.20.1 and used encoding UTF-8 in failsafe-summary.xml. + + + failIfNoTests -+ java.lang.Boolean ++ boolean + 2.4 + false + true -+ Verify integration tests ran using Surefire. ++ Set this to "true" to cause a failure if there are no tests to run. Defaults to "false". ++ ++ ++ failOnFlakeCount ++ int ++ 3.0.0-M6 ++ false ++ true ++ Set this to a value greater than 0 to fail the whole test set if the cumulative number of flakes reaches this threshold. Set to 0 to allow an unlimited number of flakes. + + + reportsDirectory + java.io.File + false + true -+ Verify integration tests ran using Surefire. ++ Base directory where all reports are written to. + + + skip + boolean + false + true -+ Verify integration tests ran using Surefire. ++ 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. + + + skipExec @@ -753,7 +974,7 @@ + Use -DskipTests instead. + false + true -+ Verify integration tests ran using Surefire. ++ This old parameter is just like skipTests, but bound to the old property maven.test.skip.exec. + + + skipITs @@ -761,7 +982,7 @@ + 2.4.3-alpha-2 + false + true -+ Verify integration tests ran using Surefire. ++ Set this to 'true' to skip running integration tests, but still compile them. Its use is NOT RECOMMENDED, but quite convenient on occasion. + + + skipTests @@ -769,14 +990,14 @@ + 2.4 + false + true -+ Verify integration tests ran using Surefire. ++ Set this to 'true' to skip running tests, but still compile them. Its use is NOT RECOMMENDED, but quite convenient on occasion. + + + summaryFile + java.io.File + true + true -+ Verify integration tests ran using Surefire. ++ The summary file to read integration test results from. + + + summaryFiles @@ -784,27 +1005,28 @@ + 2.6 + false + true -+ Verify integration tests ran using Surefire. ++ Additional summary files to read integration test results from. + + + testClassesDirectory + java.io.File + false + true -+ Verify integration tests ran using Surefire. ++ The directory containing generated test classes of the project being tested. This will be included at the beginning the test classpath. + + + testFailureIgnore + boolean + false + true -+ Verify integration tests ran using Surefire. ++ Set this to true to ignore a failure during testing. Its use is NOT RECOMMENDED, but quite convenient on occasion. + + + + + ${encoding} -+ ${failIfNoTests} ++ ${failIfNoTests} ++ ${failsafe.failOnFlakeCount} + + ${maven.test.skip} + ${maven.test.skip.exec} @@ -817,10 +1039,14 @@ + + + ---- surefire-2.22.0/maven-failsafe-plugin/src/main/filtered-resources/META-INF/maven/plugin.xml 1970-01-01 01:00:00.000000000 +0100 -+++ surefire-2.22.0/maven-failsafe-plugin/src/main/filtered-resources/META-INF/maven/plugin.xml 2019-04-01 16:35:39.493479592 +0200 -@@ -0,0 +1,1212 @@ +\ No newline at end of file +--- /dev/null ++++ b/maven-failsafe-plugin/src/main/filtered-resources/META-INF/maven/plugin.xml +@@ -0,0 +1,1262 @@ + ++ ++ ++ + + ${project.name} + ${project.description} @@ -830,18 +1056,20 @@ + failsafe + false + true ++ 1.8 ++ 3.2.5 + + + help -+ Display help information on maven-failsafe-plugin.<br> -+Call <code>mvn failsafe:help -Ddetail=true -Dgoal=&lt;goal-name&gt;</code> to display parameter details. ++ Display help information on maven-failsafe-plugin. ++Call mvn failsafe:help -Ddetail=true -Dgoal=<goal-name> to display parameter details. + false + false + false + false + false + true -+ org.apache.maven.plugin.failsafe.HelpMojo ++ org.apache.maven.plugins.maven_failsafe_plugin.HelpMojo + java + per-lookup + once-per-session @@ -852,32 +1080,28 @@ + boolean + false + true -+ Display help information on maven-failsafe-plugin.<br> -+Call <code>mvn failsafe:help -Ddetail=true -Dgoal=&lt;goal-name&gt;</code> to display parameter details. ++ If true, display all settable properties for each goal. + + + goal + java.lang.String + false + true -+ Display help information on maven-failsafe-plugin.<br> -+Call <code>mvn failsafe:help -Ddetail=true -Dgoal=&lt;goal-name&gt;</code> to display parameter details. ++ The name of the goal for which to show help. If unspecified, all goals will be displayed. + + + indentSize + int + false + true -+ Display help information on maven-failsafe-plugin.<br> -+Call <code>mvn failsafe:help -Ddetail=true -Dgoal=&lt;goal-name&gt;</code> to display parameter details. ++ The number of spaces per indentation level, should be positive. + + + lineLength + int + false + true -+ Display help information on maven-failsafe-plugin.<br> -+Call <code>mvn failsafe:help -Ddetail=true -Dgoal=&lt;goal-name&gt;</code> to display parameter details. ++ The maximum length of a display line, should be positive. + + + @@ -905,12 +1129,27 @@ + true + + ++ 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 -+ Abstract base class for running tests using Surefire. ++ 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 @@ -918,14 +1157,18 @@ + 2.1 + false + true -+ Abstract base class for running tests using Surefire. ++ Arbitrary JVM options to set on the command line. ++ ++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> + + + basedir + java.io.File -+ false -+ true -+ Abstract base class for running tests using Surefire. ++ true ++ false ++ The base directory of the project being tested. This can be obtained in your integration test via System.getProperty("basedir"). + + + childDelegation @@ -933,14 +1176,15 @@ + 2.1 + false + true -+ Abstract base class for running tests using Surefire. ++ 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 + java.io.File + false + true -+ Run integration tests using Surefire. ++ The path representing project JAR file, if exists; Otherwise the directory containing generated classes of the project being tested. This will be included after the test classes in the test classpath. Defaults to built artifact JAR file or ${project.build.outputDirectory}. + + + classpathDependencyExcludes @@ -948,7 +1192,10 @@ + 2.6 + false + true -+ Abstract base class for running tests using Surefire. ++ 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 @@ -956,7 +1203,20 @@ + 2.6 + false + true -+ Abstract base class for running tests using Surefire. ++ 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 ++ org.apache.maven.plugin.surefire.extensions.SurefireConsoleOutputReporter ++ false ++ true ++ + + + debugForkedProcess @@ -964,14 +1224,14 @@ + 2.4 + false + true -+ Run integration tests using Surefire. ++ Attach a debugger to the forked JVM. If set to "true", the process will suspend and wait for a debugger to attach on port 5005. If set to some other string, that string will be appended to the argLine, allowing you to configure arbitrary debugging ability options (without overwriting the other options specified through the argLine parameter). + + + defaultClassesDirectory + java.io.File -+ false ++ true + false -+ Run integration tests using Surefire. ++ + + + dependenciesToScan @@ -979,15 +1239,32 @@ + 2.15 + false + true -+ Abstract base class for running tests using Surefire. ++ 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 ++ No reason given + false + true -+ Abstract base class for running tests using Surefire. ++ 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 @@ -995,7 +1272,24 @@ + 2.3.1 + false + true -+ Abstract base class for running tests using Surefire. ++ By default, Surefire enables JVM assertions for the execution of your test cases. To disable the assertions, set this flag to "false". ++ ++ ++ enableProcessChecker ++ java.lang.String ++ 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. ++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: ++mvn test -Dfailsafe.enableProcessChecker=all + + + encoding @@ -1003,7 +1297,7 @@ + 3.0.0-M1 + false + true -+ Run integration tests using Surefire. ++ The character encoding scheme to be applied while generating test report files (see target/surefire-reports/yourTestName.txt). The report output files (*-out.txt) are still encoded with JVM's encoding used in standard out/err pipes. + + + environmentVariables @@ -1011,7 +1305,26 @@ + 2.1.3 + false + true -+ Abstract base class for running tests using Surefire. ++ Additional environment variables to set on the command line. ++ ++ ++ excludeJUnit5Engines ++ java.lang.String[] ++ 3.0.0-M6 ++ false ++ true ++ Provide the ID/s of an JUnit engine to be excluded in the test run. ++ ++ ++ excludedEnvironmentVariables ++ java.lang.String[] ++ 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: ++mvn test -Dfailsafe.excludedEnvironmentVariables=ACME1,ACME2,ACME3 + + + excludedGroups @@ -1019,37 +1332,56 @@ + 2.2 + false + true -+ Abstract base class for running tests using Surefire. ++ (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 -+ Abstract base class for running tests using Surefire. ++ 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> ++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. + + + excludesFile + java.io.File ++ 2.13 + false + true -+ Run integration tests using Surefire. ++ 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 + + + failIfNoSpecifiedTests -+ java.lang.Boolean -+ 2.12 ++ boolean ++ 3.0.0-M8 + false + true -+ Run integration tests using Surefire. ++ Set this to "false" to prevent a failure if none of the tests specified in -Dit.test=... are run. Defaults to "true". Replacing "it.failIfNoSpecifiedTests" to be consistent with surefire plugin. ++ ++ ++ failIfNoSpecifiedTestsDeprecated ++ boolean ++ 2.12 ++ Since 3.0.0-M8, use "failsafe.failIfNoSpecifiedTests" instead. ++ false ++ true ++ Set this to "false" to prevent a failure if none of the tests specified in -Dit.test=... are run. Defaults to "true". + + + failIfNoTests -+ java.lang.Boolean ++ boolean + 2.4 + false + true -+ Abstract base class for running tests using Surefire. ++ Set this to "true" to cause a failure if there are no tests to run. Defaults to "false". + + + forkCount @@ -1057,15 +1389,21 @@ + 2.14 + false + true -+ Abstract base class for running tests using Surefire. ++ 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. + + -+ forkMode -+ java.lang.String -+ 2.1 ++ forkNode ++ org.apache.maven.surefire.extensions.ForkNodeFactory ++ 3.0.0-M5 + false + true -+ Abstract base class for running tests using Surefire. ++ 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> + + + forkedProcessExitTimeoutInSeconds @@ -1073,7 +1411,7 @@ + 2.20 + false + true -+ Run integration tests using Surefire. ++ Forked process is normally terminated without any significant delay after given tests have completed. If the particular tests started non-daemon Thread(s), the process hangs instead of been properly terminated by System.exit(). Use this parameter in order to determine the timeout of terminating the process. see the documentation: http://maven.apache.org/surefire/maven-failsafe-plugin/examples/shutdown.html <http://maven.apache.org/surefire/maven-failsafe-plugin/examples/shutdown.html> + + + forkedProcessTimeoutInSeconds @@ -1081,7 +1419,7 @@ + 2.4 + false + true -+ Run integration tests using Surefire. ++ Kill the forked test process after a certain number of seconds. If set to 0, wait forever for the process, never timing out. + + + groups @@ -1089,21 +1427,51 @@ + 2.2 + false + true -+ Abstract base class for running tests using Surefire. ++ (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 ++ java.lang.String[] ++ 3.0.0-M6 ++ false ++ true ++ Provide the ID/s of an JUnit engine to be included in the test run. + + + includes + java.util.List + false + true -+ Run integration tests using Surefire. ++ 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> ++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. + + + includesFile + java.io.File ++ 2.13 + false + true -+ Run integration tests using Surefire. ++ 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 @@ -1111,15 +1479,7 @@ + 2.3.1 + false + true -+ Abstract base class for running tests using Surefire. -+ -+ -+ junitPlatformArtifactName -+ java.lang.String -+ 2.22.0 -+ false -+ true -+ Abstract base class for running tests using Surefire. ++ Allows you to specify the name of the JUnit artifact. If not set, junit:junit will be used. + + + jvm @@ -1127,14 +1487,7 @@ + 2.1 + false + true -+ Abstract base class for running tests using Surefire. -+ -+ -+ localRepository -+ org.apache.maven.artifact.repository.ArtifactRepository -+ true -+ false -+ Abstract base class for running tests using Surefire. ++ 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 @@ -1142,7 +1495,7 @@ + 2.5 + false + true -+ Abstract base class for running tests using Surefire. ++ (TestNG only) Define the factory class used to create all test instances. + + + parallel @@ -1150,14 +1503,21 @@ + 2.2 + false + true -+ Abstract base class for running tests using Surefire. ++ (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 -+ Abstract base class for running tests using Surefire. ++ Parallel Maven Execution. + + + parallelOptimized @@ -1165,7 +1525,8 @@ + 2.17 + false + true -+ Abstract base class for running tests using Surefire. ++ (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 @@ -1173,7 +1534,10 @@ + 2.16 + false + true -+ Run integration tests using Surefire. ++ 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". + + + parallelTestsTimeoutInSeconds @@ -1181,7 +1545,10 @@ + 2.16 + false + true -+ Run integration tests using Surefire. ++ 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". + + + perCoreThreadCount @@ -1189,44 +1556,51 @@ + 2.5 + false + true -+ Abstract base class for running tests using Surefire. ++ (JUnit 4.7 provider) Indicates that threadCount, threadCountSuites, threadCountClasses, threadCountMethods are per cpu core. + + + pluginArtifactMap + java.util.Map + true + false -+ Abstract base class for running tests using Surefire. ++ Map of plugin artifacts. + + + pluginDescriptor + org.apache.maven.plugin.descriptor.PluginDescriptor + 2.12 -+ false ++ true + false -+ Abstract base class for running tests using Surefire. ++ Information about this plugin, mainly used to lookup this plugin's configuration from the currently executing project. + + + printSummary + boolean + false + true -+ Run integration tests using Surefire. ++ Option to print summary of test suites or just print the test cases that have errors. ++ ++ ++ project ++ org.apache.maven.project.MavenProject ++ true ++ false ++ The Maven Project Object. + + + projectArtifactMap + java.util.Map + true + false -+ Abstract base class for running tests using Surefire. ++ Map of project artifacts. + + + projectBuildDirectory + java.io.File + 2.20 -+ false ++ true + false -+ Abstract base class for running tests using Surefire. ++ Read-only parameter with value of Maven property project.build.directory. + + + properties @@ -1234,7 +1608,7 @@ + 2.4 + false + true -+ Abstract base class for running tests using Surefire. ++ List of properties for configuring all TestNG related configurations. This is the new preferred method of configuring TestNG. + + + redirectTestOutputToFile @@ -1242,43 +1616,35 @@ + 2.3 + false + true -+ Abstract base class for running tests using Surefire. -+ -+ -+ remoteRepositories -+ java.util.List -+ 2.2 -+ false -+ true -+ Abstract base class for running tests using Surefire. ++ Set this to "true" to redirect the unit test standard output to a file (found in reportsDirectory/testName-output.txt). + + + reportFormat + java.lang.String + false + true -+ Run integration tests using Surefire. ++ Selects the formatting for the test report to be generated. Can be set as "brief" or "plain". Only applies to the output format of the output files (target/surefire-reports/testName.txt) + + + reportNameSuffix + java.lang.String + false + true -+ Abstract base class for running tests using Surefire. ++ 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 + java.io.File + false + true -+ Run integration tests using Surefire. ++ Base directory where all reports are written to. + + + rerunFailingTestsCount + int + false + true -+ Run integration tests using Surefire. ++ (JUnit 4+ providers and JUnit 5+ providers since 3.0.0-M4) The number of times each failing test will be rerun. If set larger than 0, rerun failing tests immediately after they fail. If a failing test passes in any of those reruns, it will be marked as pass and reported as a "flake". However, all the failing attempts will be recorded. + + + reuseForks @@ -1286,7 +1652,7 @@ + 2.13 + false + true -+ Abstract base class for running tests using Surefire. ++ 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 @@ -1294,7 +1660,34 @@ + 2.7 + false + true -+ Run integration tests using Surefire. ++ 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. ++ ++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. ++ ++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. ++ ++ ++ runOrderRandomSeed ++ java.lang.Long ++ 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. ++ ++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. ++ ++ ++ session ++ org.apache.maven.execution.MavenSession ++ true ++ false ++ The current build session instance. + + + shutdown @@ -1302,14 +1695,19 @@ + 2.19 + false + true -+ Run integration tests using Surefire. ++ 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. + + + skip + boolean + false + true -+ Abstract base class for running tests using Surefire. ++ 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 @@ -1317,7 +1715,10 @@ + 2.19 + false + true -+ Run integration tests using Surefire. ++ Set to error/failure count in order to skip remaining tests. Due to race conditions in parallel/forked execution this may not be fully guaranteed. ++Enable with system property -Dfailsafe.skipAfterFailureCount=1 or any number greater than zero. Defaults to "0". ++See the prerequisites and limitations in documentation: ++http://maven.apache.org/plugins/maven-failsafe-plugin/examples/skip-after-failure.html <http://maven.apache.org/plugins/maven-failsafe-plugin/examples/skip-after-failure.html> + + + skipExec @@ -1326,7 +1727,7 @@ + Use skipTests instead. + false + true -+ Abstract base class for running tests using Surefire. ++ This old parameter is just like skipTests, but bound to the old property "maven.test.skip.exec". + + + skipITs @@ -1334,7 +1735,7 @@ + 2.4.3-alpha-2 + false + true -+ Run integration tests using Surefire. ++ Set this to "true" to skip running integration tests, but still compile them. Its use is NOT RECOMMENDED, but quite convenient on occasion. + + + skipTests @@ -1342,7 +1743,22 @@ + 2.4 + false + true -+ Abstract base class for running tests using Surefire. ++ 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 ++ org.apache.maven.plugin.surefire.extensions.SurefireStatelessTestsetInfoReporter ++ false ++ true ++ ++ ++ ++ statelessTestsetReporter ++ org.apache.maven.plugin.surefire.extensions.SurefireStatelessReporter ++ false ++ true ++ Note: use the legacy system property disableXmlReport set to true to disable the report. + + + suiteXmlFiles @@ -1350,14 +1766,15 @@ + 2.2 + false + true -+ Run integration tests using Surefire. ++ (TestNG) List of <suiteXmlFile> elements specifying TestNG suite xml file locations. Note that suiteXmlFiles is incompatible with several other parameters of this plugin, like includes and excludes. ++This parameter is ignored if the test parameter is specified (allowing you to run a single test instead of an entire suite). + + + summaryFile + java.io.File + true + true -+ Run integration tests using Surefire. ++ The summary file to write integration test results to. + + + systemProperties @@ -1365,15 +1782,14 @@ + Use systemPropertyVariables instead. + false + true -+ Abstract base class for running tests using Surefire. ++ List of System properties to pass to a provider. + + + systemPropertiesFile + java.io.File -+ 2.8.2 + false + true -+ Abstract base class for running tests using Surefire. ++ + + + systemPropertyVariables @@ -1381,7 +1797,7 @@ + 2.5 + false + true -+ Abstract base class for running tests using Surefire. ++ List of System properties to pass to a provider. + + + tempDir @@ -1389,21 +1805,28 @@ + 2.20 + false + true -+ Abstract base class for running tests using Surefire. ++ 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 -+ Run integration tests using Surefire. ++ 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:*]. + + + testClassesDirectory + java.io.File + false + true -+ Abstract base class for running tests using Surefire. ++ The directory containing generated test classes of the project being tested. This will be included at the beginning of the test classpath. + + + testNGArtifactName @@ -1411,15 +1834,15 @@ + 2.3.1 + false + true -+ Abstract base class for running tests using Surefire. ++ 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 -+ true ++ false + true -+ Abstract base class for running tests using Surefire. ++ The test source directory containing test class sources. Important only for TestNG HTML reports. + + + threadCount @@ -1427,7 +1850,7 @@ + 2.2 + false + true -+ Abstract base class for running tests using Surefire. ++ (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 @@ -1435,7 +1858,11 @@ + 2.16 + false + true -+ Abstract base class for running tests using Surefire. ++ (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 @@ -1443,7 +1870,11 @@ + 2.16 + false + true -+ Abstract base class for running tests using Surefire. ++ (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 @@ -1451,7 +1882,10 @@ + 2.16 + false + true -+ Abstract base class for running tests using Surefire. ++ (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 @@ -1459,14 +1893,14 @@ + 2.2 + false + true -+ Abstract base class for running tests using Surefire. ++ Whether to trim the stack trace in the reports to just the lines within the test, or show the full trace. + + + useFile + boolean + false + true -+ Run integration tests using Surefire. ++ Option to generate a file test report or just output the test report to the console. + + + useManifestOnlyJar @@ -1474,7 +1908,17 @@ + 2.4.3 + false + true -+ Run integration tests using Surefire. ++ 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. ++ ++ ++ useModulePath ++ boolean ++ 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. ++Defaults to true. + + + useSystemClassLoader @@ -1482,7 +1926,7 @@ + 2.3 + false + true -+ Run integration tests using Surefire. ++ Option to pass dependencies to the system's classloader instead of using an isolated class loader when forking. Prevents problems with JDKs which implement the service provider lookup mechanism by using the system's classloader. + + + useUnlimitedThreads @@ -1490,7 +1934,7 @@ + 2.5 + false + true -+ Abstract base class for running tests using Surefire. ++ (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 @@ -1498,24 +1942,11 @@ + 2.1.3 + false + true -+ Abstract base class for running tests using Surefire. -+ -+ -+ project -+ org.apache.maven.project.MavenProject -+ true -+ false -+ -+ -+ -+ session -+ org.apache.maven.execution.MavenSession -+ true -+ false -+ ++ Command line working directory. + + + ++ ${maven.test.additionalClasspathDependencies} + ${maven.test.additionalClasspath} + ${argLine} + @@ -1526,21 +1957,26 @@ + ${dependenciesToScan} + ${disableXmlReport} + ${enableAssertions} ++ ${failsafe.enableProcessChecker} + ${encoding} ++ ${failsafe.excludeJUnit5Engines} ++ ${failsafe.excludedEnvironmentVariables} + ${excludedGroups} ++ ${failsafe.excludes} + ${failsafe.excludesFile} -+ ${it.failIfNoSpecifiedTests} -+ ${failIfNoTests} ++ ${failsafe.failIfNoSpecifiedTests} ++ ${it.failIfNoSpecifiedTests} ++ ${failIfNoTests} + ${forkCount} -+ ${forkMode} ++ ${failsafe.forkNode} + ${failsafe.exitTimeout} + ${failsafe.timeout} + ${groups} ++ ${failsafe.includeJUnit5Engines} ++ ${failsafe.includes} + ${failsafe.includesFile} + ${junitArtifactName} -+ ${junitPlatformArtifactName} + ${jvm} -+ + ${objectFactory} + ${parallel} + @@ -1551,17 +1987,19 @@ + ${plugin.artifactMap} + + ${failsafe.printSummary} ++ + ${project.artifactMap} + + ${maven.test.redirectTestOutputToFile} -+ + ${failsafe.reportFormat} + ${surefire.reportNameSuffix} + + ${failsafe.rerunFailingTestsCount} + ${reuseForks} + ${failsafe.runOrder} -+ ${failsafe.shutdown} ++ ${failsafe.runOrder.random.seed} ++ ++ ${failsafe.shutdown} + ${maven.test.skip} + ${failsafe.skipAfterFailureCount} + ${maven.test.skip.exec} @@ -1569,6 +2007,7 @@ + ${skipTests} + ${failsafe.suiteXmlFiles} + ++ ${failsafe.systemPropertiesFile} + ${tempDir} + ${it.test} + @@ -1578,31 +2017,30 @@ + ${threadCountClasses} + ${threadCountMethods} + ${threadCountSuites} -+ ${trimStackTrace} ++ ${trimStackTrace} + ${failsafe.useFile} + ${failsafe.useManifestOnlyJar} ++ ${failsafe.useModulePath} + ${failsafe.useSystemClassLoader} + ${useUnlimitedThreads} + ${basedir} -+ -+ + + + -+ org.apache.maven.artifact.factory.ArtifactFactory -+ artifactFactory -+ -+ -+ org.apache.maven.artifact.resolver.ArtifactResolver -+ artifactResolver ++ org.codehaus.plexus.languages.java.jpms.LocationManager ++ locationManager + + + org.codehaus.plexus.logging.Logger + logger + + -+ org.apache.maven.artifact.metadata.ArtifactMetadataSource -+ metadataSource ++ org.apache.maven.surefire.providerapi.ProviderDetector ++ providerDetector ++ ++ ++ org.apache.maven.plugin.surefire.SurefireDependencyResolver ++ surefireDependencyResolver + + + org.apache.maven.toolchain.ToolchainManager @@ -1631,7 +2069,7 @@ + java.io.File + false + true -+ Verify integration tests ran using Surefire. ++ The base directory of the project being tested. This can be obtained in your unit test by System.getProperty("basedir"). + + + encoding @@ -1639,29 +2077,44 @@ + since of 2.20.1 + false + true -+ Verify integration tests ran using Surefire. ++ The character encoding scheme to be applied. Deprecated since 2.20.1 and used encoding UTF-8 in failsafe-summary.xml. + + + failIfNoTests -+ java.lang.Boolean ++ boolean + 2.4 + false + true -+ Verify integration tests ran using Surefire. ++ Set this to "true" to cause a failure if there are no tests to run. Defaults to "false". ++ ++ ++ failOnFlakeCount ++ int ++ 3.0.0-M6 ++ false ++ true ++ Set this to a value greater than 0 to fail the whole test set if the cumulative number of flakes reaches this threshold. Set to 0 to allow an unlimited number of flakes. + + + reportsDirectory + java.io.File + false + true -+ Verify integration tests ran using Surefire. ++ Base directory where all reports are written to. ++ ++ ++ session ++ org.apache.maven.execution.MavenSession ++ false ++ false ++ The current build session instance. + + + skip + boolean + false + true -+ Verify integration tests ran using Surefire. ++ 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. + + + skipExec @@ -1670,7 +2123,7 @@ + Use -DskipTests instead. + false + true -+ Verify integration tests ran using Surefire. ++ This old parameter is just like skipTests, but bound to the old property maven.test.skip.exec. + + + skipITs @@ -1678,7 +2131,7 @@ + 2.4.3-alpha-2 + false + true -+ Verify integration tests ran using Surefire. ++ Set this to 'true' to skip running integration tests, but still compile them. Its use is NOT RECOMMENDED, but quite convenient on occasion. + + + skipTests @@ -1686,14 +2139,14 @@ + 2.4 + false + true -+ Verify integration tests ran using Surefire. ++ Set this to 'true' to skip running tests, but still compile them. Its use is NOT RECOMMENDED, but quite convenient on occasion. + + + summaryFile + java.io.File + true + true -+ Verify integration tests ran using Surefire. ++ The summary file to read integration test results from. + + + summaryFiles @@ -1701,35 +2154,30 @@ + 2.6 + false + true -+ Verify integration tests ran using Surefire. ++ Additional summary files to read integration test results from. + + + testClassesDirectory + java.io.File + false + true -+ Verify integration tests ran using Surefire. ++ The directory containing generated test classes of the project being tested. This will be included at the beginning the test classpath. + + + testFailureIgnore + boolean + false + true -+ Verify integration tests ran using Surefire. -+ -+ -+ session -+ org.apache.maven.execution.MavenSession -+ true -+ false -+ ++ Set this to true to ignore a failure during testing. Its use is NOT RECOMMENDED, but quite convenient on occasion. + + + + + ${encoding} -+ ${failIfNoTests} ++ ${failIfNoTests} ++ ${failsafe.failOnFlakeCount} + ++ + ${maven.test.skip} + ${maven.test.skip.exec} + ${skipITs} @@ -1737,7 +2185,6 @@ + + + ${maven.test.failure.ignore} -+ + + + @@ -1752,291 +2199,117 @@ + org.apache.maven.surefire + maven-surefire-common + jar -+ 2.22.0 -+ -+ -+ org.apache.maven -+ maven-plugin-api -+ jar -+ 3.3.3 -+ -+ -+ org.codehaus.plexus -+ plexus-classworlds -+ jar -+ 2.5.2 -+ -+ -+ org.codehaus.plexus -+ plexus-utils -+ jar -+ 3.1.0 -+ -+ -+ org.eclipse.sisu -+ org.eclipse.sisu.plexus -+ jar -+ 0.3.3 -+ -+ -+ org.apache.maven.plugin-tools -+ maven-plugin-annotations -+ jar -+ 3.5 -+ -+ -+ org.apache.maven -+ maven-compat -+ jar -+ any -+ -+ -+ org.codehaus.plexus -+ plexus-interpolation -+ jar -+ 1.24 -+ -+ -+ org.apache.maven.wagon -+ wagon-provider-api -+ jar -+ 3.1.0 ++ 3.2.5 + + + org.apache.maven.surefire + surefire-api + jar -+ 2.22.0 ++ 3.2.5 + + + org.apache.maven.surefire + surefire-logger-api + jar -+ 2.22.0 ++ 3.2.5 ++ ++ ++ org.apache.maven.surefire ++ surefire-extensions-api ++ jar ++ 3.2.5 + + + org.apache.maven.surefire + surefire-booter + jar -+ 2.22.0 ++ 3.2.5 + + -+ org.apache.maven -+ maven-artifact ++ org.apache.maven.surefire ++ surefire-extensions-spi + jar -+ 3.3.3 ++ 3.2.5 + + -+ org.apache.maven -+ maven-model ++ org.eclipse.aether ++ aether-util + jar -+ 3.3.3 -+ -+ -+ org.apache.maven -+ maven-core -+ jar -+ 3.3.3 -+ -+ -+ org.apache.maven -+ maven-settings -+ jar -+ 3.3.3 -+ -+ -+ org.apache.maven.resolver -+ maven-resolver-util -+ jar -+ 1.1.1 -+ -+ -+ org.eclipse.sisu -+ org.eclipse.sisu.inject -+ jar -+ 0.3.3 -+ -+ -+ javax.enterprise -+ cdi-api -+ jar -+ 1.1 -+ -+ -+ javax.el -+ javax.el-api -+ jar -+ 3.0.0 -+ -+ -+ org.jboss.spec.javax.interceptor -+ jboss-interceptors-api_1.2_spec -+ jar -+ any -+ -+ -+ com.google.guava -+ guava -+ jar -+ 20.0 -+ -+ -+ com.google.inject -+ guice -+ jar -+ 4.2.0 -+ -+ -+ aopalliance -+ aopalliance -+ jar -+ 1.0 -+ -+ -+ cglib -+ cglib -+ jar -+ 3.2.0 -+ -+ -+ org.apache.maven -+ maven-resolver-provider -+ jar -+ 3.5.4 -+ -+ -+ org.apache.maven.resolver -+ maven-resolver-api -+ jar -+ 1.1.1 -+ -+ -+ javax.inject -+ javax.inject -+ jar -+ 1 -+ -+ -+ org.apache.maven.resolver -+ maven-resolver-impl -+ jar -+ 1.1.1 -+ -+ -+ org.slf4j -+ slf4j-api -+ jar -+ 1.7.25 -+ -+ -+ org.apache.maven -+ maven-repository-metadata -+ jar -+ 3.5.4 -+ -+ -+ org.apache.maven.resolver -+ maven-resolver-spi -+ jar -+ 1.1.1 -+ -+ -+ org.codehaus.plexus -+ plexus-component-annotations -+ jar -+ 1.5.5 -+ -+ -+ org.apache.maven -+ maven-model-builder -+ jar -+ 3.5.4 -+ -+ -+ org.apache.maven -+ maven-builder-support -+ jar -+ 3.5.4 -+ -+ -+ org.apache.maven -+ maven-settings-builder -+ jar -+ 3.5.4 -+ -+ -+ org.sonatype.plexus -+ plexus-sec-dispatcher -+ jar -+ 1.4 -+ -+ -+ org.sonatype.plexus -+ plexus-cipher -+ jar -+ 1.4 -+ -+ -+ junit -+ junit -+ jar -+ 4.12 -+ -+ -+ org.hamcrest -+ hamcrest-core -+ jar -+ 1.3 ++ 1.0.0.v20140518 + + + org.apache.maven.shared + maven-common-artifact-filters + jar -+ 1.3 ++ 3.1.1 + + + org.codehaus.plexus + plexus-java + jar -+ 0.9.8 ++ 1.2.0 + + + org.ow2.asm + asm + jar -+ 6.2 ++ 9.2 + + + com.thoughtworks.qdox + qdox + jar -+ 2.0-M8 ++ 2.0.1 + + -+ org.apache.maven.shared -+ maven-shared-utils ++ org.apache.maven.surefire ++ surefire-shared-utils + jar -+ 3.2.1 -+ -+ -+ org.apache.commons -+ commons-lang3 -+ jar -+ 3.5 ++ 3.2.5 + + + commons-io + commons-io + jar -+ 2.5 ++ 2.15.1 ++ ++ ++ org.apache.commons ++ commons-compress ++ jar ++ 1.25.0 ++ ++ ++ org.slf4j ++ slf4j-api ++ jar ++ 1.7.36 ++ ++ ++ org.apache.maven.resolver ++ maven-resolver-api ++ jar ++ 1.9.18 ++ ++ ++ org.apache.maven.shared ++ maven-shared-utils ++ jar ++ 3.3.4 ++ ++ ++ org.apache.commons ++ commons-lang3 ++ jar ++ 3.14.0 + + + ---- surefire-2.22.0/maven-failsafe-plugin/src/main/java/org/apache/maven/plugin/failsafe/HelpMojo.java 1970-01-01 01:00:00.000000000 +0100 -+++ surefire-2.22.0/maven-failsafe-plugin/src/main/java/org/apache/maven/plugin/failsafe/HelpMojo.java 2019-04-01 16:37:16.245968848 +0200 -@@ -0,0 +1,458 @@ -+ -+package org.apache.maven.plugin.failsafe; +\ No newline at end of file +--- /dev/null ++++ b/maven-failsafe-plugin/src/main/java/org/apache/maven/plugin/maven_failsafe_plugin/HelpMojo.java +@@ -0,0 +1,448 @@ ++package org.apache.maven.plugins.maven_failsafe_plugin; + +import org.apache.maven.plugin.AbstractMojo; +import org.apache.maven.plugin.MojoExecutionException; @@ -2094,7 +2367,7 @@ + @Parameter( property = "indentSize", defaultValue = "2" ) + private int indentSize; + -+ // groupId/artifactId/plugin-help.xml ++ // /META-INF/maven///plugin-help.xml + private static final String PLUGIN_HELP_PATH = + "/META-INF/maven/org.apache.maven.plugins/maven-failsafe-plugin/plugin-help.xml"; + @@ -2104,10 +2377,12 @@ + throws MojoExecutionException + { + getLog().debug( "load plugin-help.xml: " + PLUGIN_HELP_PATH ); -+ InputStream is = null; -+ try ++ try ( InputStream is = getClass().getResourceAsStream( PLUGIN_HELP_PATH ) ) + { -+ is = getClass().getResourceAsStream( PLUGIN_HELP_PATH ); ++ if ( is == null ) ++ { ++ throw new MojoExecutionException( "Could not find plugin descriptor at " + PLUGIN_HELP_PATH ); ++ } + DocumentBuilderFactory dbFactory = DocumentBuilderFactory.newInstance(); + DocumentBuilder dBuilder = dbFactory.newDocumentBuilder(); + return dBuilder.parse( is ); @@ -2124,25 +2399,12 @@ + { + throw new MojoExecutionException( e.getMessage(), e ); + } -+ finally -+ { -+ if ( is != null ) -+ { -+ try -+ { -+ is.close(); -+ } -+ catch ( IOException e ) -+ { -+ throw new MojoExecutionException( e.getMessage(), e ); -+ } -+ } -+ } + } + + /** + * {@inheritDoc} + */ ++ @Override + public void execute() + throws MojoExecutionException + { @@ -2214,13 +2476,13 @@ + return string != null && string.length() > 0; + } + -+ private String getValue( Node node, String elementName ) ++ private static String getValue( Node node, String elementName ) + throws MojoExecutionException + { + return getSingleChild( node, elementName ).getTextContent(); + } + -+ private Node getSingleChild( Node node, String elementName ) ++ private static Node getSingleChild( Node node, String elementName ) + throws MojoExecutionException + { + List namedChild = findNamedChild( node, elementName ); @@ -2235,7 +2497,7 @@ + return namedChild.get( 0 ); + } + -+ private List findNamedChild( Node node, String elementName ) ++ private static List findNamedChild( Node node, String elementName ) + { + List result = new ArrayList(); + NodeList childNodes = node.getChildNodes(); @@ -2250,7 +2512,7 @@ + return result; + } + -+ private Node findSingleChild( Node node, String elementName ) ++ private static Node findSingleChild( Node node, String elementName ) + throws MojoExecutionException + { + List elementsByTagName = findNamedChild( node, elementName ); @@ -2329,7 +2591,9 @@ + append( sb, "Deprecated. " + deprecated.getTextContent(), 3 ); + append( sb, "", 0 ); + } -+ append( sb, parameterDescription, 3 ); ++ if ( isNotEmpty( parameterDescription ) ) { ++ append( sb, parameterDescription, 3 ); ++ } + if ( "true".equals( getValue( parameter, "required" ) ) ) + { + append( sb, "Required: Yes", 3 ); @@ -2480,8 +2744,8 @@ + } + return level; + } -+ -+ private String getPropertyFromExpression( String expression ) ++ ++ private static String getPropertyFromExpression( String expression ) + { + if ( expression != null && expression.startsWith( "${" ) && expression.endsWith( "}" ) + && !expression.substring( 2 ).contains( "${" ) ) @@ -2493,10 +2757,13 @@ + return null; + } +} ---- surefire-2.22.0/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 -+++ surefire-2.22.0/maven-surefire-plugin/src/main/filtered-resources/META-INF/maven/org.apache.maven.plugins/maven-surefire-plugin/plugin-help.xml 2019-04-01 16:35:39.493479592 +0200 -@@ -0,0 +1,686 @@ +--- /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,897 @@ + ++ ++ ++ + + ${project.name} + ${project.description} @@ -2515,7 +2782,7 @@ + false + false + true -+ org.apache.maven.plugin.surefire.HelpMojo ++ org.apache.maven.plugins.maven_surefire_plugin.HelpMojo + java + per-lookup + once-per-session @@ -2526,32 +2793,28 @@ + boolean + false + true -+ Display help information on maven-surefire-plugin. -+Call mvn surefire:help -Ddetail=true -Dgoal=<goal-name> to display parameter details. ++ If true, display all settable properties for each goal. + + + goal + java.lang.String + false + true -+ Display help information on maven-surefire-plugin. -+Call mvn surefire:help -Ddetail=true -Dgoal=<goal-name> to display parameter details. ++ The name of the goal for which to show help. If unspecified, all goals will be displayed. + + + indentSize + int + false + true -+ Display help information on maven-surefire-plugin. -+Call mvn surefire:help -Ddetail=true -Dgoal=<goal-name> to display parameter details. ++ The number of spaces per indentation level, should be positive. + + + lineLength + int + false + true -+ Display help information on maven-surefire-plugin. -+Call mvn surefire:help -Ddetail=true -Dgoal=<goal-name> to display parameter details. ++ The maximum length of a display line, should be positive. + + + @@ -2579,12 +2842,27 @@ + true + + ++ 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 -+ Run tests using Surefire. ++ 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 @@ -2592,14 +2870,11 @@ + 2.1 + false + true -+ Run tests using Surefire. -+ -+ -+ basedir -+ java.io.File -+ false -+ true -+ Run tests using Surefire. ++ Arbitrary JVM options to set on the command line. ++ ++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> + + + childDelegation @@ -2607,14 +2882,15 @@ + 2.1 + false + true -+ Run tests using Surefire. ++ 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 + java.io.File + false + true -+ Run tests using Surefire. ++ The directory containing generated classes of the project being tested. This will be included after the test classes in the test classpath. + + + classpathDependencyExcludes @@ -2622,7 +2898,10 @@ + 2.6 + false + true -+ Run tests using Surefire. ++ 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 @@ -2630,7 +2909,20 @@ + 2.6 + false + true -+ Run tests using Surefire. ++ 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 ++ org.apache.maven.plugin.surefire.extensions.SurefireConsoleOutputReporter ++ false ++ true ++ + + + debugForkedProcess @@ -2638,7 +2930,7 @@ + 2.4 + false + true -+ Run tests using Surefire. ++ Attach a debugger to the forked JVM. If set to "true", the process will suspend and wait for a debugger to attach on port 5005. If set to some other string, that string will be appended to the argLine, allowing you to configure arbitrary debuggability options (without overwriting the other options specified through the argLine parameter). + + + dependenciesToScan @@ -2646,15 +2938,32 @@ + 2.15 + false + true -+ Run tests using Surefire. ++ 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 ++ No reason given + false + true -+ Run tests using Surefire. ++ 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 @@ -2662,7 +2971,24 @@ + 2.3.1 + false + true -+ Run tests using Surefire. ++ By default, Surefire enables JVM assertions for the execution of your test cases. To disable the assertions, set this flag to "false". ++ ++ ++ enableProcessChecker ++ java.lang.String ++ 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. ++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: ++mvn test -Dsurefire.enableProcessChecker=all + + + encoding @@ -2670,15 +2996,26 @@ + 3.0.0-M1 + false + true -+ Run tests using Surefire. ++ The character encoding scheme to be applied while generating test report files (see target/surefire-reports/yourTestName.txt). The report output files (*-out.txt) are encoded in UTF-8 if not set otherwise. + + + environmentVariables -+ java.util.Map ++ java.util.Map<java.lang.String, java.lang.String> + 2.1.3 + false + true -+ Run tests using Surefire. ++ Additional environment variables to set on the command line. ++ ++ ++ excludedEnvironmentVariables ++ java.lang.String[] ++ 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: ++mvn test -Dsurefire.excludedEnvironmentVariables=ACME1,ACME2,ACME3 + + + excludedGroups @@ -2686,37 +3023,63 @@ + 2.2 + false + true -+ Run tests using Surefire. ++ (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. ++ ++ ++ excludeJUnit5Engines ++ java.lang.String[] ++ 3.0.0-M6 ++ false ++ true ++ Provide the ID/s of an JUnit engine to be excluded in the test run. + + + excludes -+ java.util.List ++ java.util.List<java.lang.String> + false + true -+ Run tests using Surefire. ++ 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> ++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. + + + excludesFile + java.io.File ++ 2.13 + false + true -+ Run tests using Surefire. ++ A file containing exclude patterns. Blank lines, or lines starting with # are ignored. If excludes are also specified, these patterns are appended. Example with path, simple and regex excludes: ++*/test/* **/DontRunTest.* %regex[.*Test.*|.*Not.*] Since 3.0.0-M6, method filtering support is provided in the exclusions file as well, example: pkg.SomeTest#testMethod + + + failIfNoSpecifiedTests -+ java.lang.Boolean ++ boolean + 2.12 + false + true -+ Run tests using Surefire. ++ Set this to "true" to cause a failure if none of the tests specified in -Dtest=... are run. Defaults to "true". + + + failIfNoTests -+ java.lang.Boolean ++ boolean + 2.4 + false + true -+ Run tests using Surefire. ++ Set this to "true" to cause a failure if there are no tests to run. Defaults to "false". ++ ++ ++ failOnFlakeCount ++ int ++ 3.0.0-M6 ++ false ++ true ++ Set this to a value greater than 0 to fail the whole test set if the cumulative number of flakes reaches this threshold. Set to 0 to allow an unlimited number of flakes. + + + forkCount @@ -2724,7 +3087,11 @@ + 2.14 + false + true -+ Run tests using Surefire. ++ 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. + + + forkedProcessExitTimeoutInSeconds @@ -2732,7 +3099,7 @@ + 2.20 + false + true -+ Run tests using Surefire. ++ Forked process is normally terminated without any significant delay after given tests have completed. If the particular tests started non-daemon Thread(s), the process hangs instead of been properly terminated by System.exit(). Use this parameter in order to determine the timeout of terminating the process. see the documentation: http://maven.apache.org/surefire/maven-surefire-plugin/examples/shutdown.html <http://maven.apache.org/surefire/maven-surefire-plugin/examples/shutdown.html> Turns to default fallback value of 30 seconds if negative integer. + + + forkedProcessTimeoutInSeconds @@ -2740,15 +3107,17 @@ + 2.4 + false + true -+ Run tests using Surefire. ++ Kill the forked test process after a certain number of seconds. If set to 0, wait forever for the process, never timing out. + + -+ forkMode -+ java.lang.String -+ 2.1 ++ forkNode ++ org.apache.maven.surefire.extensions.ForkNodeFactory ++ 3.0.0-M5 + false + true -+ Run tests using Surefire. ++ 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> + + + groups @@ -2756,21 +3125,50 @@ + 2.2 + false + true -+ Run tests using Surefire. ++ (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 ++ java.lang.String[] ++ 3.0.0-M6 ++ false ++ true ++ Provide the ID/s of an JUnit engine to be included in the test run. + + + includes -+ java.util.List ++ java.util.List<java.lang.String> + false + true -+ Run tests using Surefire. ++ 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> ++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. + + + includesFile + java.io.File ++ 2.13 + false + true -+ Run tests using Surefire. ++ 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 @@ -2778,15 +3176,7 @@ + 2.3.1 + false + true -+ Run tests using Surefire. -+ -+ -+ junitPlatformArtifactName -+ java.lang.String -+ 2.22.0 -+ false -+ true -+ Run tests using Surefire. ++ Allows you to specify the name of the JUnit artifact. If not set, junit:junit will be used. + + + jvm @@ -2794,7 +3184,7 @@ + 2.1 + false + true -+ Run tests using Surefire. ++ 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 @@ -2802,7 +3192,7 @@ + 2.5 + false + true -+ Run tests using Surefire. ++ (TestNG only) Define the factory class used to create all test instances. + + + parallel @@ -2810,7 +3200,14 @@ + 2.2 + false + true -+ Run tests using Surefire. ++ (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 @@ -2818,7 +3215,8 @@ + 2.17 + false + true -+ Run tests using Surefire. ++ (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 @@ -2826,7 +3224,10 @@ + 2.16 + false + true -+ Run tests using Surefire. ++ 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". + + + parallelTestsTimeoutInSeconds @@ -2834,7 +3235,10 @@ + 2.16 + false + true -+ Run tests using Surefire. ++ 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". + + + perCoreThreadCount @@ -2842,14 +3246,14 @@ + 2.5 + false + true -+ Run tests using Surefire. ++ (JUnit 4.7 provider) Indicates that threadCount, threadCountSuites, threadCountClasses, threadCountMethods are per cpu core. + + + printSummary + boolean + false + true -+ Run tests using Surefire. ++ Option to print summary of test suites or just print the test cases that have errors. + + + properties @@ -2857,7 +3261,7 @@ + 2.4 + false + true -+ Run tests using Surefire. ++ List of properties for configuring all TestNG related configurations. This is the new preferred method of configuring TestNG. + + + redirectTestOutputToFile @@ -2865,43 +3269,35 @@ + 2.3 + false + true -+ Run tests using Surefire. -+ -+ -+ remoteRepositories -+ java.util.List -+ 2.2 -+ false -+ true -+ Run tests using Surefire. ++ Set this to "true" to redirect the unit test standard output to a file (found in reportsDirectory/testName-output.txt). + + + reportFormat + java.lang.String + false + true -+ Run tests using Surefire. ++ Selects the formatting for the test report to be generated. Can be set as "brief" or "plain". Only applies to the output format of the output files (target/surefire-reports/testName.txt) + + + reportNameSuffix + java.lang.String + false + true -+ Run tests using Surefire. ++ 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 + java.io.File + false + true -+ Run tests using Surefire. ++ Base directory where all reports are written to. + + + rerunFailingTestsCount + int + false + true -+ Run tests using Surefire. ++ (JUnit 4+ providers and JUnit 5+ providers since 3.0.0-M4) The number of times each failing test will be rerun. If set larger than 0, rerun failing tests immediately after they fail. If a failing test passes in any of those reruns, it will be marked as pass and reported as a "flake". However, all the failing attempts will be recorded. + + + reuseForks @@ -2909,7 +3305,7 @@ + 2.13 + false + true -+ Run tests using Surefire. ++ 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 @@ -2917,7 +3313,27 @@ + 2.7 + false + true -+ Run tests using Surefire. ++ 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. ++ ++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. ++ ++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. ++ ++ ++ runOrderRandomSeed ++ java.lang.Long ++ 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. ++ ++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. + + + shutdown @@ -2925,14 +3341,19 @@ + 2.19 + false + true -+ Run tests using Surefire. ++ 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. + + + skip + boolean + false + true -+ Run tests using Surefire. ++ 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 @@ -2940,7 +3361,10 @@ + 2.19 + false + true -+ Run tests using Surefire. ++ Set to error/failure count in order to skip remaining tests. Due to race conditions in parallel/forked execution this may not be fully guaranteed. ++Enable with system property -Dsurefire.skipAfterFailureCount=1 or any number greater than zero. Defaults to "0". ++See the prerequisites and limitations in documentation: ++http://maven.apache.org/plugins/maven-surefire-plugin/examples/skip-after-failure.html <http://maven.apache.org/plugins/maven-surefire-plugin/examples/skip-after-failure.html> + + + skipExec @@ -2949,7 +3373,7 @@ + Use skipTests instead. + false + true -+ Run tests using Surefire. ++ This old parameter is just like skipTests, but bound to the old property "maven.test.skip.exec". + + + skipTests @@ -2957,7 +3381,22 @@ + 2.4 + false + true -+ Run tests using Surefire. ++ 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 ++ org.apache.maven.plugin.surefire.extensions.SurefireStatelessTestsetInfoReporter ++ false ++ true ++ ++ ++ ++ statelessTestsetReporter ++ org.apache.maven.plugin.surefire.extensions.SurefireStatelessReporter ++ false ++ true ++ Note: use the legacy system property disableXmlReport set to true to disable the report. + + + suiteXmlFiles @@ -2965,7 +3404,8 @@ + 2.2 + false + true -+ Run tests using Surefire. ++ (TestNG) List of <suiteXmlFile> elements specifying TestNG suite xml file locations. Note that suiteXmlFiles is incompatible with several other parameters of this plugin, like includes and excludes. ++This parameter is ignored if the test parameter is specified (allowing you to run a single test instead of an entire suite). + + + systemProperties @@ -2973,23 +3413,22 @@ + Use systemPropertyVariables instead. + false + true -+ Run tests using Surefire. ++ List of System properties to pass to a provider. + + + systemPropertiesFile + java.io.File -+ 2.8.2 + false + true -+ Run tests using Surefire. ++ + + + systemPropertyVariables -+ java.util.Map ++ java.util.Map<java.lang.String, java.lang.String> + 2.5 + false + true -+ Run tests using Surefire. ++ List of System properties to pass to a provider. + + + tempDir @@ -2997,28 +3436,35 @@ + 2.20 + false + true -+ Run tests using Surefire. ++ 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 -+ Run tests using Surefire. ++ 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.*]" ++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:*]. + + + testClassesDirectory + java.io.File + false + true -+ Run tests using Surefire. ++ The directory containing generated test classes of the project being tested. This will be included at the beginning of the test classpath. + + + testFailureIgnore + boolean + false + true -+ Run tests using Surefire. ++ Set this to "true" to ignore a failure during testing. Its use is NOT RECOMMENDED, but quite convenient on occasion. + + + testNGArtifactName @@ -3026,15 +3472,15 @@ + 2.3.1 + false + true -+ Run tests using Surefire. ++ 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 -+ true ++ false + true -+ Run tests using Surefire. ++ The test source directory containing test class sources. Important only for TestNG HTML reports. + + + threadCount @@ -3042,7 +3488,7 @@ + 2.2 + false + true -+ Run tests using Surefire. ++ (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 @@ -3050,7 +3496,11 @@ + 2.16 + false + true -+ Run tests using Surefire. ++ (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 @@ -3058,7 +3508,11 @@ + 2.16 + false + true -+ Run tests using Surefire. ++ (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 @@ -3066,7 +3520,10 @@ + 2.16 + false + true -+ Run tests using Surefire. ++ (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 @@ -3074,14 +3531,14 @@ + 2.2 + false + true -+ Run tests using Surefire. ++ Whether to trim the stack trace in the reports to just the lines within the test, or show the full trace. + + + useFile + boolean + false + true -+ Run tests using Surefire. ++ Option to generate a file test report or just output the test report to the console. + + + useManifestOnlyJar @@ -3089,7 +3546,17 @@ + 2.4.3 + false + true -+ Run tests using Surefire. ++ 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. ++ ++ ++ useModulePath ++ boolean ++ 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. ++Defaults to true. + + + useSystemClassLoader @@ -3097,7 +3564,7 @@ + 2.3 + false + true -+ Run tests using Surefire. ++ Option to pass dependencies to the system's classloader instead of using an isolated class loader when forking. Prevents problems with JDKs which implement the service provider lookup mechanism by using the system's ClassLoader. + + + useUnlimitedThreads @@ -3105,7 +3572,7 @@ + 2.5 + false + true -+ Run tests using Surefire. ++ (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 @@ -3113,13 +3580,13 @@ + 2.1.3 + false + true -+ Run tests using Surefire. ++ Command line working directory. + + + ++ ${maven.test.additionalClasspathDependencies} + ${maven.test.additionalClasspath} + ${argLine} -+ + ${childDelegation} + + ${maven.test.dependency.excludes} @@ -3127,19 +3594,25 @@ + ${dependenciesToScan} + ${disableXmlReport} + ${enableAssertions} ++ ${surefire.enableProcessChecker} + ${surefire.encoding} ++ ${surefire.excludedEnvironmentVariables} + ${excludedGroups} ++ ${surefire.excludeJUnit5Engines} ++ ${surefire.excludes} + ${surefire.excludesFile} -+ ${surefire.failIfNoSpecifiedTests} -+ ${failIfNoTests} ++ ${surefire.failIfNoSpecifiedTests} ++ ${failIfNoTests} ++ ${surefire.failOnFlakeCount} + ${forkCount} + ${surefire.exitTimeout} + ${surefire.timeout} -+ ${forkMode} ++ ${surefire.forkNode} + ${groups} ++ ${surefire.includeJUnit5Engines} ++ ${surefire.includes} + ${surefire.includesFile} + ${junitArtifactName} -+ ${junitPlatformArtifactName} + ${jvm} + ${objectFactory} + ${parallel} @@ -3149,19 +3622,20 @@ + ${perCoreThreadCount} + ${surefire.printSummary} + ${maven.test.redirectTestOutputToFile} -+ + ${surefire.reportFormat} + ${surefire.reportNameSuffix} + + ${surefire.rerunFailingTestsCount} + ${reuseForks} + ${surefire.runOrder} -+ ${surefire.shutdown} ++ ${surefire.runOrder.random.seed} ++ ${surefire.shutdown} + ${maven.test.skip} + ${surefire.skipAfterFailureCount} + ${maven.test.skip.exec} + ${skipTests} + ${surefire.suiteXmlFiles} ++ ${surefire.systemPropertiesFile} + ${tempDir} + ${test} + @@ -3172,9 +3646,10 @@ + ${threadCountClasses} + ${threadCountMethods} + ${threadCountSuites} -+ ${trimStackTrace} ++ ${trimStackTrace} + ${surefire.useFile} + ${surefire.useManifestOnlyJar} ++ ${surefire.useModulePath} + ${surefire.useSystemClassLoader} + ${useUnlimitedThreads} + ${basedir} @@ -3182,10 +3657,14 @@ + + + ---- surefire-2.22.0/maven-surefire-plugin/src/main/filtered-resources/META-INF/maven/plugin.xml 1970-01-01 01:00:00.000000000 +0100 -+++ surefire-2.22.0/maven-surefire-plugin/src/main/filtered-resources/META-INF/maven/plugin.xml 2019-04-01 16:35:39.493479592 +0200 -@@ -0,0 +1,1060 @@ +\ No newline at end of file +--- /dev/null ++++ b/maven-surefire-plugin/src/main/filtered-resources/META-INF/maven/plugin.xml +@@ -0,0 +1,1099 @@ + ++ ++ ++ + + ${project.name} + ${project.description} @@ -3195,18 +3674,20 @@ + surefire + false + true ++ 1.8 ++ 3.2.5 + + + help -+ Display help information on maven-surefire-plugin.<br> -+Call <code>mvn surefire:help -Ddetail=true -Dgoal=&lt;goal-name&gt;</code> to display parameter details. ++ Display help information on maven-surefire-plugin. ++Call mvn surefire:help -Ddetail=true -Dgoal=<goal-name> to display parameter details. + false + false + false + false + false + true -+ org.apache.maven.plugin.surefire.HelpMojo ++ org.apache.maven.plugins.maven_surefire_plugin.HelpMojo + java + per-lookup + once-per-session @@ -3217,32 +3698,28 @@ + boolean + false + true -+ Display help information on maven-surefire-plugin.<br> -+Call <code>mvn surefire:help -Ddetail=true -Dgoal=&lt;goal-name&gt;</code> to display parameter details. ++ If true, display all settable properties for each goal. + + + goal + java.lang.String + false + true -+ Display help information on maven-surefire-plugin.<br> -+Call <code>mvn surefire:help -Ddetail=true -Dgoal=&lt;goal-name&gt;</code> to display parameter details. ++ The name of the goal for which to show help. If unspecified, all goals will be displayed. + + + indentSize + int + false + true -+ Display help information on maven-surefire-plugin.<br> -+Call <code>mvn surefire:help -Ddetail=true -Dgoal=&lt;goal-name&gt;</code> to display parameter details. ++ The number of spaces per indentation level, should be positive. + + + lineLength + int + false + true -+ Display help information on maven-surefire-plugin.<br> -+Call <code>mvn surefire:help -Ddetail=true -Dgoal=&lt;goal-name&gt;</code> to display parameter details. ++ The maximum length of a display line, should be positive. + + + @@ -3270,12 +3747,27 @@ + true + + ++ 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 -+ Run tests using Surefire. ++ 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 @@ -3283,14 +3775,18 @@ + 2.1 + false + true -+ Run tests using Surefire. ++ Arbitrary JVM options to set on the command line. ++ ++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> + + + basedir + java.io.File -+ false -+ true -+ Run tests using Surefire. ++ true ++ false ++ The base directory of the project being tested. This can be obtained in your integration test via System.getProperty("basedir"). + + + childDelegation @@ -3298,14 +3794,15 @@ + 2.1 + false + true -+ Run tests using Surefire. ++ 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 + java.io.File + false + true -+ Run tests using Surefire. ++ The directory containing generated classes of the project being tested. This will be included after the test classes in the test classpath. + + + classpathDependencyExcludes @@ -3313,7 +3810,10 @@ + 2.6 + false + true -+ Run tests using Surefire. ++ 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 @@ -3321,7 +3821,20 @@ + 2.6 + false + true -+ Run tests using Surefire. ++ 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 ++ org.apache.maven.plugin.surefire.extensions.SurefireConsoleOutputReporter ++ false ++ true ++ + + + debugForkedProcess @@ -3329,7 +3842,7 @@ + 2.4 + false + true -+ Run tests using Surefire. ++ Attach a debugger to the forked JVM. If set to "true", the process will suspend and wait for a debugger to attach on port 5005. If set to some other string, that string will be appended to the argLine, allowing you to configure arbitrary debuggability options (without overwriting the other options specified through the argLine parameter). + + + dependenciesToScan @@ -3337,15 +3850,32 @@ + 2.15 + false + true -+ Run tests using Surefire. ++ 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 ++ No reason given + false + true -+ Run tests using Surefire. ++ 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 @@ -3353,7 +3883,24 @@ + 2.3.1 + false + true -+ Run tests using Surefire. ++ By default, Surefire enables JVM assertions for the execution of your test cases. To disable the assertions, set this flag to "false". ++ ++ ++ enableProcessChecker ++ java.lang.String ++ 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. ++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: ++mvn test -Dsurefire.enableProcessChecker=all + + + encoding @@ -3361,7 +3908,7 @@ + 3.0.0-M1 + false + true -+ Run tests using Surefire. ++ The character encoding scheme to be applied while generating test report files (see target/surefire-reports/yourTestName.txt). The report output files (*-out.txt) are encoded in UTF-8 if not set otherwise. + + + environmentVariables @@ -3369,7 +3916,26 @@ + 2.1.3 + false + true -+ Run tests using Surefire. ++ Additional environment variables to set on the command line. ++ ++ ++ excludeJUnit5Engines ++ java.lang.String[] ++ 3.0.0-M6 ++ false ++ true ++ Provide the ID/s of an JUnit engine to be excluded in the test run. ++ ++ ++ excludedEnvironmentVariables ++ java.lang.String[] ++ 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: ++mvn test -Dsurefire.excludedEnvironmentVariables=ACME1,ACME2,ACME3 + + + excludedGroups @@ -3377,37 +3943,55 @@ + 2.2 + false + true -+ Run tests using Surefire. ++ (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 -+ Run tests using Surefire. ++ 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> ++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. + + + excludesFile + java.io.File ++ 2.13 + false + true -+ Run tests using Surefire. ++ A file containing exclude patterns. Blank lines, or lines starting with # are ignored. If excludes are also specified, these patterns are appended. Example with path, simple and regex excludes: ++*/test/* **/DontRunTest.* %regex[.*Test.*|.*Not.*] Since 3.0.0-M6, method filtering support is provided in the exclusions file as well, example: pkg.SomeTest#testMethod + + + failIfNoSpecifiedTests -+ java.lang.Boolean ++ boolean + 2.12 + false + true -+ Run tests using Surefire. ++ Set this to "true" to cause a failure if none of the tests specified in -Dtest=... are run. Defaults to "true". + + + failIfNoTests -+ java.lang.Boolean ++ boolean + 2.4 + false + true -+ Run tests using Surefire. ++ Set this to "true" to cause a failure if there are no tests to run. Defaults to "false". ++ ++ ++ failOnFlakeCount ++ int ++ 3.0.0-M6 ++ false ++ true ++ Set this to a value greater than 0 to fail the whole test set if the cumulative number of flakes reaches this threshold. Set to 0 to allow an unlimited number of flakes. + + + forkCount @@ -3415,15 +3999,21 @@ + 2.14 + false + true -+ Run tests using Surefire. ++ 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. + + -+ forkMode -+ java.lang.String -+ 2.1 ++ forkNode ++ org.apache.maven.surefire.extensions.ForkNodeFactory ++ 3.0.0-M5 + false + true -+ Run tests using Surefire. ++ 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> + + + forkedProcessExitTimeoutInSeconds @@ -3431,7 +4021,7 @@ + 2.20 + false + true -+ Run tests using Surefire. ++ Forked process is normally terminated without any significant delay after given tests have completed. If the particular tests started non-daemon Thread(s), the process hangs instead of been properly terminated by System.exit(). Use this parameter in order to determine the timeout of terminating the process. see the documentation: http://maven.apache.org/surefire/maven-surefire-plugin/examples/shutdown.html <http://maven.apache.org/surefire/maven-surefire-plugin/examples/shutdown.html> Turns to default fallback value of 30 seconds if negative integer. + + + forkedProcessTimeoutInSeconds @@ -3439,7 +4029,7 @@ + 2.4 + false + true -+ Run tests using Surefire. ++ Kill the forked test process after a certain number of seconds. If set to 0, wait forever for the process, never timing out. + + + groups @@ -3447,21 +4037,50 @@ + 2.2 + false + true -+ Run tests using Surefire. ++ (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 ++ java.lang.String[] ++ 3.0.0-M6 ++ false ++ true ++ Provide the ID/s of an JUnit engine to be included in the test run. + + + includes + java.util.List + false + true -+ Run tests using Surefire. ++ 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> ++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. + + + includesFile + java.io.File ++ 2.13 + false + true -+ Run tests using Surefire. ++ 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 @@ -3469,15 +4088,7 @@ + 2.3.1 + false + true -+ Run tests using Surefire. -+ -+ -+ junitPlatformArtifactName -+ java.lang.String -+ 2.22.0 -+ false -+ true -+ Run tests using Surefire. ++ Allows you to specify the name of the JUnit artifact. If not set, junit:junit will be used. + + + jvm @@ -3485,14 +4096,7 @@ + 2.1 + false + true -+ Run tests using Surefire. -+ -+ -+ localRepository -+ org.apache.maven.artifact.repository.ArtifactRepository -+ true -+ false -+ Run tests using Surefire. ++ 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 @@ -3500,7 +4104,7 @@ + 2.5 + false + true -+ Run tests using Surefire. ++ (TestNG only) Define the factory class used to create all test instances. + + + parallel @@ -3508,14 +4112,21 @@ + 2.2 + false + true -+ Run tests using Surefire. ++ (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 -+ Run tests using Surefire. ++ Parallel Maven Execution. + + + parallelOptimized @@ -3523,7 +4134,8 @@ + 2.17 + false + true -+ Run tests using Surefire. ++ (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 @@ -3531,7 +4143,10 @@ + 2.16 + false + true -+ Run tests using Surefire. ++ 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". + + + parallelTestsTimeoutInSeconds @@ -3539,7 +4154,10 @@ + 2.16 + false + true -+ Run tests using Surefire. ++ 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". + + + perCoreThreadCount @@ -3547,44 +4165,51 @@ + 2.5 + false + true -+ Run tests using Surefire. ++ (JUnit 4.7 provider) Indicates that threadCount, threadCountSuites, threadCountClasses, threadCountMethods are per cpu core. + + + pluginArtifactMap + java.util.Map + true + false -+ Run tests using Surefire. ++ Map of plugin artifacts. + + + pluginDescriptor + org.apache.maven.plugin.descriptor.PluginDescriptor + 2.12 -+ false ++ true + false -+ Run tests using Surefire. ++ Information about this plugin, mainly used to lookup this plugin's configuration from the currently executing project. + + + printSummary + boolean + false + true -+ Run tests using Surefire. ++ Option to print summary of test suites or just print the test cases that have errors. ++ ++ ++ project ++ org.apache.maven.project.MavenProject ++ true ++ false ++ The Maven Project Object. + + + projectArtifactMap + java.util.Map + true + false -+ Run tests using Surefire. ++ Map of project artifacts. + + + projectBuildDirectory + java.io.File + 2.20 -+ false ++ true + false -+ Run tests using Surefire. ++ Read-only parameter with value of Maven property project.build.directory. + + + properties @@ -3592,7 +4217,7 @@ + 2.4 + false + true -+ Run tests using Surefire. ++ List of properties for configuring all TestNG related configurations. This is the new preferred method of configuring TestNG. + + + redirectTestOutputToFile @@ -3600,43 +4225,35 @@ + 2.3 + false + true -+ Run tests using Surefire. -+ -+ -+ remoteRepositories -+ java.util.List -+ 2.2 -+ false -+ true -+ Run tests using Surefire. ++ Set this to "true" to redirect the unit test standard output to a file (found in reportsDirectory/testName-output.txt). + + + reportFormat + java.lang.String + false + true -+ Run tests using Surefire. ++ Selects the formatting for the test report to be generated. Can be set as "brief" or "plain". Only applies to the output format of the output files (target/surefire-reports/testName.txt) + + + reportNameSuffix + java.lang.String + false + true -+ Run tests using Surefire. ++ 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 + java.io.File + false + true -+ Run tests using Surefire. ++ Base directory where all reports are written to. + + + rerunFailingTestsCount + int + false + true -+ Run tests using Surefire. ++ (JUnit 4+ providers and JUnit 5+ providers since 3.0.0-M4) The number of times each failing test will be rerun. If set larger than 0, rerun failing tests immediately after they fail. If a failing test passes in any of those reruns, it will be marked as pass and reported as a "flake". However, all the failing attempts will be recorded. + + + reuseForks @@ -3644,7 +4261,7 @@ + 2.13 + false + true -+ Run tests using Surefire. ++ 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 @@ -3652,7 +4269,34 @@ + 2.7 + false + true -+ Run tests using Surefire. ++ 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. ++ ++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. ++ ++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. ++ ++ ++ runOrderRandomSeed ++ java.lang.Long ++ 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. ++ ++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. ++ ++ ++ session ++ org.apache.maven.execution.MavenSession ++ true ++ false ++ The current build session instance. + + + shutdown @@ -3660,14 +4304,19 @@ + 2.19 + false + true -+ Run tests using Surefire. ++ 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. + + + skip + boolean + false + true -+ Run tests using Surefire. ++ 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 @@ -3675,7 +4324,10 @@ + 2.19 + false + true -+ Run tests using Surefire. ++ Set to error/failure count in order to skip remaining tests. Due to race conditions in parallel/forked execution this may not be fully guaranteed. ++Enable with system property -Dsurefire.skipAfterFailureCount=1 or any number greater than zero. Defaults to "0". ++See the prerequisites and limitations in documentation: ++http://maven.apache.org/plugins/maven-surefire-plugin/examples/skip-after-failure.html <http://maven.apache.org/plugins/maven-surefire-plugin/examples/skip-after-failure.html> + + + skipExec @@ -3684,7 +4336,7 @@ + Use skipTests instead. + false + true -+ Run tests using Surefire. ++ This old parameter is just like skipTests, but bound to the old property "maven.test.skip.exec". + + + skipTests @@ -3692,7 +4344,22 @@ + 2.4 + false + true -+ Run tests using Surefire. ++ 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 ++ org.apache.maven.plugin.surefire.extensions.SurefireStatelessTestsetInfoReporter ++ false ++ true ++ ++ ++ ++ statelessTestsetReporter ++ org.apache.maven.plugin.surefire.extensions.SurefireStatelessReporter ++ false ++ true ++ Note: use the legacy system property disableXmlReport set to true to disable the report. + + + suiteXmlFiles @@ -3700,7 +4367,8 @@ + 2.2 + false + true -+ Run tests using Surefire. ++ (TestNG) List of <suiteXmlFile> elements specifying TestNG suite xml file locations. Note that suiteXmlFiles is incompatible with several other parameters of this plugin, like includes and excludes. ++This parameter is ignored if the test parameter is specified (allowing you to run a single test instead of an entire suite). + + + systemProperties @@ -3708,15 +4376,14 @@ + Use systemPropertyVariables instead. + false + true -+ Run tests using Surefire. ++ List of System properties to pass to a provider. + + + systemPropertiesFile + java.io.File -+ 2.8.2 + false + true -+ Run tests using Surefire. ++ + + + systemPropertyVariables @@ -3724,7 +4391,7 @@ + 2.5 + false + true -+ Run tests using Surefire. ++ List of System properties to pass to a provider. + + + tempDir @@ -3732,28 +4399,35 @@ + 2.20 + false + true -+ Run tests using Surefire. ++ 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 -+ Run tests using Surefire. ++ 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.*]" ++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:*]. + + + testClassesDirectory + java.io.File + false + true -+ Run tests using Surefire. ++ The directory containing generated test classes of the project being tested. This will be included at the beginning of the test classpath. + + + testFailureIgnore + boolean + false + true -+ Run tests using Surefire. ++ Set this to "true" to ignore a failure during testing. Its use is NOT RECOMMENDED, but quite convenient on occasion. + + + testNGArtifactName @@ -3761,15 +4435,15 @@ + 2.3.1 + false + true -+ Run tests using Surefire. ++ 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 -+ true ++ false + true -+ Run tests using Surefire. ++ The test source directory containing test class sources. Important only for TestNG HTML reports. + + + threadCount @@ -3777,7 +4451,7 @@ + 2.2 + false + true -+ Run tests using Surefire. ++ (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 @@ -3785,7 +4459,11 @@ + 2.16 + false + true -+ Run tests using Surefire. ++ (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 @@ -3793,7 +4471,11 @@ + 2.16 + false + true -+ Run tests using Surefire. ++ (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 @@ -3801,7 +4483,10 @@ + 2.16 + false + true -+ Run tests using Surefire. ++ (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 @@ -3809,14 +4494,14 @@ + 2.2 + false + true -+ Run tests using Surefire. ++ Whether to trim the stack trace in the reports to just the lines within the test, or show the full trace. + + + useFile + boolean + false + true -+ Run tests using Surefire. ++ Option to generate a file test report or just output the test report to the console. + + + useManifestOnlyJar @@ -3824,7 +4509,17 @@ + 2.4.3 + false + true -+ Run tests using Surefire. ++ 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. ++ ++ ++ useModulePath ++ boolean ++ 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. ++Defaults to true. + + + useSystemClassLoader @@ -3832,7 +4527,7 @@ + 2.3 + false + true -+ Run tests using Surefire. ++ Option to pass dependencies to the system's classloader instead of using an isolated class loader when forking. Prevents problems with JDKs which implement the service provider lookup mechanism by using the system's ClassLoader. + + + useUnlimitedThreads @@ -3840,7 +4535,7 @@ + 2.5 + false + true -+ Run tests using Surefire. ++ (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 @@ -3848,24 +4543,11 @@ + 2.1.3 + false + true -+ Run tests using Surefire. -+ -+ -+ project -+ org.apache.maven.project.MavenProject -+ true -+ false -+ -+ -+ -+ session -+ org.apache.maven.execution.MavenSession -+ true -+ false -+ ++ Command line working directory. + + + ++ ${maven.test.additionalClasspathDependencies} + ${maven.test.additionalClasspath} + ${argLine} + @@ -3876,21 +4558,26 @@ + ${dependenciesToScan} + ${disableXmlReport} + ${enableAssertions} ++ ${surefire.enableProcessChecker} + ${surefire.encoding} ++ ${surefire.excludeJUnit5Engines} ++ ${surefire.excludedEnvironmentVariables} + ${excludedGroups} ++ ${surefire.excludes} + ${surefire.excludesFile} -+ ${surefire.failIfNoSpecifiedTests} -+ ${failIfNoTests} ++ ${surefire.failIfNoSpecifiedTests} ++ ${failIfNoTests} ++ ${surefire.failOnFlakeCount} + ${forkCount} -+ ${forkMode} ++ ${surefire.forkNode} + ${surefire.exitTimeout} + ${surefire.timeout} + ${groups} ++ ${surefire.includeJUnit5Engines} ++ ${surefire.includes} + ${surefire.includesFile} + ${junitArtifactName} -+ ${junitPlatformArtifactName} + ${jvm} -+ + ${objectFactory} + ${parallel} + @@ -3901,22 +4588,25 @@ + ${plugin.artifactMap} + + ${surefire.printSummary} ++ + ${project.artifactMap} + + ${maven.test.redirectTestOutputToFile} -+ + ${surefire.reportFormat} + ${surefire.reportNameSuffix} + + ${surefire.rerunFailingTestsCount} + ${reuseForks} + ${surefire.runOrder} -+ ${surefire.shutdown} ++ ${surefire.runOrder.random.seed} ++ ++ ${surefire.shutdown} + ${maven.test.skip} + ${surefire.skipAfterFailureCount} + ${maven.test.skip.exec} + ${skipTests} + ${surefire.suiteXmlFiles} ++ ${surefire.systemPropertiesFile} + ${tempDir} + ${test} + @@ -3927,31 +4617,30 @@ + ${threadCountClasses} + ${threadCountMethods} + ${threadCountSuites} -+ ${trimStackTrace} ++ ${trimStackTrace} + ${surefire.useFile} + ${surefire.useManifestOnlyJar} ++ ${surefire.useModulePath} + ${surefire.useSystemClassLoader} + ${useUnlimitedThreads} + ${basedir} -+ -+ + + + -+ org.apache.maven.artifact.factory.ArtifactFactory -+ artifactFactory -+ -+ -+ org.apache.maven.artifact.resolver.ArtifactResolver -+ artifactResolver ++ org.codehaus.plexus.languages.java.jpms.LocationManager ++ locationManager + + + org.codehaus.plexus.logging.Logger + logger + + -+ org.apache.maven.artifact.metadata.ArtifactMetadataSource -+ metadataSource ++ org.apache.maven.surefire.providerapi.ProviderDetector ++ providerDetector ++ ++ ++ org.apache.maven.plugin.surefire.SurefireDependencyResolver ++ surefireDependencyResolver + + + org.apache.maven.toolchain.ToolchainManager @@ -3965,291 +4654,117 @@ + org.apache.maven.surefire + maven-surefire-common + jar -+ 2.22.0 -+ -+ -+ org.apache.maven -+ maven-plugin-api -+ jar -+ 3.3.3 -+ -+ -+ org.codehaus.plexus -+ plexus-classworlds -+ jar -+ 2.5.2 -+ -+ -+ org.codehaus.plexus -+ plexus-utils -+ jar -+ 3.1.0 -+ -+ -+ org.eclipse.sisu -+ org.eclipse.sisu.plexus -+ jar -+ 0.3.3 -+ -+ -+ org.apache.maven.plugin-tools -+ maven-plugin-annotations -+ jar -+ 3.5 -+ -+ -+ org.apache.maven -+ maven-compat -+ jar -+ any -+ -+ -+ org.codehaus.plexus -+ plexus-interpolation -+ jar -+ 1.24 -+ -+ -+ org.apache.maven.wagon -+ wagon-provider-api -+ jar -+ 3.1.0 ++ 3.2.5 + + + org.apache.maven.surefire + surefire-api + jar -+ 2.22.0 ++ 3.2.5 + + + org.apache.maven.surefire + surefire-logger-api + jar -+ 2.22.0 ++ 3.2.5 ++ ++ ++ org.apache.maven.surefire ++ surefire-extensions-api ++ jar ++ 3.2.5 + + + org.apache.maven.surefire + surefire-booter + jar -+ 2.22.0 ++ 3.2.5 + + -+ org.apache.maven.shared -+ maven-shared-utils ++ org.apache.maven.surefire ++ surefire-extensions-spi + jar -+ 3.2.1 ++ 3.2.5 + + -+ org.apache.maven -+ maven-artifact ++ org.eclipse.aether ++ aether-util + jar -+ 3.3.3 -+ -+ -+ commons-io -+ commons-io -+ jar -+ 2.5 -+ -+ -+ org.apache.maven -+ maven-model -+ jar -+ 3.3.3 -+ -+ -+ org.apache.maven -+ maven-core -+ jar -+ 3.3.3 -+ -+ -+ org.apache.maven -+ maven-settings -+ jar -+ 3.3.3 -+ -+ -+ org.apache.maven.resolver -+ maven-resolver-util -+ jar -+ 1.1.1 -+ -+ -+ org.eclipse.sisu -+ org.eclipse.sisu.inject -+ jar -+ 0.3.3 -+ -+ -+ javax.enterprise -+ cdi-api -+ jar -+ 1.1 -+ -+ -+ javax.el -+ javax.el-api -+ jar -+ 3.0.0 -+ -+ -+ org.jboss.spec.javax.interceptor -+ jboss-interceptors-api_1.2_spec -+ jar -+ any -+ -+ -+ com.google.guava -+ guava -+ jar -+ 20.0 -+ -+ -+ com.google.inject -+ guice -+ jar -+ 4.2.0 -+ -+ -+ aopalliance -+ aopalliance -+ jar -+ 1.0 -+ -+ -+ cglib -+ cglib -+ jar -+ 3.2.0 -+ -+ -+ org.apache.maven -+ maven-resolver-provider -+ jar -+ 3.5.4 -+ -+ -+ org.apache.maven.resolver -+ maven-resolver-api -+ jar -+ 1.1.1 -+ -+ -+ javax.inject -+ javax.inject -+ jar -+ 1 -+ -+ -+ org.apache.maven.resolver -+ maven-resolver-impl -+ jar -+ 1.1.1 -+ -+ -+ org.slf4j -+ slf4j-api -+ jar -+ 1.7.25 -+ -+ -+ org.apache.maven -+ maven-repository-metadata -+ jar -+ 3.5.4 -+ -+ -+ org.apache.maven.resolver -+ maven-resolver-spi -+ jar -+ 1.1.1 -+ -+ -+ org.codehaus.plexus -+ plexus-component-annotations -+ jar -+ 1.5.5 -+ -+ -+ org.apache.maven -+ maven-model-builder -+ jar -+ 3.5.4 -+ -+ -+ org.apache.maven -+ maven-builder-support -+ jar -+ 3.5.4 -+ -+ -+ org.apache.maven -+ maven-settings-builder -+ jar -+ 3.5.4 -+ -+ -+ org.sonatype.plexus -+ plexus-sec-dispatcher -+ jar -+ 1.4 -+ -+ -+ org.sonatype.plexus -+ plexus-cipher -+ jar -+ 1.4 -+ -+ -+ junit -+ junit -+ jar -+ 4.12 -+ -+ -+ org.hamcrest -+ hamcrest-core -+ jar -+ 1.3 -+ -+ -+ org.apache.commons -+ commons-lang3 -+ jar -+ 3.5 ++ 1.0.0.v20140518 + + + org.apache.maven.shared + maven-common-artifact-filters + jar -+ 1.3 ++ 3.1.1 + + + org.codehaus.plexus + plexus-java + jar -+ 0.9.8 ++ 1.2.0 + + + org.ow2.asm + asm + jar -+ 6.2 ++ 9.2 + + + com.thoughtworks.qdox + qdox + jar -+ 2.0-M8 ++ 2.0.1 ++ ++ ++ org.apache.maven.surefire ++ surefire-shared-utils ++ jar ++ 3.2.5 ++ ++ ++ commons-io ++ commons-io ++ jar ++ 2.15.1 ++ ++ ++ org.apache.commons ++ commons-compress ++ jar ++ 1.25.0 ++ ++ ++ org.slf4j ++ slf4j-api ++ jar ++ 1.7.36 ++ ++ ++ org.apache.maven.resolver ++ maven-resolver-api ++ jar ++ 1.9.18 ++ ++ ++ org.apache.maven.shared ++ maven-shared-utils ++ jar ++ 3.3.4 ++ ++ ++ org.apache.commons ++ commons-lang3 ++ jar ++ 3.14.0 + + + ---- surefire-2.22.0/maven-surefire-plugin/src/main/java/org/apache/maven/plugin/surefire/HelpMojo.java 1970-01-01 01:00:00.000000000 +0100 -+++ surefire-2.22.0/maven-surefire-plugin/src/main/java/org/apache/maven/plugin/surefire/HelpMojo.java 2019-04-01 16:37:53.006154740 +0200 -@@ -0,0 +1,458 @@ -+ -+package org.apache.maven.plugin.surefire; +\ No newline at end of file +--- /dev/null ++++ b/maven-surefire-plugin/src/main/java/org/apache/maven/plugin/maven_surefire_plugin/HelpMojo.java +@@ -0,0 +1,448 @@ ++package org.apache.maven.plugins.maven_surefire_plugin; + +import org.apache.maven.plugin.AbstractMojo; +import org.apache.maven.plugin.MojoExecutionException; @@ -4307,7 +4822,7 @@ + @Parameter( property = "indentSize", defaultValue = "2" ) + private int indentSize; + -+ // groupId/artifactId/plugin-help.xml ++ // /META-INF/maven///plugin-help.xml + private static final String PLUGIN_HELP_PATH = + "/META-INF/maven/org.apache.maven.plugins/maven-surefire-plugin/plugin-help.xml"; + @@ -4317,10 +4832,12 @@ + throws MojoExecutionException + { + getLog().debug( "load plugin-help.xml: " + PLUGIN_HELP_PATH ); -+ InputStream is = null; -+ try ++ try ( InputStream is = getClass().getResourceAsStream( PLUGIN_HELP_PATH ) ) + { -+ is = getClass().getResourceAsStream( PLUGIN_HELP_PATH ); ++ if ( is == null ) ++ { ++ throw new MojoExecutionException( "Could not find plugin descriptor at " + PLUGIN_HELP_PATH ); ++ } + DocumentBuilderFactory dbFactory = DocumentBuilderFactory.newInstance(); + DocumentBuilder dBuilder = dbFactory.newDocumentBuilder(); + return dBuilder.parse( is ); @@ -4337,25 +4854,12 @@ + { + throw new MojoExecutionException( e.getMessage(), e ); + } -+ finally -+ { -+ if ( is != null ) -+ { -+ try -+ { -+ is.close(); -+ } -+ catch ( IOException e ) -+ { -+ throw new MojoExecutionException( e.getMessage(), e ); -+ } -+ } -+ } + } + + /** + * {@inheritDoc} + */ ++ @Override + public void execute() + throws MojoExecutionException + { @@ -4427,13 +4931,13 @@ + return string != null && string.length() > 0; + } + -+ private String getValue( Node node, String elementName ) ++ private static String getValue( Node node, String elementName ) + throws MojoExecutionException + { + return getSingleChild( node, elementName ).getTextContent(); + } + -+ private Node getSingleChild( Node node, String elementName ) ++ private static Node getSingleChild( Node node, String elementName ) + throws MojoExecutionException + { + List namedChild = findNamedChild( node, elementName ); @@ -4448,7 +4952,7 @@ + return namedChild.get( 0 ); + } + -+ private List findNamedChild( Node node, String elementName ) ++ private static List findNamedChild( Node node, String elementName ) + { + List result = new ArrayList(); + NodeList childNodes = node.getChildNodes(); @@ -4463,7 +4967,7 @@ + return result; + } + -+ private Node findSingleChild( Node node, String elementName ) ++ private static Node findSingleChild( Node node, String elementName ) + throws MojoExecutionException + { + List elementsByTagName = findNamedChild( node, elementName ); @@ -4542,7 +5046,9 @@ + append( sb, "Deprecated. " + deprecated.getTextContent(), 3 ); + append( sb, "", 0 ); + } -+ append( sb, parameterDescription, 3 ); ++ if ( isNotEmpty( parameterDescription ) ) { ++ append( sb, parameterDescription, 3 ); ++ } + if ( "true".equals( getValue( parameter, "required" ) ) ) + { + append( sb, "Required: Yes", 3 ); @@ -4693,8 +5199,8 @@ + } + return level; + } -+ -+ private String getPropertyFromExpression( String expression ) ++ ++ private static String getPropertyFromExpression( String expression ) + { + if ( expression != null && expression.startsWith( "${" ) && expression.endsWith( "}" ) + && !expression.substring( 2 ).contains( "${" ) ) @@ -4706,10 +5212,13 @@ + return null; + } +} ---- surefire-2.22.0/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 -+++ surefire-2.22.0/maven-surefire-report-plugin/src/main/filtered-resources/META-INF/maven/org.apache.maven.plugins/maven-surefire-report-plugin/plugin-help.xml 2019-04-01 16:35:39.497479614 +0200 -@@ -0,0 +1,398 @@ +--- /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 +@@ -0,0 +1,376 @@ + ++ ++ ++ + + ${project.name} + ${project.description} @@ -4720,7 +5229,7 @@ + + + failsafe-report-only -+ Creates a nicely formatted Failsafe Test Report in html format. This goal does not run the tests, it only builds the reports. See https://issues.apache.org/jira/browse/SUREFIRE-257 ++ Creates a nicely formatted Failsafe Test Report in html format. This goal does not run the tests, it only builds the reports. See https://issues.apache.org/jira/browse/SUREFIRE-257 <https://issues.apache.org/jira/browse/SUREFIRE-257> + false + true + false @@ -4739,7 +5248,7 @@ + boolean + false + true -+ Creates a nicely formatted Surefire Test Report in html format. This goal does not run the tests, it only builds the reports. This is a workaround for https://issues.apache.org/jira/browse/SUREFIRE-257 ++ Whether to build an aggregated report at the root, or build individual reports. + + + alwaysGenerateFailsafeReport @@ -4747,50 +5256,52 @@ + 2.11 + false + true -+ Creates a nicely formatted Failsafe Test Report in html format. This goal does not run the tests, it only builds the reports. See https://issues.apache.org/jira/browse/SUREFIRE-257 ++ If set to true the failsafe report will be generated even when there are no failsafe result files. Defaults to false to preserve legacy behaviour pre 2.10. + + -+ description ++ customBundle + java.lang.String -+ 2.21.0 ++ 3.1.0 + false + true -+ Creates a nicely formatted Failsafe Test Report in html format. This goal does not run the tests, it only builds the reports. See https://issues.apache.org/jira/browse/SUREFIRE-257 ++ Path for a custom bundle instead of using the default one. ++Using this field, you could change the texts in the generated reports. + + + linkXRef + boolean + false + true -+ Creates a nicely formatted Surefire Test Report in html format. This goal does not run the tests, it only builds the reports. This is a workaround for https://issues.apache.org/jira/browse/SUREFIRE-257 ++ Whether to link the XRef if found. + + + outputName + java.lang.String + true + true -+ Creates a nicely formatted Failsafe Test Report in html format. This goal does not run the tests, it only builds the reports. See https://issues.apache.org/jira/browse/SUREFIRE-257 ++ The filename to use for the report. + + + reportsDirectories + java.io.File[] + false + true -+ Creates a nicely formatted Surefire Test Report in html format. This goal does not run the tests, it only builds the reports. This is a workaround for https://issues.apache.org/jira/browse/SUREFIRE-257 ++ Directories containing the XML Report files that will be parsed and rendered to HTML format. + + + reportsDirectory + java.io.File ++ No reason given + false + true -+ Creates a nicely formatted Surefire Test Report in html format. This goal does not run the tests, it only builds the reports. This is a workaround for https://issues.apache.org/jira/browse/SUREFIRE-257 ++ (Deprecated, use reportsDirectories) This directory contains the XML Report files that will be parsed and rendered to HTML format. + + + showSuccess + boolean + true + true -+ Creates a nicely formatted Surefire Test Report in html format. This goal does not run the tests, it only builds the reports. This is a workaround for https://issues.apache.org/jira/browse/SUREFIRE-257 ++ If set to false, only failures are shown. + + + skipFailsafeReport @@ -4798,33 +5309,24 @@ + 2.11 + false + true -+ Creates a nicely formatted Failsafe Test Report in html format. This goal does not run the tests, it only builds the reports. See https://issues.apache.org/jira/browse/SUREFIRE-257 -+ -+ -+ title -+ java.lang.String -+ 2.21.0 -+ false -+ true -+ Creates a nicely formatted Failsafe Test Report in html format. This goal does not run the tests, it only builds the reports. See https://issues.apache.org/jira/browse/SUREFIRE-257 ++ If set to true the failsafe report generation will be skipped. + + + xrefLocation + java.io.File + false + true -+ Creates a nicely formatted Surefire Test Report in html format. This goal does not run the tests, it only builds the reports. This is a workaround for https://issues.apache.org/jira/browse/SUREFIRE-257 ++ Location of the Xrefs to link. + + + + ${aggregate} + ${alwaysGenerateFailsafeReport} -+ ${failsafe.report.description} ++ + ${linkXRef} + ${outputName} + ${showSuccess} + ${skipFailsafeReport} -+ ${failsafe.report.title} + + + @@ -4838,7 +5340,7 @@ + false + false + true -+ org.apache.maven.plugins.surefire.report.HelpMojo ++ org.apache.maven.plugins.maven_surefire_report_plugin.HelpMojo + java + per-lookup + once-per-session @@ -4849,32 +5351,28 @@ + boolean + false + true -+ Display help information on maven-surefire-report-plugin. -+Call mvn surefire-report:help -Ddetail=true -Dgoal=<goal-name> to display parameter details. ++ If true, display all settable properties for each goal. + + + goal + java.lang.String + false + true -+ Display help information on maven-surefire-report-plugin. -+Call mvn surefire-report:help -Ddetail=true -Dgoal=<goal-name> to display parameter details. ++ The name of the goal for which to show help. If unspecified, all goals will be displayed. + + + indentSize + int + false + true -+ Display help information on maven-surefire-report-plugin. -+Call mvn surefire-report:help -Ddetail=true -Dgoal=<goal-name> to display parameter details. ++ The number of spaces per indentation level, should be positive. + + + lineLength + int + false + true -+ Display help information on maven-surefire-report-plugin. -+Call mvn surefire-report:help -Ddetail=true -Dgoal=<goal-name> to display parameter details. ++ The maximum length of a display line, should be positive. + + + @@ -4906,7 +5404,7 @@ + boolean + false + true -+ Creates a nicely formatted Surefire Test Report in html format. This goal does not run the tests, it only builds the reports. This is a workaround for https://issues.apache.org/jira/browse/SUREFIRE-257 ++ Whether to build an aggregated report at the root, or build individual reports. + + + alwaysGenerateSurefireReport @@ -4914,50 +5412,52 @@ + 2.11 + false + true -+ Creates a nicely formatted Surefire Test Report in html format. This goal does not run the tests, it only builds the reports. This is a workaround for https://issues.apache.org/jira/browse/SUREFIRE-257 ++ If set to true the surefire report will be generated even when there are no surefire result files. Defaults to true to preserve legacy behaviour pre 2.10. + + -+ description ++ customBundle + java.lang.String -+ 2.21.0 ++ 3.1.0 + false + true -+ Creates a nicely formatted Surefire Test Report in html format. This goal does not run the tests, it only builds the reports. This is a workaround for https://issues.apache.org/jira/browse/SUREFIRE-257 ++ Path for a custom bundle instead of using the default one. ++Using this field, you could change the texts in the generated reports. + + + linkXRef + boolean + false + true -+ Creates a nicely formatted Surefire Test Report in html format. This goal does not run the tests, it only builds the reports. This is a workaround for https://issues.apache.org/jira/browse/SUREFIRE-257 ++ Whether to link the XRef if found. + + + outputName + java.lang.String + true + true -+ Creates a nicely formatted Surefire Test Report in html format. This goal does not run the tests, it only builds the reports. This is a workaround for https://issues.apache.org/jira/browse/SUREFIRE-257 ++ The filename to use for the report. + + + reportsDirectories + java.io.File[] + false + true -+ Creates a nicely formatted Surefire Test Report in html format. This goal does not run the tests, it only builds the reports. This is a workaround for https://issues.apache.org/jira/browse/SUREFIRE-257 ++ Directories containing the XML Report files that will be parsed and rendered to HTML format. + + + reportsDirectory + java.io.File ++ No reason given + false + true -+ Creates a nicely formatted Surefire Test Report in html format. This goal does not run the tests, it only builds the reports. This is a workaround for https://issues.apache.org/jira/browse/SUREFIRE-257 ++ (Deprecated, use reportsDirectories) This directory contains the XML Report files that will be parsed and rendered to HTML format. + + + showSuccess + boolean + true + true -+ Creates a nicely formatted Surefire Test Report in html format. This goal does not run the tests, it only builds the reports. This is a workaround for https://issues.apache.org/jira/browse/SUREFIRE-257 ++ If set to false, only failures are shown. + + + skipSurefireReport @@ -4965,39 +5465,30 @@ + 2.11 + false + true -+ Creates a nicely formatted Surefire Test Report in html format. This goal does not run the tests, it only builds the reports. This is a workaround for https://issues.apache.org/jira/browse/SUREFIRE-257 -+ -+ -+ title -+ java.lang.String -+ 2.21.0 -+ false -+ true -+ Creates a nicely formatted Surefire Test Report in html format. This goal does not run the tests, it only builds the reports. This is a workaround for https://issues.apache.org/jira/browse/SUREFIRE-257 ++ If set to true the surefire report generation will be skipped. + + + xrefLocation + java.io.File + false + true -+ Creates a nicely formatted Surefire Test Report in html format. This goal does not run the tests, it only builds the reports. This is a workaround for https://issues.apache.org/jira/browse/SUREFIRE-257 ++ Location of the Xrefs to link. + + + + ${aggregate} + ${alwaysGenerateSurefireReport} -+ ${surefire.report.description} ++ + ${linkXRef} + ${outputName} + ${showSuccess} + ${skipSurefireReport} -+ ${surefire.report.title} + + + + + report-only -+ Creates a nicely formatted Surefire Test Report in html format. This goal does not run the tests, it only builds the reports. This is a workaround for https://issues.apache.org/jira/browse/SUREFIRE-257 ++ Creates a nicely formatted Surefire Test Report in html format. This goal does not run the tests, it only builds the reports. This is a workaround for https://issues.apache.org/jira/browse/SUREFIRE-257 <https://issues.apache.org/jira/browse/SUREFIRE-257> + false + true + false @@ -5016,7 +5507,7 @@ + boolean + false + true -+ Creates a nicely formatted Surefire Test Report in html format. This goal does not run the tests, it only builds the reports. This is a workaround for https://issues.apache.org/jira/browse/SUREFIRE-257 ++ Whether to build an aggregated report at the root, or build individual reports. + + + alwaysGenerateSurefireReport @@ -5024,50 +5515,52 @@ + 2.11 + false + true -+ Creates a nicely formatted Surefire Test Report in html format. This goal does not run the tests, it only builds the reports. This is a workaround for https://issues.apache.org/jira/browse/SUREFIRE-257 ++ If set to true the surefire report will be generated even when there are no surefire result files. Defaults to true to preserve legacy behaviour pre 2.10. + + -+ description ++ customBundle + java.lang.String -+ 2.21.0 ++ 3.1.0 + false + true -+ Creates a nicely formatted Surefire Test Report in html format. This goal does not run the tests, it only builds the reports. This is a workaround for https://issues.apache.org/jira/browse/SUREFIRE-257 ++ Path for a custom bundle instead of using the default one. ++Using this field, you could change the texts in the generated reports. + + + linkXRef + boolean + false + true -+ Creates a nicely formatted Surefire Test Report in html format. This goal does not run the tests, it only builds the reports. This is a workaround for https://issues.apache.org/jira/browse/SUREFIRE-257 ++ Whether to link the XRef if found. + + + outputName + java.lang.String + true + true -+ Creates a nicely formatted Surefire Test Report in html format. This goal does not run the tests, it only builds the reports. This is a workaround for https://issues.apache.org/jira/browse/SUREFIRE-257 ++ The filename to use for the report. + + + reportsDirectories + java.io.File[] + false + true -+ Creates a nicely formatted Surefire Test Report in html format. This goal does not run the tests, it only builds the reports. This is a workaround for https://issues.apache.org/jira/browse/SUREFIRE-257 ++ Directories containing the XML Report files that will be parsed and rendered to HTML format. + + + reportsDirectory + java.io.File ++ No reason given + false + true -+ Creates a nicely formatted Surefire Test Report in html format. This goal does not run the tests, it only builds the reports. This is a workaround for https://issues.apache.org/jira/browse/SUREFIRE-257 ++ (Deprecated, use reportsDirectories) This directory contains the XML Report files that will be parsed and rendered to HTML format. + + + showSuccess + boolean + true + true -+ Creates a nicely formatted Surefire Test Report in html format. This goal does not run the tests, it only builds the reports. This is a workaround for https://issues.apache.org/jira/browse/SUREFIRE-257 ++ If set to false, only failures are shown. + + + skipSurefireReport @@ -5075,42 +5568,37 @@ + 2.11 + false + true -+ Creates a nicely formatted Surefire Test Report in html format. This goal does not run the tests, it only builds the reports. This is a workaround for https://issues.apache.org/jira/browse/SUREFIRE-257 -+ -+ -+ title -+ java.lang.String -+ 2.21.0 -+ false -+ true -+ Creates a nicely formatted Surefire Test Report in html format. This goal does not run the tests, it only builds the reports. This is a workaround for https://issues.apache.org/jira/browse/SUREFIRE-257 ++ If set to true the surefire report generation will be skipped. + + + xrefLocation + java.io.File + false + true -+ Creates a nicely formatted Surefire Test Report in html format. This goal does not run the tests, it only builds the reports. This is a workaround for https://issues.apache.org/jira/browse/SUREFIRE-257 ++ Location of the Xrefs to link. + + + + ${aggregate} + ${alwaysGenerateSurefireReport} -+ ${surefire.report.description} ++ + ${linkXRef} + ${outputName} + ${showSuccess} + ${skipSurefireReport} -+ ${surefire.report.title} + + + + + ---- surefire-2.22.0/maven-surefire-report-plugin/src/main/filtered-resources/META-INF/maven/plugin.xml 1970-01-01 01:00:00.000000000 +0100 -+++ surefire-2.22.0/maven-surefire-report-plugin/src/main/filtered-resources/META-INF/maven/plugin.xml 2019-04-01 16:35:39.497479614 +0200 -@@ -0,0 +1,1086 @@ +\ No newline at end of file +--- /dev/null ++++ b/maven-surefire-report-plugin/src/main/filtered-resources/META-INF/maven/plugin.xml +@@ -0,0 +1,838 @@ + ++ ++ ++ + + ${project.name} + ${project.description} @@ -5120,13 +5608,12 @@ + surefire-report + false + true ++ 1.8 ++ 3.2.5 + + + failsafe-report-only -+ Creates a nicely formatted Failsafe Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+See <a href="https://issues.apache.org/jira/browse/SUREFIRE-257"> -+ https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ Creates a nicely formatted Failsafe Test Report in html format. This goal does not run the tests, it only builds the reports. See https://issues.apache.org/jira/browse/SUREFIRE-257 <https://issues.apache.org/jira/browse/SUREFIRE-257> + false + true + false @@ -5145,10 +5632,7 @@ + boolean + false + true -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ Whether to build an aggregated report at the root, or build individual reports. + + + alwaysGenerateFailsafeReport @@ -5156,121 +5640,108 @@ + 2.11 + false + true -+ Creates a nicely formatted Failsafe Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+See <a href="https://issues.apache.org/jira/browse/SUREFIRE-257"> -+ https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ If set to true the failsafe report will be generated even when there are no failsafe result files. Defaults to false to preserve legacy behaviour pre 2.10. + + -+ description ++ customBundle + java.lang.String -+ 2.21.0 ++ 3.1.0 + false + true -+ Creates a nicely formatted Failsafe Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+See <a href="https://issues.apache.org/jira/browse/SUREFIRE-257"> -+ https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ Path for a custom bundle instead of using the default one. ++Using this field, you could change the texts in the generated reports. + + + inputEncoding + java.lang.String + false + false -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ + + + linkXRef + boolean + false + true -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ Whether to link the XRef if found. ++ ++ ++ localRepository ++ org.apache.maven.artifact.repository.ArtifactRepository ++ true ++ false ++ + + + outputDirectory + java.io.File + true + false -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ + + + outputEncoding + java.lang.String + false + false -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ + + + outputName + java.lang.String + true + true -+ Creates a nicely formatted Failsafe Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+See <a href="https://issues.apache.org/jira/browse/SUREFIRE-257"> -+ https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ The filename to use for the report. + + + project + org.apache.maven.project.MavenProject + true + false -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ + + + reactorProjects + java.util.List + false + false -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ The projects in the reactor for aggregation report. ++ ++ ++ remoteRepositories ++ java.util.List ++ true ++ false ++ + + + reportsDirectories + java.io.File[] + false + true -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ Directories containing the XML Report files that will be parsed and rendered to HTML format. + + + reportsDirectory + java.io.File ++ No reason given + false + true -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ (Deprecated, use reportsDirectories) This directory contains the XML Report files that will be parsed and rendered to HTML format. ++ ++ ++ settings ++ org.apache.maven.settings.Settings ++ true ++ false ++ The current user system settings for use in Maven. + + + showSuccess + boolean + true + true -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ If set to false, only failures are shown. + + + skipFailsafeReport @@ -5278,67 +5749,60 @@ + 2.11 + false + true -+ Creates a nicely formatted Failsafe Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+See <a href="https://issues.apache.org/jira/browse/SUREFIRE-257"> -+ https://issues.apache.org/jira/browse/SUREFIRE-257</a> -+ -+ -+ title -+ java.lang.String -+ 2.21.0 -+ false -+ true -+ Creates a nicely formatted Failsafe Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+See <a href="https://issues.apache.org/jira/browse/SUREFIRE-257"> -+ https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ If set to true the failsafe report generation will be skipped. + + + xrefLocation + java.io.File + false + true -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ Location of the Xrefs to link. + + + + ${aggregate} + ${alwaysGenerateFailsafeReport} -+ ${failsafe.report.description} ++ + ${encoding} + ${linkXRef} ++ + + ${outputEncoding} + ${outputName} + + ++ ++ + ${showSuccess} + ${skipFailsafeReport} -+ ${failsafe.report.title} + + + + ++ org.codehaus.plexus.i18n.I18N ++ i18n ++ ++ + org.apache.maven.doxia.siterenderer.Renderer + siteRenderer + ++ ++ org.apache.maven.doxia.tools.SiteTool ++ siteTool ++ + + + + help -+ Display help information on maven-surefire-report-plugin.<br> -+Call <code>mvn surefire-report:help -Ddetail=true -Dgoal=&lt;goal-name&gt;</code> to display parameter details. ++ Display help information on maven-surefire-report-plugin. ++Call mvn surefire-report:help -Ddetail=true -Dgoal=<goal-name> to display parameter details. + false + false + false + false + false + true -+ org.apache.maven.plugins.surefire.report.HelpMojo ++ org.apache.maven.plugins.maven_surefire_report_plugin.HelpMojo + java + per-lookup + once-per-session @@ -5349,32 +5813,28 @@ + boolean + false + true -+ Display help information on maven-surefire-report-plugin.<br> -+Call <code>mvn surefire-report:help -Ddetail=true -Dgoal=&lt;goal-name&gt;</code> to display parameter details. ++ If true, display all settable properties for each goal. + + + goal + java.lang.String + false + true -+ Display help information on maven-surefire-report-plugin.<br> -+Call <code>mvn surefire-report:help -Ddetail=true -Dgoal=&lt;goal-name&gt;</code> to display parameter details. ++ The name of the goal for which to show help. If unspecified, all goals will be displayed. + + + indentSize + int + false + true -+ Display help information on maven-surefire-report-plugin.<br> -+Call <code>mvn surefire-report:help -Ddetail=true -Dgoal=&lt;goal-name&gt;</code> to display parameter details. ++ The number of spaces per indentation level, should be positive. + + + lineLength + int + false + true -+ Display help information on maven-surefire-report-plugin.<br> -+Call <code>mvn surefire-report:help -Ddetail=true -Dgoal=&lt;goal-name&gt;</code> to display parameter details. ++ The maximum length of a display line, should be positive. + + + @@ -5406,10 +5866,7 @@ + boolean + false + true -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ Whether to build an aggregated report at the root, or build individual reports. + + + alwaysGenerateSurefireReport @@ -5417,121 +5874,108 @@ + 2.11 + false + true -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ If set to true the surefire report will be generated even when there are no surefire result files. Defaults to true to preserve legacy behaviour pre 2.10. + + -+ description ++ customBundle + java.lang.String -+ 2.21.0 ++ 3.1.0 + false + true -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ Path for a custom bundle instead of using the default one. ++Using this field, you could change the texts in the generated reports. + + + inputEncoding + java.lang.String + false + false -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ + + + linkXRef + boolean + false + true -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ Whether to link the XRef if found. ++ ++ ++ localRepository ++ org.apache.maven.artifact.repository.ArtifactRepository ++ true ++ false ++ + + + outputDirectory + java.io.File + true + false -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ + + + outputEncoding + java.lang.String + false + false -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ + + + outputName + java.lang.String + true + true -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ The filename to use for the report. + + + project + org.apache.maven.project.MavenProject + true + false -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ + + + reactorProjects + java.util.List + false + false -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ The projects in the reactor for aggregation report. ++ ++ ++ remoteRepositories ++ java.util.List ++ true ++ false ++ + + + reportsDirectories + java.io.File[] + false + true -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ Directories containing the XML Report files that will be parsed and rendered to HTML format. + + + reportsDirectory + java.io.File ++ No reason given + false + true -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ (Deprecated, use reportsDirectories) This directory contains the XML Report files that will be parsed and rendered to HTML format. ++ ++ ++ settings ++ org.apache.maven.settings.Settings ++ true ++ false ++ The current user system settings for use in Maven. + + + showSuccess + boolean + true + true -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ If set to false, only failures are shown. + + + skipSurefireReport @@ -5539,62 +5983,52 @@ + 2.11 + false + true -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> -+ -+ -+ title -+ java.lang.String -+ 2.21.0 -+ false -+ true -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ If set to true the surefire report generation will be skipped. + + + xrefLocation + java.io.File + false + true -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ Location of the Xrefs to link. + + + + ${aggregate} + ${alwaysGenerateSurefireReport} -+ ${surefire.report.description} ++ + ${encoding} + ${linkXRef} ++ + + ${outputEncoding} + ${outputName} + + ++ ++ + ${showSuccess} + ${skipSurefireReport} -+ ${surefire.report.title} + + + + ++ org.codehaus.plexus.i18n.I18N ++ i18n ++ ++ + org.apache.maven.doxia.siterenderer.Renderer + siteRenderer + ++ ++ org.apache.maven.doxia.tools.SiteTool ++ siteTool ++ + + + + report-only -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ Creates a nicely formatted Surefire Test Report in html format. This goal does not run the tests, it only builds the reports. This is a workaround for https://issues.apache.org/jira/browse/SUREFIRE-257 <https://issues.apache.org/jira/browse/SUREFIRE-257> + false + true + false @@ -5613,10 +6047,7 @@ + boolean + false + true -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ Whether to build an aggregated report at the root, or build individual reports. + + + alwaysGenerateSurefireReport @@ -5624,121 +6055,108 @@ + 2.11 + false + true -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ If set to true the surefire report will be generated even when there are no surefire result files. Defaults to true to preserve legacy behaviour pre 2.10. + + -+ description ++ customBundle + java.lang.String -+ 2.21.0 ++ 3.1.0 + false + true -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ Path for a custom bundle instead of using the default one. ++Using this field, you could change the texts in the generated reports. + + + inputEncoding + java.lang.String + false + false -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ + + + linkXRef + boolean + false + true -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ Whether to link the XRef if found. ++ ++ ++ localRepository ++ org.apache.maven.artifact.repository.ArtifactRepository ++ true ++ false ++ + + + outputDirectory + java.io.File + true + false -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ + + + outputEncoding + java.lang.String + false + false -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ + + + outputName + java.lang.String + true + true -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ The filename to use for the report. + + + project + org.apache.maven.project.MavenProject + true + false -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ + + + reactorProjects + java.util.List + false + false -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ The projects in the reactor for aggregation report. ++ ++ ++ remoteRepositories ++ java.util.List ++ true ++ false ++ + + + reportsDirectories + java.io.File[] + false + true -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ Directories containing the XML Report files that will be parsed and rendered to HTML format. + + + reportsDirectory + java.io.File ++ No reason given + false + true -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ (Deprecated, use reportsDirectories) This directory contains the XML Report files that will be parsed and rendered to HTML format. ++ ++ ++ settings ++ org.apache.maven.settings.Settings ++ true ++ false ++ The current user system settings for use in Maven. + + + showSuccess + boolean + true + true -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ If set to false, only failures are shown. + + + skipSurefireReport @@ -5746,399 +6164,134 @@ + 2.11 + false + true -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> -+ -+ -+ title -+ java.lang.String -+ 2.21.0 -+ false -+ true -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ If set to true the surefire report generation will be skipped. + + + xrefLocation + java.io.File + false + true -+ Creates a nicely formatted Surefire Test Report in html format. -+This goal does not run the tests, it only builds the reports. -+This is a workaround for -+<a href="https://issues.apache.org/jira/browse/SUREFIRE-257">https://issues.apache.org/jira/browse/SUREFIRE-257</a> ++ Location of the Xrefs to link. + + + + ${aggregate} + ${alwaysGenerateSurefireReport} -+ ${surefire.report.description} ++ + ${encoding} + ${linkXRef} ++ + + ${outputEncoding} + ${outputName} + + ++ ++ + ${showSuccess} + ${skipSurefireReport} -+ ${surefire.report.title} + + + + ++ org.codehaus.plexus.i18n.I18N ++ i18n ++ ++ + org.apache.maven.doxia.siterenderer.Renderer + siteRenderer + ++ ++ org.apache.maven.doxia.tools.SiteTool ++ siteTool ++ + + + + + -+ org.apache.maven -+ maven-model -+ jar -+ 3.3.3 -+ -+ -+ org.apache.commons -+ commons-lang3 -+ jar -+ 3.5 -+ -+ -+ org.apache.maven -+ maven-plugin-api -+ jar -+ 3.3.3 -+ -+ -+ org.codehaus.plexus -+ plexus-classworlds -+ jar -+ 2.5.2 -+ -+ -+ org.apache.maven -+ maven-artifact -+ jar -+ 3.3.3 -+ -+ -+ org.eclipse.sisu -+ org.eclipse.sisu.plexus -+ jar -+ 0.3.3 -+ -+ -+ org.eclipse.sisu -+ org.eclipse.sisu.inject -+ jar -+ 0.3.3 -+ -+ -+ javax.enterprise -+ cdi-api -+ jar -+ 1.1 -+ -+ -+ javax.el -+ javax.el-api -+ jar -+ 3.0.0 -+ -+ -+ org.jboss.spec.javax.interceptor -+ jboss-interceptors-api_1.2_spec -+ jar -+ any -+ -+ -+ org.apache.maven.plugin-tools -+ maven-plugin-annotations -+ jar -+ 3.5 -+ -+ -+ org.apache.maven -+ maven-compat -+ jar -+ any -+ -+ -+ org.apache.maven -+ maven-settings -+ jar -+ 3.3.3 -+ -+ -+ org.apache.maven -+ maven-model-builder -+ jar -+ 3.5.4 -+ -+ -+ org.apache.maven -+ maven-repository-metadata -+ jar -+ 3.5.4 -+ -+ -+ org.codehaus.plexus -+ plexus-interpolation -+ jar -+ 1.24 -+ -+ -+ org.apache.maven.wagon -+ wagon-provider-api -+ jar -+ 3.1.0 -+ -+ -+ org.apache.maven -+ maven-resolver-provider -+ jar -+ 3.5.4 -+ -+ -+ org.apache.maven.resolver -+ maven-resolver-api -+ jar -+ 1.1.1 -+ -+ -+ org.apache.maven.resolver -+ maven-resolver-util -+ jar -+ 1.1.1 -+ -+ -+ org.apache.maven.resolver -+ maven-resolver-impl -+ jar -+ 1.1.1 -+ -+ -+ org.slf4j -+ slf4j-api -+ jar -+ 1.7.25 -+ -+ -+ org.apache.maven -+ maven-settings-builder -+ jar -+ 3.5.4 -+ -+ -+ org.sonatype.plexus -+ plexus-sec-dispatcher -+ jar -+ 1.4 -+ -+ -+ org.sonatype.plexus -+ plexus-cipher -+ jar -+ 1.4 -+ -+ -+ junit -+ junit -+ jar -+ 4.12 -+ -+ -+ org.hamcrest -+ hamcrest-core -+ jar -+ 1.3 -+ -+ + org.apache.maven.surefire + surefire-report-parser + jar -+ 2.22.0 ++ 3.2.5 + + + org.apache.maven.surefire + surefire-logger-api + jar -+ 2.22.0 -+ -+ -+ org.apache.maven.reporting -+ maven-reporting-api -+ jar -+ 3.0 -+ -+ -+ org.apache.maven.reporting -+ maven-reporting-impl -+ jar -+ 2.4 -+ -+ -+ org.apache.maven.doxia -+ doxia-decoration-model -+ jar -+ 1.7.4 -+ -+ -+ org.apache.maven -+ maven-core -+ jar -+ 3.3.3 -+ -+ -+ com.google.guava -+ guava -+ jar -+ 20.0 -+ -+ -+ com.google.inject -+ guice -+ jar -+ 4.2.0 -+ -+ -+ aopalliance -+ aopalliance -+ jar -+ 1.0 -+ -+ -+ cglib -+ cglib -+ jar -+ 3.2.0 -+ -+ -+ javax.inject -+ javax.inject -+ jar -+ 1 -+ -+ -+ org.apache.maven.resolver -+ maven-resolver-spi -+ jar -+ 1.1.1 -+ -+ -+ org.apache.maven -+ maven-builder-support -+ jar -+ 3.5.4 -+ -+ -+ org.apache.maven.doxia -+ doxia-core -+ jar -+ 1.7 -+ -+ -+ xmlunit -+ xmlunit -+ jar -+ 1.5 -+ -+ -+ commons-lang -+ commons-lang -+ jar -+ 2.4 -+ -+ -+ org.apache.httpcomponents -+ httpclient -+ jar -+ 4.0.2 -+ -+ -+ commons-logging -+ commons-logging -+ jar -+ SYSTEM -+ -+ -+ commons-codec -+ commons-codec -+ jar -+ SYSTEM -+ -+ -+ org.apache.httpcomponents -+ httpcore -+ jar -+ 4.0.1 ++ 3.2.5 + + + org.apache.maven.shared + maven-shared-utils + jar -+ 3.2.1 ++ 3.3.4 + + + commons-io + commons-io + jar -+ 2.5 ++ 2.15.1 ++ ++ ++ org.codehaus.plexus ++ plexus-classworlds ++ jar ++ 2.7.0 ++ ++ ++ org.codehaus.plexus ++ plexus-component-annotations ++ jar ++ 2.1.0 ++ ++ ++ org.apache.commons ++ commons-lang3 ++ jar ++ 3.14.0 ++ ++ ++ org.codehaus.plexus ++ plexus-interpolation ++ jar ++ 1.26 ++ ++ ++ org.codehaus.plexus ++ plexus-utils ++ jar ++ 4.0.0 + + + org.apache.maven.doxia + doxia-sink-api + jar -+ 1.7 -+ -+ -+ org.apache.maven.doxia -+ doxia-site-renderer -+ jar -+ 1.6 ++ 1.12.0 + + + org.apache.maven.doxia + doxia-logging-api + jar -+ 1.7 -+ -+ -+ commons-collections -+ commons-collections -+ jar -+ 3.2.1 -+ -+ -+ org.codehaus.plexus -+ plexus-velocity -+ jar -+ 1.2 -+ -+ -+ org.codehaus.plexus -+ plexus-i18n -+ jar -+ 1.0-beta-7 ++ 1.12.0 + + + org.apache.maven.doxia -+ doxia-module-xhtml ++ doxia-core + jar -+ 1.7 ++ 1.12.0 + + + org.codehaus.plexus + plexus-container-default + jar -+ 1.0-alpha-30 ++ 2.1.0 ++ ++ ++ org.ow2.asm ++ asm ++ jar ++ 5.0.3 + + + org.ow2.asm @@ -6150,19 +6303,7 @@ + org.ow2.asm + asm-tree + jar -+ 6.2.1 -+ -+ -+ org.ow2.asm -+ asm-analysis -+ jar -+ 6.2.1 -+ -+ -+ org.ow2.asm -+ asm -+ jar -+ 5.0.3 ++ 9.6 + + + org.apache.xbean @@ -6171,36 +6312,132 @@ + 3.7 + + ++ junit ++ junit ++ jar ++ 4.13.2 ++ ++ ++ org.hamcrest ++ hamcrest-core ++ jar ++ 1.3 ++ ++ ++ org.apache.commons ++ commons-text ++ jar ++ 1.3 ++ ++ ++ org.apache.httpcomponents ++ httpclient ++ jar ++ 4.5.13 ++ ++ ++ commons-logging ++ commons-logging ++ jar ++ 1.2 ++ ++ ++ commons-codec ++ commons-codec ++ jar ++ 1.11 ++ ++ ++ org.apache.httpcomponents ++ httpcore ++ jar ++ 4.4.14 ++ ++ ++ org.apache.maven.reporting ++ maven-reporting-api ++ jar ++ 3.1.1 ++ ++ ++ org.apache.maven.reporting ++ maven-reporting-impl ++ jar ++ 3.2.0 ++ ++ ++ org.apache.maven.doxia ++ doxia-site-renderer ++ jar ++ 1.11.1 ++ ++ ++ commons-collections ++ commons-collections ++ jar ++ 3.2.2 ++ ++ ++ org.apache.maven.doxia ++ doxia-skin-model ++ jar ++ 1.11.1 ++ ++ ++ org.apache.maven.doxia ++ doxia-module-xhtml5 ++ jar ++ 1.11.1 ++ ++ ++ org.codehaus.plexus ++ plexus-i18n ++ jar ++ 1.0-beta-10 ++ ++ ++ org.codehaus.plexus ++ plexus-velocity ++ jar ++ 1.2 ++ ++ ++ org.apache.maven.doxia ++ doxia-module-xhtml ++ jar ++ 1.11.1 ++ ++ + org.apache.velocity + velocity + jar + 1.7 + + -+ org.codehaus.plexus -+ plexus-component-annotations ++ org.apache.maven.doxia ++ doxia-decoration-model + jar -+ 1.5.5 ++ 1.11.1 + + + org.apache.maven.doxia -+ doxia-skin-model ++ doxia-integration-tools + jar -+ 1.7.5 ++ 1.11.1 + + + org.codehaus.plexus -+ plexus-utils ++ plexus-xml + jar -+ 3.0.15 ++ 4.0.0 + + + ---- surefire-2.22.0/maven-surefire-report-plugin/src/main/java/org/apache/maven/plugins/surefire/report/HelpMojo.java 1970-01-01 01:00:00.000000000 +0100 -+++ surefire-2.22.0/maven-surefire-report-plugin/src/main/java/org/apache/maven/plugins/surefire/report/HelpMojo.java 2019-04-01 16:38:38.246383508 +0200 -@@ -0,0 +1,458 @@ -+ -+package org.apache.maven.plugins.surefire.report; +\ No newline at end of file +--- /dev/null ++++ b/maven-surefire-report-plugin/src/main/java/org/apache/maven/plugin/maven_surefire_report_plugin/HelpMojo.java +@@ -0,0 +1,448 @@ ++package org.apache.maven.plugins.maven_surefire_report_plugin; + +import org.apache.maven.plugin.AbstractMojo; +import org.apache.maven.plugin.MojoExecutionException; @@ -6258,7 +6495,7 @@ + @Parameter( property = "indentSize", defaultValue = "2" ) + private int indentSize; + -+ // groupId/artifactId/plugin-help.xml ++ // /META-INF/maven///plugin-help.xml + private static final String PLUGIN_HELP_PATH = + "/META-INF/maven/org.apache.maven.plugins/maven-surefire-report-plugin/plugin-help.xml"; + @@ -6268,10 +6505,12 @@ + throws MojoExecutionException + { + getLog().debug( "load plugin-help.xml: " + PLUGIN_HELP_PATH ); -+ InputStream is = null; -+ try ++ try ( InputStream is = getClass().getResourceAsStream( PLUGIN_HELP_PATH ) ) + { -+ is = getClass().getResourceAsStream( PLUGIN_HELP_PATH ); ++ if ( is == null ) ++ { ++ throw new MojoExecutionException( "Could not find plugin descriptor at " + PLUGIN_HELP_PATH ); ++ } + DocumentBuilderFactory dbFactory = DocumentBuilderFactory.newInstance(); + DocumentBuilder dBuilder = dbFactory.newDocumentBuilder(); + return dBuilder.parse( is ); @@ -6288,25 +6527,12 @@ + { + throw new MojoExecutionException( e.getMessage(), e ); + } -+ finally -+ { -+ if ( is != null ) -+ { -+ try -+ { -+ is.close(); -+ } -+ catch ( IOException e ) -+ { -+ throw new MojoExecutionException( e.getMessage(), e ); -+ } -+ } -+ } + } + + /** + * {@inheritDoc} + */ ++ @Override + public void execute() + throws MojoExecutionException + { @@ -6378,13 +6604,13 @@ + return string != null && string.length() > 0; + } + -+ private String getValue( Node node, String elementName ) ++ private static String getValue( Node node, String elementName ) + throws MojoExecutionException + { + return getSingleChild( node, elementName ).getTextContent(); + } + -+ private Node getSingleChild( Node node, String elementName ) ++ private static Node getSingleChild( Node node, String elementName ) + throws MojoExecutionException + { + List namedChild = findNamedChild( node, elementName ); @@ -6399,7 +6625,7 @@ + return namedChild.get( 0 ); + } + -+ private List findNamedChild( Node node, String elementName ) ++ private static List findNamedChild( Node node, String elementName ) + { + List result = new ArrayList(); + NodeList childNodes = node.getChildNodes(); @@ -6414,7 +6640,7 @@ + return result; + } + -+ private Node findSingleChild( Node node, String elementName ) ++ private static Node findSingleChild( Node node, String elementName ) + throws MojoExecutionException + { + List elementsByTagName = findNamedChild( node, elementName ); @@ -6493,7 +6719,9 @@ + append( sb, "Deprecated. " + deprecated.getTextContent(), 3 ); + append( sb, "", 0 ); + } -+ append( sb, parameterDescription, 3 ); ++ if ( isNotEmpty( parameterDescription ) ) { ++ append( sb, parameterDescription, 3 ); ++ } + if ( "true".equals( getValue( parameter, "required" ) ) ) + { + append( sb, "Required: Yes", 3 ); @@ -6644,8 +6872,8 @@ + } + return level; + } -+ -+ private String getPropertyFromExpression( String expression ) ++ ++ private static String getPropertyFromExpression( String expression ) + { + if ( expression != null && expression.startsWith( "${" ) && expression.endsWith( "}" ) + && !expression.substring( 2 ).contains( "${" ) ) @@ -6657,3 +6885,6 @@ + return null; + } +} +-- +2.44.0 + diff --git a/maven-surefire-build.tar.xz b/maven-surefire-build.tar.xz index 07e916e..c1800c3 100644 --- a/maven-surefire-build.tar.xz +++ b/maven-surefire-build.tar.xz @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:3b72fc5689f053e54a6f1a61af232329730439e7b2bc394438d3febc2ad03eb0 -size 5604 +oid sha256:06899d4b2f60be3857b8a650c5a865537ef14594091ff63e6edb73719b649c64 +size 7236 diff --git a/maven-surefire-plugins.changes b/maven-surefire-plugins.changes index 8421aaa..1e787af 100644 --- a/maven-surefire-plugins.changes +++ b/maven-surefire-plugins.changes @@ -1,3 +1,154 @@ +------------------------------------------------------------------- +Wed Apr 10 10:54:02 UTC 2024 - Fridrich Strba + +- Upgrade to 3.2.5 + * Bug + + SUREFIRE-2223: Surefire evaluates parameter jvm before skip + + SUREFIRE-2224: StatelessXmlReporter#getTestProblems() does + not properly reflect report schema structure + + SUREFIRE-2225: Surefire ITs fail when project directory + contains space + + SUREFIRE-2229: + REGRESSION] SUREFIRE-2224 causes stack trace + to be omitted for errors and failures + + SUREFIRE-2231: JaCoCo 0.8.11 fails with old TestNG releases on + Java 17+ + * Improvement + + SUREFIRE-1345: Support flakyFailure and flakyError in + TestSuiteXmlParser + + SUREFIRE-2221: Document minimum supported Java version for + Toolchains +- Upgrade to 3.2.3 + * Bug + + SUREFIRE-2210: Additional class path ordering broken since + 3.2.0 + + SUREFIRE-2211: additionalClasspathElement with UNC path not + working with Maven Failsafe Plugin + + SUREFIRE-2212: OutOfMemoryError raised when parsing files with + huge stderr/stdout output in surefire-report-parser + + SUREFIRE-2220: + SurefireForkChannel#getForkNodeConnectionString() returns + invalid URI string if localHost resolves to IPv6 address + * Dependency upgrade + + SUREFIRE-2214: Upgrade to HtmlUnit 3.8.0 + + SUREFIRE-2215: Upgrade to Parent 41 + + SUREFIRE-2216: Upgrade plugins and components (in ITs) +- Upgrade to 3.2.2 + * Bug Fixes + + SUREFIRE-2205: Use maven-plugin-report-plugin only in plugins + modules + + SUREFIRE-2206: Downgrade plexus-xml to 3.0.0 + * Dependency updates + + SUREFIRE-2208: Bump org.codehaus.plexus:plexus-java from 1.1.2 + to 1.2.0 +- Upgrade to 3.2.1 + * New features and improvements + + SUREFIRE-1124: Support forkNumber in environment variables + + SUREFIRE-2177: Use junit-bom instead of single JUnit 5 + versions + + SUREFIRE-2179: Support adding additional Maven dependencies to + the test runtime classpath + + SUREFIRE-2178: clarify classpathDependencyExcludes + + SUREFIRE-2182: Log starter implementation on DEBUG level + * Bug Fixes + + SUREFIRE-2190: Fix module dependencies for compile only + dependencies + * Documentation updates + + Fix TestNG web site URL (#671) @sabi0 +- Upgrade to 3.1.2 + * Changes + + SUREFIRE-2166: Use ChoiceFormat to selective render percentage + and elapsed time in SurefireReportRenderer + + Simplify serialization/deserialization of elapsed time + (SUREFIRE-2164 + SUREFIRE-2167) + + SUREFIRE-2169: Potential NPE in WrappedReportEntry when + #getElapsed() is called + + MNG-6829: Replace StringUtils#isEmpty(String) and + #isNotEmpty(String) +- Upgrade to 3.1.0 + * Sub-task + + SUREFIRE-2162: Document upcoming mojo and file names change + * Bug + + SUREFIRE-2140: Cannot release Surefire on Windows + * Improvement + + SUREFIRE-2153: Replace SurefireReportGenerator with a new + SurefireReportRenderer + + SUREFIRE-2160: Replace LocalizedProperties with (Custom)I18N + approach from MPIR + * Task + + SUREFIRE-2130: Rewrite several test classes in report + plugin for upcoming Doxia 2.0.0 stack +- Upgrade to 3.0.0 + * New features and improvements + + SUREFIRE-2154: Get rid of localRepository from surefire + mojo parameter, use Resolver API + * Bug Fixes + + SUREFIRE-2119: Sanitize failIfNoSpecifiedTests prefix in + failsafe + + SUREFIRE-2143: Fix reporting of skipped parameterized test + * Documentation updates + + SUREFIRE-2156: Refresh download page +- Modifed patch: + * 0003-Port-to-TestNG-7.4.0.patch -> 0001-Port-to-TestNG-7.4.0.patch + + regenerate + * maven-surefire-bootstrap-resources.patch + + regenerate from maven build +- Removed patches: + * 0001-Maven-3.patch + * 0002-Port-to-current-doxia.patch + * 0004-Port-to-current-maven-shared-utils.patch + + not needed with this version + +------------------------------------------------------------------- +Thu Feb 22 07:58:37 UTC 2024 - Fridrich Strba + +- Upgrade to 2.22.2 + * Bugs: + + SUREFIRE-1614: JUnit Runner that writes to System.out + corrupts Surefire’s STDOUT when using JUnit’s Vintage Engine +- Upgrade to 2.22.1 + * Bugs: + + SUREFIRE-1532: MIME type for javascript is now officially + application/javascript + + SUREFIRE-1535: Surefire unable to run testng suites in + parallel + + SUREFIRE-1538: Git considers PNG files as changed although + there is no change + + SUREFIRE-1550: The surefire XSD published on maven site lacks + of some rerun element + + SUREFIRE-1559: XML Report elements rerunError, rerunFailure, + flakyFailure, flakyError should contain element stackTrace and + should not be simpleContent. + + SUREFIRE-1561: Logs in Parallel Tests are mixed up when + forkMode=never or forkCount=0 + + SUREFIRE-1564: Can’t override platform version through + project/plugin dependencies + + SUREFIRE-1579: Forks mixed up characters in standard output + * Improvements: + + SUREFIRE-1552: Nil element “failureMessage” in + failsafe-summary.xml should have self closed tag + + SUREFIRE-1554: Fix old test resources TEST-*.xml in favor of + continuing with SUREFIRE-1550 + + SUREFIRE-1555: Elapsed time in XML Report should satisfy + pattern in XSD. + + SUREFIRE-1562: Support Java 11 + + SUREFIRE-1565: Surefire should support parameterized + reportsDirectory + * Tasks: + + SUREFIRE-1569: m-invoker-p:3.1.0 attempts to resolve + maven-surefire-common:jar:2.22.1-SNAPSHOT from remote repo + 'apache.snapshots' + + SUREFIRE-1578: Remove obsolete module + surefire-setup-integration-tests + * Dependency upgrades: + + SUREFIRE-1540: Upgrade maven-plugins parent to version 32 + + SUREFIRE-1571: Upgrade maven-plugins parent to version 33 +- Fetch sources using source service to avoid bundling binaries in + sources +- Fix broken links in the spec file +- Modified patch: + * 0004-Port-to-current-maven-shared-utils.patch + + rediff to changed context + ------------------------------------------------------------------- Thu May 5 10:46:11 UTC 2022 - Fridrich Strba diff --git a/maven-surefire-plugins.spec b/maven-surefire-plugins.spec index deaae85..c6b04ed 100644 --- a/maven-surefire-plugins.spec +++ b/maven-surefire-plugins.spec @@ -1,7 +1,7 @@ # -# spec file +# spec file for package maven-surefire-plugins # -# Copyright (c) 2023 SUSE LLC +# Copyright (c) 2024 SUSE LLC # # All modifications and additions to the file contributed by third parties # remain the property of their copyright owners, unless otherwise agreed @@ -18,42 +18,35 @@ %global base_name maven-surefire Name: %{base_name}-plugins -Version: 2.22.0 +Version: 3.2.5 Release: 0 Summary: Test framework project License: Apache-2.0 AND CPL-1.0 Group: Development/Libraries/Java URL: https://maven.apache.org/surefire/ -# ./generate-tarball.sh -Source0: %{base_name}-%{version}.tar.gz -# Remove bundled binaries which cannot be easily verified for licensing -Source1: generate-tarball.sh -Source2: http://junit.sourceforge.net/cpl-v10.html -Patch0: 0001-Maven-3.patch -Patch1: 0002-Port-to-current-doxia.patch -Patch2: 0003-Port-to-TestNG-7.4.0.patch -Patch3: 0004-Port-to-current-maven-shared-utils.patch +Source0: %{base_name}-%{version}.tar.xz +Source1: https://www.apache.org/licenses/LICENSE-2.0.txt +Source2: https://www.eclipse.org/legal/cpl-v10.html +Patch0: 0001-Port-to-TestNG-7.4.0.patch BuildRequires: fdupes BuildRequires: java-devel >= 1.8 BuildRequires: maven-local -BuildRequires: mvn(commons-io:commons-io) -BuildRequires: mvn(org.apache.commons:commons-lang3) -BuildRequires: mvn(org.apache.maven.doxia:doxia-site-renderer) +BuildRequires: mvn(org.apache.maven.doxia:doxia-core) +BuildRequires: mvn(org.apache.maven.doxia:doxia-sink-api) BuildRequires: mvn(org.apache.maven.plugin-tools:maven-plugin-annotations) BuildRequires: mvn(org.apache.maven.plugins:maven-plugin-plugin) +BuildRequires: mvn(org.apache.maven.reporting:maven-reporting-api) BuildRequires: mvn(org.apache.maven.reporting:maven-reporting-impl) -BuildRequires: mvn(org.apache.maven.shared:maven-shared-utils) BuildRequires: mvn(org.apache.maven.surefire:maven-surefire-common) -BuildRequires: mvn(org.apache.maven.surefire:surefire-logger-api) BuildRequires: mvn(org.apache.maven.surefire:surefire-report-parser) +BuildRequires: mvn(org.apache.maven:maven-core) BuildRequires: mvn(org.apache.maven:maven-model) BuildRequires: mvn(org.apache.maven:maven-parent:pom:) BuildRequires: mvn(org.apache.maven:maven-plugin-api) -BuildRequires: mvn(org.codehaus.plexus:plexus-utils) +BuildRequires: mvn(org.codehaus.plexus:plexus-xml) BuildRequires: mvn(org.fusesource.jansi:jansi) #!BuildRequires: maven-compiler-plugin-bootstrap #!BuildRequires: maven-jar-plugin-bootstrap -#!BuildRequires: maven-javadoc-plugin-bootstrap #!BuildRequires: maven-plugin-plugin-bootstrap #!BuildRequires: maven-resources-plugin-bootstrap #!BuildRequires: maven-surefire-plugin-bootstrap @@ -105,64 +98,52 @@ Group: Development/Libraries/Java Javadoc for %{name}. %prep -%setup -q -n surefire-%{version} -cp -p %{SOURCE2} . +%setup -q -n %{base_name}-%{version} +cp -p %{SOURCE1} %{SOURCE2} . -%patch0 -p1 -%patch1 -p1 -%patch2 -p1 -%patch3 -p1 +%patch -P 0 -p1 +#patch -P 1 -p1 # Disable strict doclint sed -i /-Xdoclint:all/d pom.xml +%pom_remove_dep org.junit:junit-bom + +%pom_disable_module surefire-shadefire %pom_remove_dep -r org.apache.maven.surefire:surefire-shadefire # Help plugin is needed only to evaluate effective Maven settings. # For building RPM package default settings will suffice. -%pom_remove_plugin :maven-help-plugin surefire-setup-integration-tests +%pom_remove_plugin :maven-help-plugin surefire-its # QA plugin useful only for upstream %pom_remove_plugin -r :jacoco-maven-plugin +# Not wanted +%pom_remove_plugin -r :maven-shade-plugin -# Not in Fedora +find -name *.java -exec sed -i -e s/org.apache.maven.surefire.shared.utils/org.apache.maven.shared.utils/ -e s/org.apache.maven.surefire.shared.io/org.apache.commons.io/ -e s/org.apache.maven.surefire.shared.lang3/org.apache.commons.lang3/ -e s/org.apache.maven.surefire.shared.compress/org.apache.commons.compress/ {} \; + +# Not packaged %pom_remove_plugin -r :animal-sniffer-maven-plugin # Complains %pom_remove_plugin -r :apache-rat-plugin -%pom_remove_plugin -r :maven-enforcer-plugin # We don't need site-source %pom_remove_plugin :maven-assembly-plugin maven-surefire-plugin %pom_remove_dep -r ::::site-source -%pom_xpath_set pom:mavenVersion 3.3.3 -%pom_remove_dep :maven-project maven-surefire-report-plugin -%pom_remove_dep :maven-project maven-surefire-common -%pom_remove_dep :maven-plugin-descriptor maven-surefire-common -%pom_remove_dep :maven-toolchain maven-surefire-common - -%pom_xpath_remove -r "pom:execution[pom:id='shared-logging-generated-sources']" - -%pom_add_dep com.google.code.findbugs:jsr305 surefire-api - -%pom_remove_plugin -r :maven-shade-plugin -%pom_remove_plugin -r :build-helper-maven-plugin -find . -name dependency-reduced-pom.xml -delete - -%pom_add_dep org.apache.commons:commons-lang3::runtime maven-surefire-plugin -%pom_add_dep commons-io:commons-io::runtime maven-surefire-plugin - # Disable all modules besides the 3 plugins for module in \ - surefire-logger-api \ - surefire-api \ - surefire-shadefire \ - surefire-booter \ - surefire-grouper \ - surefire-providers \ maven-surefire-common \ - surefire-report-parser \ - surefire-setup-integration-tests \ - surefire-its; do + surefire-api \ + surefire-booter \ + surefire-extensions-api \ + surefire-extensions-spi \ + surefire-grouper \ + surefire-its \ + surefire-logger-api \ + surefire-providers \ + surefire-shared-utils \ + surefire-report-parser; do %pom_disable_module ${module} done @@ -190,6 +171,6 @@ done %files -n maven-failsafe-plugin -f .mfiles-failsafe-plugin %files javadoc -f .mfiles-javadoc -%license LICENSE NOTICE cpl-v10.html +%license LICENSE-2.0.txt cpl-v10.html %changelog diff --git a/maven-surefire-provider-junit5.changes b/maven-surefire-provider-junit5.changes index f64be81..26f2abd 100644 --- a/maven-surefire-provider-junit5.changes +++ b/maven-surefire-provider-junit5.changes @@ -1,3 +1,154 @@ +------------------------------------------------------------------- +Wed Apr 10 10:54:02 UTC 2024 - Fridrich Strba + +- Upgrade to 3.2.5 + * Bug + + SUREFIRE-2223: Surefire evaluates parameter jvm before skip + + SUREFIRE-2224: StatelessXmlReporter#getTestProblems() does + not properly reflect report schema structure + + SUREFIRE-2225: Surefire ITs fail when project directory + contains space + + SUREFIRE-2229: + REGRESSION] SUREFIRE-2224 causes stack trace + to be omitted for errors and failures + + SUREFIRE-2231: JaCoCo 0.8.11 fails with old TestNG releases on + Java 17+ + * Improvement + + SUREFIRE-1345: Support flakyFailure and flakyError in + TestSuiteXmlParser + + SUREFIRE-2221: Document minimum supported Java version for + Toolchains +- Upgrade to 3.2.3 + * Bug + + SUREFIRE-2210: Additional class path ordering broken since + 3.2.0 + + SUREFIRE-2211: additionalClasspathElement with UNC path not + working with Maven Failsafe Plugin + + SUREFIRE-2212: OutOfMemoryError raised when parsing files with + huge stderr/stdout output in surefire-report-parser + + SUREFIRE-2220: + SurefireForkChannel#getForkNodeConnectionString() returns + invalid URI string if localHost resolves to IPv6 address + * Dependency upgrade + + SUREFIRE-2214: Upgrade to HtmlUnit 3.8.0 + + SUREFIRE-2215: Upgrade to Parent 41 + + SUREFIRE-2216: Upgrade plugins and components (in ITs) +- Upgrade to 3.2.2 + * Bug Fixes + + SUREFIRE-2205: Use maven-plugin-report-plugin only in plugins + modules + + SUREFIRE-2206: Downgrade plexus-xml to 3.0.0 + * Dependency updates + + SUREFIRE-2208: Bump org.codehaus.plexus:plexus-java from 1.1.2 + to 1.2.0 +- Upgrade to 3.2.1 + * New features and improvements + + SUREFIRE-1124: Support forkNumber in environment variables + + SUREFIRE-2177: Use junit-bom instead of single JUnit 5 + versions + + SUREFIRE-2179: Support adding additional Maven dependencies to + the test runtime classpath + + SUREFIRE-2178: clarify classpathDependencyExcludes + + SUREFIRE-2182: Log starter implementation on DEBUG level + * Bug Fixes + + SUREFIRE-2190: Fix module dependencies for compile only + dependencies + * Documentation updates + + Fix TestNG web site URL (#671) @sabi0 +- Upgrade to 3.1.2 + * Changes + + SUREFIRE-2166: Use ChoiceFormat to selective render percentage + and elapsed time in SurefireReportRenderer + + Simplify serialization/deserialization of elapsed time + (SUREFIRE-2164 + SUREFIRE-2167) + + SUREFIRE-2169: Potential NPE in WrappedReportEntry when + #getElapsed() is called + + MNG-6829: Replace StringUtils#isEmpty(String) and + #isNotEmpty(String) +- Upgrade to 3.1.0 + * Sub-task + + SUREFIRE-2162: Document upcoming mojo and file names change + * Bug + + SUREFIRE-2140: Cannot release Surefire on Windows + * Improvement + + SUREFIRE-2153: Replace SurefireReportGenerator with a new + SurefireReportRenderer + + SUREFIRE-2160: Replace LocalizedProperties with (Custom)I18N + approach from MPIR + * Task + + SUREFIRE-2130: Rewrite several test classes in report + plugin for upcoming Doxia 2.0.0 stack +- Upgrade to 3.0.0 + * New features and improvements + + SUREFIRE-2154: Get rid of localRepository from surefire + mojo parameter, use Resolver API + * Bug Fixes + + SUREFIRE-2119: Sanitize failIfNoSpecifiedTests prefix in + failsafe + + SUREFIRE-2143: Fix reporting of skipped parameterized test + * Documentation updates + + SUREFIRE-2156: Refresh download page +- Modifed patch: + * 0003-Port-to-TestNG-7.4.0.patch -> 0001-Port-to-TestNG-7.4.0.patch + + regenerate + * maven-surefire-bootstrap-resources.patch + + regenerate from maven build +- Removed patches: + * 0001-Maven-3.patch + * 0002-Port-to-current-doxia.patch + * 0004-Port-to-current-maven-shared-utils.patch + + not needed with this version + +------------------------------------------------------------------- +Thu Feb 22 07:58:37 UTC 2024 - Fridrich Strba + +- Upgrade to 2.22.2 + * Bugs: + + SUREFIRE-1614: JUnit Runner that writes to System.out + corrupts Surefire’s STDOUT when using JUnit’s Vintage Engine +- Upgrade to 2.22.1 + * Bugs: + + SUREFIRE-1532: MIME type for javascript is now officially + application/javascript + + SUREFIRE-1535: Surefire unable to run testng suites in + parallel + + SUREFIRE-1538: Git considers PNG files as changed although + there is no change + + SUREFIRE-1550: The surefire XSD published on maven site lacks + of some rerun element + + SUREFIRE-1559: XML Report elements rerunError, rerunFailure, + flakyFailure, flakyError should contain element stackTrace and + should not be simpleContent. + + SUREFIRE-1561: Logs in Parallel Tests are mixed up when + forkMode=never or forkCount=0 + + SUREFIRE-1564: Can’t override platform version through + project/plugin dependencies + + SUREFIRE-1579: Forks mixed up characters in standard output + * Improvements: + + SUREFIRE-1552: Nil element “failureMessage” in + failsafe-summary.xml should have self closed tag + + SUREFIRE-1554: Fix old test resources TEST-*.xml in favor of + continuing with SUREFIRE-1550 + + SUREFIRE-1555: Elapsed time in XML Report should satisfy + pattern in XSD. + + SUREFIRE-1562: Support Java 11 + + SUREFIRE-1565: Surefire should support parameterized + reportsDirectory + * Tasks: + + SUREFIRE-1569: m-invoker-p:3.1.0 attempts to resolve + maven-surefire-common:jar:2.22.1-SNAPSHOT from remote repo + 'apache.snapshots' + + SUREFIRE-1578: Remove obsolete module + surefire-setup-integration-tests + * Dependency upgrades: + + SUREFIRE-1540: Upgrade maven-plugins parent to version 32 + + SUREFIRE-1571: Upgrade maven-plugins parent to version 33 +- Fetch sources using source service to avoid bundling binaries in + sources +- Fix broken links in the spec file +- Modified patch: + * 0004-Port-to-current-maven-shared-utils.patch + + rediff to changed context + ------------------------------------------------------------------- Wed Apr 27 13:52:13 UTC 2022 - Fridrich Strba diff --git a/maven-surefire-provider-junit5.spec b/maven-surefire-provider-junit5.spec index c72e220..7a57ed3 100644 --- a/maven-surefire-provider-junit5.spec +++ b/maven-surefire-provider-junit5.spec @@ -1,7 +1,7 @@ # -# spec file +# spec file for package maven-surefire-provider-junit5 # -# Copyright (c) 2023 SUSE LLC +# Copyright (c) 2024 SUSE LLC # # All modifications and additions to the file contributed by third parties # remain the property of their copyright owners, unless otherwise agreed @@ -18,27 +18,21 @@ %global base_name maven-surefire Name: %{base_name}-provider-junit5 -Version: 2.22.0 +Version: 3.2.5 Release: 0 Summary: JUnit 5 provider for Maven Surefire License: Apache-2.0 AND CPL-1.0 Group: Development/Libraries/Java URL: https://maven.apache.org/surefire/ -# ./generate-tarball.sh -Source0: %{base_name}-%{version}.tar.gz -# Remove bundled binaries which cannot be easily verified for licensing -Source1: generate-tarball.sh -Source2: http://junit.sourceforge.net/cpl-v10.html -Patch0: 0001-Maven-3.patch -Patch1: 0002-Port-to-current-doxia.patch -Patch2: 0003-Port-to-TestNG-7.4.0.patch -Patch3: 0004-Port-to-current-maven-shared-utils.patch +Source0: %{base_name}-%{version}.tar.xz +Source1: https://www.apache.org/licenses/LICENSE-2.0.txt +Source2: https://www.eclipse.org/legal/cpl-v10.html +Patch0: 0001-Port-to-TestNG-7.4.0.patch BuildRequires: fdupes BuildRequires: java-devel >= 1.8 BuildRequires: maven-local BuildRequires: mvn(org.apache.maven.surefire:common-java5) BuildRequires: mvn(org.apache.maven:maven-parent:pom:) -BuildRequires: mvn(org.apiguardian:apiguardian-api) BuildRequires: mvn(org.junit.platform:junit-platform-launcher) # PpidChecker relies on /usr/bin/ps to check process uptime Requires: procps @@ -55,55 +49,39 @@ Group: Documentation/HTML Javadoc for %{name}. %prep -%setup -q -n surefire-%{version} -cp -p %{SOURCE2} . +%setup -q -n %{base_name}-%{version} +cp -p %{SOURCE1} %{SOURCE2} . -%patch0 -p1 -%patch1 -p1 -%patch2 -p1 -%patch3 -p1 +%patch -P 0 -p1 +#patch -P 1 -p1 # Disable strict doclint sed -i /-Xdoclint:all/d pom.xml +%pom_remove_dep org.junit:junit-bom + %pom_disable_module surefire-shadefire - -%pom_add_dep org.apiguardian:apiguardian-api::provided surefire-providers/surefire-junit-platform - %pom_remove_dep -r org.apache.maven.surefire:surefire-shadefire # Help plugin is needed only to evaluate effective Maven settings. # For building RPM package default settings will suffice. -%pom_remove_plugin :maven-help-plugin surefire-setup-integration-tests +%pom_remove_plugin :maven-help-plugin surefire-its # QA plugin useful only for upstream %pom_remove_plugin -r :jacoco-maven-plugin +# Not wanted +%pom_remove_plugin -r :maven-shade-plugin -# Not in Fedora +find -name *.java -exec sed -i -e s/org.apache.maven.surefire.shared.utils/org.apache.maven.shared.utils/ -e s/org.apache.maven.surefire.shared.io/org.apache.commons.io/ -e s/org.apache.maven.surefire.shared.lang3/org.apache.commons.lang3/ -e s/org.apache.maven.surefire.shared.compress/org.apache.commons.compress/ {} \; + +# Not packaged %pom_remove_plugin -r :animal-sniffer-maven-plugin # Complains %pom_remove_plugin -r :apache-rat-plugin -%pom_remove_plugin -r :maven-enforcer-plugin # We don't need site-source %pom_remove_plugin :maven-assembly-plugin maven-surefire-plugin %pom_remove_dep -r ::::site-source -%pom_xpath_set pom:mavenVersion 3.3.3 -%pom_remove_dep :maven-project maven-surefire-report-plugin -%pom_remove_dep :maven-project maven-surefire-common -%pom_remove_dep :maven-plugin-descriptor maven-surefire-common -%pom_remove_dep :maven-toolchain maven-surefire-common - -%pom_xpath_remove -r "pom:execution[pom:id='shared-logging-generated-sources']" - -%pom_add_dep com.google.code.findbugs:jsr305 surefire-api - -%pom_remove_plugin -r :maven-shade-plugin -%pom_remove_plugin -r :build-helper-maven-plugin - -%pom_add_dep org.apache.commons:commons-lang3::runtime maven-surefire-plugin -%pom_add_dep commons-io:commons-io::runtime maven-surefire-plugin - %build pushd surefire-providers/surefire-junit-platform %{mvn_build} -f -- \ @@ -122,9 +100,9 @@ popd %files -f surefire-providers/surefire-junit-platform/.mfiles %doc README.md -%license LICENSE NOTICE cpl-v10.html +%license LICENSE-2.0.txt cpl-v10.html %files javadoc -f surefire-providers/surefire-junit-platform/.mfiles-javadoc -%license LICENSE NOTICE cpl-v10.html +%license LICENSE-2.0.txt cpl-v10.html %changelog diff --git a/maven-surefire.changes b/maven-surefire.changes index ecec0c0..ed9d9a8 100644 --- a/maven-surefire.changes +++ b/maven-surefire.changes @@ -1,3 +1,154 @@ +------------------------------------------------------------------- +Wed Apr 10 10:54:02 UTC 2024 - Fridrich Strba + +- Upgrade to 3.2.5 + * Bug + + SUREFIRE-2223: Surefire evaluates parameter jvm before skip + + SUREFIRE-2224: StatelessXmlReporter#getTestProblems() does + not properly reflect report schema structure + + SUREFIRE-2225: Surefire ITs fail when project directory + contains space + + SUREFIRE-2229: + REGRESSION] SUREFIRE-2224 causes stack trace + to be omitted for errors and failures + + SUREFIRE-2231: JaCoCo 0.8.11 fails with old TestNG releases on + Java 17+ + * Improvement + + SUREFIRE-1345: Support flakyFailure and flakyError in + TestSuiteXmlParser + + SUREFIRE-2221: Document minimum supported Java version for + Toolchains +- Upgrade to 3.2.3 + * Bug + + SUREFIRE-2210: Additional class path ordering broken since + 3.2.0 + + SUREFIRE-2211: additionalClasspathElement with UNC path not + working with Maven Failsafe Plugin + + SUREFIRE-2212: OutOfMemoryError raised when parsing files with + huge stderr/stdout output in surefire-report-parser + + SUREFIRE-2220: + SurefireForkChannel#getForkNodeConnectionString() returns + invalid URI string if localHost resolves to IPv6 address + * Dependency upgrade + + SUREFIRE-2214: Upgrade to HtmlUnit 3.8.0 + + SUREFIRE-2215: Upgrade to Parent 41 + + SUREFIRE-2216: Upgrade plugins and components (in ITs) +- Upgrade to 3.2.2 + * Bug Fixes + + SUREFIRE-2205: Use maven-plugin-report-plugin only in plugins + modules + + SUREFIRE-2206: Downgrade plexus-xml to 3.0.0 + * Dependency updates + + SUREFIRE-2208: Bump org.codehaus.plexus:plexus-java from 1.1.2 + to 1.2.0 +- Upgrade to 3.2.1 + * New features and improvements + + SUREFIRE-1124: Support forkNumber in environment variables + + SUREFIRE-2177: Use junit-bom instead of single JUnit 5 + versions + + SUREFIRE-2179: Support adding additional Maven dependencies to + the test runtime classpath + + SUREFIRE-2178: clarify classpathDependencyExcludes + + SUREFIRE-2182: Log starter implementation on DEBUG level + * Bug Fixes + + SUREFIRE-2190: Fix module dependencies for compile only + dependencies + * Documentation updates + + Fix TestNG web site URL (#671) @sabi0 +- Upgrade to 3.1.2 + * Changes + + SUREFIRE-2166: Use ChoiceFormat to selective render percentage + and elapsed time in SurefireReportRenderer + + Simplify serialization/deserialization of elapsed time + (SUREFIRE-2164 + SUREFIRE-2167) + + SUREFIRE-2169: Potential NPE in WrappedReportEntry when + #getElapsed() is called + + MNG-6829: Replace StringUtils#isEmpty(String) and + #isNotEmpty(String) +- Upgrade to 3.1.0 + * Sub-task + + SUREFIRE-2162: Document upcoming mojo and file names change + * Bug + + SUREFIRE-2140: Cannot release Surefire on Windows + * Improvement + + SUREFIRE-2153: Replace SurefireReportGenerator with a new + SurefireReportRenderer + + SUREFIRE-2160: Replace LocalizedProperties with (Custom)I18N + approach from MPIR + * Task + + SUREFIRE-2130: Rewrite several test classes in report + plugin for upcoming Doxia 2.0.0 stack +- Upgrade to 3.0.0 + * New features and improvements + + SUREFIRE-2154: Get rid of localRepository from surefire + mojo parameter, use Resolver API + * Bug Fixes + + SUREFIRE-2119: Sanitize failIfNoSpecifiedTests prefix in + failsafe + + SUREFIRE-2143: Fix reporting of skipped parameterized test + * Documentation updates + + SUREFIRE-2156: Refresh download page +- Modifed patch: + * 0003-Port-to-TestNG-7.4.0.patch -> 0001-Port-to-TestNG-7.4.0.patch + + regenerate + * maven-surefire-bootstrap-resources.patch + + regenerate from maven build +- Removed patches: + * 0001-Maven-3.patch + * 0002-Port-to-current-doxia.patch + * 0004-Port-to-current-maven-shared-utils.patch + + not needed with this version + +------------------------------------------------------------------- +Thu Feb 22 07:58:37 UTC 2024 - Fridrich Strba + +- Upgrade to 2.22.2 + * Bugs: + + SUREFIRE-1614: JUnit Runner that writes to System.out + corrupts Surefire’s STDOUT when using JUnit’s Vintage Engine +- Upgrade to 2.22.1 + * Bugs: + + SUREFIRE-1532: MIME type for javascript is now officially + application/javascript + + SUREFIRE-1535: Surefire unable to run testng suites in + parallel + + SUREFIRE-1538: Git considers PNG files as changed although + there is no change + + SUREFIRE-1550: The surefire XSD published on maven site lacks + of some rerun element + + SUREFIRE-1559: XML Report elements rerunError, rerunFailure, + flakyFailure, flakyError should contain element stackTrace and + should not be simpleContent. + + SUREFIRE-1561: Logs in Parallel Tests are mixed up when + forkMode=never or forkCount=0 + + SUREFIRE-1564: Can’t override platform version through + project/plugin dependencies + + SUREFIRE-1579: Forks mixed up characters in standard output + * Improvements: + + SUREFIRE-1552: Nil element “failureMessage” in + failsafe-summary.xml should have self closed tag + + SUREFIRE-1554: Fix old test resources TEST-*.xml in favor of + continuing with SUREFIRE-1550 + + SUREFIRE-1555: Elapsed time in XML Report should satisfy + pattern in XSD. + + SUREFIRE-1562: Support Java 11 + + SUREFIRE-1565: Surefire should support parameterized + reportsDirectory + * Tasks: + + SUREFIRE-1569: m-invoker-p:3.1.0 attempts to resolve + maven-surefire-common:jar:2.22.1-SNAPSHOT from remote repo + 'apache.snapshots' + + SUREFIRE-1578: Remove obsolete module + surefire-setup-integration-tests + * Dependency upgrades: + + SUREFIRE-1540: Upgrade maven-plugins parent to version 32 + + SUREFIRE-1571: Upgrade maven-plugins parent to version 33 +- Fetch sources using source service to avoid bundling binaries in + sources +- Fix broken links in the spec file +- Modified patch: + * 0004-Port-to-current-maven-shared-utils.patch + + rediff to changed context + ------------------------------------------------------------------- Fri May 5 08:30:46 UTC 2023 - Fridrich Strba diff --git a/maven-surefire.spec b/maven-surefire.spec index 10c199d..fa364d4 100644 --- a/maven-surefire.spec +++ b/maven-surefire.spec @@ -1,7 +1,7 @@ # # spec file for package maven-surefire # -# Copyright (c) 2023 SUSE LLC +# Copyright (c) 2024 SUSE LLC # # All modifications and additions to the file contributed by third parties # remain the property of their copyright owners, unless otherwise agreed @@ -17,30 +17,31 @@ Name: maven-surefire -Version: 2.22.0 +Version: 3.2.5 Release: 0 Summary: Test framework project License: Apache-2.0 AND CPL-1.0 Group: Development/Libraries/Java URL: https://maven.apache.org/surefire/ -# ./generate-tarball.sh -Source0: %{name}-%{version}.tar.gz -# Remove bundled binaries which cannot be easily verified for licensing -Source1: generate-tarball.sh -Source2: http://junit.sourceforge.net/cpl-v10.html +Source0: %{name}-%{version}.tar.xz +Source1: https://www.apache.org/licenses/LICENSE-2.0.txt +Source2: https://www.eclipse.org/legal/cpl-v10.html Source10: %{name}-build.tar.xz -Patch0: 0001-Maven-3.patch -Patch1: 0002-Port-to-current-doxia.patch -Patch2: 0003-Port-to-TestNG-7.4.0.patch -Patch3: 0004-Port-to-current-maven-shared-utils.patch +Patch0: 0001-Port-to-TestNG-7.4.0.patch Patch10: %{name}-bootstrap-resources.patch BuildRequires: ant +BuildRequires: apache-commons-cli +BuildRequires: apache-commons-compress BuildRequires: apache-commons-io BuildRequires: apache-commons-lang3 +BuildRequires: atinject BuildRequires: fdupes +BuildRequires: google-guice +BuildRequires: guava BuildRequires: java-devel >= 1.8 BuildRequires: javacc BuildRequires: javapackages-local +BuildRequires: jdom BuildRequires: jsr-305 BuildRequires: junit BuildRequires: maven-common-artifact-filters @@ -52,9 +53,19 @@ BuildRequires: maven-lib BuildRequires: maven-plugin-annotations BuildRequires: maven-reporting-api BuildRequires: maven-reporting-impl +BuildRequires: maven-resolver BuildRequires: maven-shared-utils BuildRequires: objectweb-asm +BuildRequires: plexus-classworlds +BuildRequires: plexus-cli +BuildRequires: plexus-i18n +BuildRequires: plexus-interpolation BuildRequires: plexus-languages +BuildRequires: plexus-metadata-generator +BuildRequires: plexus-utils +BuildRequires: plexus-xml +BuildRequires: qdox +BuildRequires: sisu-inject BuildRequires: sisu-plexus BuildRequires: testng BuildRequires: xmvn-install @@ -131,56 +142,40 @@ Group: Documentation/HTML Javadoc for %{name}. %prep -%setup -q -n surefire-%{version} -a10 -cp -p %{SOURCE2} . +%setup -q -a10 +cp -p %{SOURCE1} %{SOURCE2} . -%patch0 -p1 -%patch1 -p1 -%patch2 -p1 -%patch3 -p1 -%patch10 -p1 +%patch -P 0 -p1 +#patch -P 1 -p1 +%patch -P 10 -p1 # Disable strict doclint sed -i /-Xdoclint:all/d pom.xml +%pom_remove_dep org.junit:junit-bom + %pom_disable_module surefire-shadefire - -%pom_disable_module surefire-junit-platform surefire-providers - %pom_remove_dep -r org.apache.maven.surefire:surefire-shadefire # Help plugin is needed only to evaluate effective Maven settings. # For building RPM package default settings will suffice. -%pom_remove_plugin :maven-help-plugin surefire-setup-integration-tests +%pom_remove_plugin :maven-help-plugin surefire-its # QA plugin useful only for upstream %pom_remove_plugin -r :jacoco-maven-plugin +# Not wanted +%pom_remove_plugin -r :maven-shade-plugin -# Not in Fedora +find -name *.java -exec sed -i -e s/org.apache.maven.surefire.shared.utils/org.apache.maven.shared.utils/ -e s/org.apache.maven.surefire.shared.io/org.apache.commons.io/ -e s/org.apache.maven.surefire.shared.lang3/org.apache.commons.lang3/ -e s/org.apache.maven.surefire.shared.compress/org.apache.commons.compress/ {} \; + +# Not packaged %pom_remove_plugin -r :animal-sniffer-maven-plugin # Complains %pom_remove_plugin -r :apache-rat-plugin -%pom_remove_plugin -r :maven-enforcer-plugin # We don't need site-source %pom_remove_plugin :maven-assembly-plugin maven-surefire-plugin %pom_remove_dep -r ::::site-source -%pom_xpath_set pom:mavenVersion 3.3.3 -%pom_remove_dep :maven-project maven-surefire-report-plugin -%pom_remove_dep :maven-project maven-surefire-common -%pom_remove_dep :maven-plugin-descriptor maven-surefire-common -%pom_remove_dep :maven-toolchain maven-surefire-common - -%pom_xpath_remove -r "pom:execution[pom:id='shared-logging-generated-sources']" - -%pom_add_dep com.google.code.findbugs:jsr305 surefire-api - -%pom_remove_plugin -r :maven-shade-plugin -%pom_remove_plugin -r :build-helper-maven-plugin - -%pom_add_dep org.apache.commons:commons-lang3::runtime maven-surefire-plugin -%pom_add_dep commons-io:commons-io::runtime maven-surefire-plugin - %build %{mvn_package} ":*tests*" __noinstall %{mvn_package} ":{surefire,surefire-providers}" __noinstall @@ -190,33 +185,52 @@ sed -i /-Xdoclint:all/d pom.xml mkdir -p lib build-jar-repository -s -p lib \ - apache-commons-lang3 \ - commons-io \ - javacc \ - jsr-305 \ - junit \ - maven-common-artifact-filters/maven-common-artifact-filters \ - maven-doxia/doxia-core \ - maven-doxia/doxia-logging-api \ - maven-doxia/doxia-sink-api \ - maven-doxia-sitetools/doxia-site-renderer \ - maven/maven-artifact \ - maven/maven-compat \ - maven/maven-core \ - maven/maven-model \ - maven/maven-plugin-api \ - maven-plugin-tools/maven-plugin-annotations \ - maven-reporting-api/maven-reporting-api \ - maven-reporting-impl/maven-reporting-impl \ - maven-shared-utils/maven-shared-utils \ - objectweb-asm/asm \ - org.eclipse.sisu.plexus \ - plexus-languages/plexus-java \ - testng + atinject \ + apache-commons-lang3 \ + commons-cli \ + commons-compress \ + commons-io \ + guava/guava \ + guice/google-guice \ + javacc \ + jdom2/jdom2 \ + jsr-305 \ + junit \ + maven-common-artifact-filters/maven-common-artifact-filters \ + maven-doxia/doxia-core \ + maven-doxia/doxia-logging-api \ + maven-doxia/doxia-sink-api \ + maven-doxia-sitetools/doxia-site-renderer \ + maven/maven-artifact \ + maven/maven-compat \ + maven/maven-core \ + maven/maven-model \ + maven/maven-plugin-api \ + maven/maven-settings \ + maven-plugin-tools/maven-plugin-annotations \ + maven-reporting-api/maven-reporting-api \ + maven-reporting-impl/maven-reporting-impl \ + maven-resolver/maven-resolver-api \ + maven-resolver/maven-resolver-util \ + maven-shared-utils/maven-shared-utils \ + objectweb-asm/asm \ + org.eclipse.sisu.plexus \ + org.eclipse.sisu.inject \ + plexus-classworlds \ + plexus/cli \ + plexus-containers/plexus-component-annotations \ + plexus-i18n/plexus-i18n \ + plexus/interpolation \ + plexus-languages/plexus-java \ + plexus-metadata-generator \ + plexus/utils \ + plexus/xml \ + qdox \ + testng %{ant} \ - -Dtest.skip=true \ - package javadoc + -Dtest.skip=true \ + package javadoc %{mvn_artifact} pom.xml %{mvn_artifact} surefire-providers/pom.xml @@ -228,6 +242,9 @@ for module in \ surefire-api \ surefire-booter \ surefire-grouper \ + surefire-extensions-api \ + surefire-extensions-spi \ + surefire-shared-utils \ maven-surefire-common \ surefire-report-parser \ maven-surefire-plugin \ @@ -261,7 +278,7 @@ done %files -f .mfiles %doc README.md -%license LICENSE NOTICE cpl-v10.html +%license LICENSE-2.0.txt cpl-v10.html %files plugin-bootstrap -f .mfiles-surefire-plugin @@ -276,6 +293,6 @@ done %files -n maven-failsafe-plugin-bootstrap -f .mfiles-failsafe-plugin %files javadoc -f .mfiles-javadoc -%license LICENSE NOTICE cpl-v10.html +%license LICENSE-2.0.txt cpl-v10.html %changelog