BAEL-6283 Creating a Test Suite with JUnit (#13873)

testing-modules/junit-5-advanced/pom.xml

@@ -33,6 +33,19 @@
             <version>${assertj.version}</version>
             <scope>test</scope>
         </dependency>
+        <dependency>
+            <groupId>org.junit.platform</groupId>
+            <artifactId>junit-platform-suite</artifactId>
+            <version>${junit-platform.version}</version>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.junit.platform</groupId>
+            <artifactId>junit-platform-runner</artifactId>
+            <version>${junit-platform.version}</version>
+            <scope>test</scope>
+        </dependency>
+
     </dependencies>
 
     <build>
@@ -45,6 +58,9 @@
                         -javaagent:${settings.localRepository}/org/jmockit/jmockit/${jmockit.version}/jmockit-${jmockit.version}.jar
                     </argLine>
                     <disableXmlReport>true</disableXmlReport>
+                    <excludes>
+                        <exclude>**/testsuite/**/*UnitTest.java</exclude>
+                    </excludes>
                 </configuration>
             </plugin>
         </plugins>
@@ -53,6 +69,7 @@
     <properties>
         <jmockit.version>1.49</jmockit.version>
         <assertj.version>3.24.2</assertj.version>
+        <junit-platform.version>1.9.2</junit-platform.version>
     </properties>
 
 </project>

testing-modules/junit-5-advanced/src/test/java/com/baeldung/testsuite/ClassOneUnitTest.java

@@ -0,0 +1,13 @@
+package com.baeldung.testsuite;
+
+import org.junit.jupiter.api.Assertions;
+import org.junit.jupiter.api.Test;
+
+public class ClassOneUnitTest {
+
+    @Test
+    public void whenTrue_thenTrue() {
+        Assertions.assertTrue(true);
+    }
+
+}

testing-modules/junit-5-advanced/src/test/java/com/baeldung/testsuite/ClassThreeUnitTest.java

@@ -0,0 +1,13 @@
+package com.baeldung.testsuite;
+
+import org.junit.jupiter.api.Assertions;
+import org.junit.jupiter.api.Tag;
+import org.junit.jupiter.api.Test;
+
+public class ClassThreeUnitTest {
+    @Test
+    @Tag("slow")
+    public void whenTrue_thenTrue() {
+        Assertions.assertTrue(true);
+    }
+}

testing-modules/junit-5-advanced/src/test/java/com/baeldung/testsuite/package-info.java

@@ -0,0 +1,4 @@
+/**
+ * Dummy tests - showing Junit Suite functionality
+ */
+package com.baeldung.testsuite;

testing-modules/junit-5-advanced/src/test/java/com/baeldung/testsuite/subpackage/ClassTwoUnitTest.java

@@ -0,0 +1,11 @@
+package com.baeldung.testsuite.subpackage;
+
+import org.junit.jupiter.api.Assertions;
+import org.junit.jupiter.api.Test;
+
+public class ClassTwoUnitTest {
+    @Test
+    public void whenTrue_thenTrue() {
+        Assertions.assertTrue(true);
+    }
+}

testing-modules/junit-5-advanced/src/test/java/com/baeldung/testsuite/suites/JUnitClassNamePatternsSuite.java

@@ -0,0 +1,14 @@
+package com.baeldung.testsuite.suites;
+
+import org.junit.platform.suite.api.ExcludeClassNamePatterns;
+import org.junit.platform.suite.api.IncludeClassNamePatterns;
+import org.junit.platform.suite.api.SelectPackages;
+import org.junit.platform.suite.api.Suite;
+
+@Suite
+@SelectPackages("com.baeldung.testsuite")
+@IncludeClassNamePatterns("com.baeldung.testsuite.Class.*UnitTest")
+@ExcludeClassNamePatterns("com.baeldung.testsuite.ClassTwoUnitTest")
+public class JUnitClassNamePatternsSuite {
+    // runs ClassOneUnitTest and ClassThreeUnitTest
+}

testing-modules/junit-5-advanced/src/test/java/com/baeldung/testsuite/suites/JUnitExcludePackagesSuite.java

@@ -0,0 +1,12 @@
+package com.baeldung.testsuite.suites;
+
+import org.junit.platform.suite.api.ExcludePackages;
+import org.junit.platform.suite.api.SelectPackages;
+import org.junit.platform.suite.api.Suite;
+
+@Suite
+@SelectPackages("com.baeldung.testsuite")
+@ExcludePackages("com.baeldung.testsuite.subpackage")
+public class JUnitExcludePackagesSuite {
+    // runs ClassOneUnitTest and ClassThreeUnitTest
+}

testing-modules/junit-5-advanced/src/test/java/com/baeldung/testsuite/suites/JUnitRunWithSuite.java

@@ -0,0 +1,16 @@
+package com.baeldung.testsuite.suites;
+
+import com.baeldung.testsuite.ClassOneUnitTest;
+import com.baeldung.testsuite.subpackage.ClassTwoUnitTest;
+import org.junit.platform.runner.JUnitPlatform;
+import org.junit.platform.suite.api.SelectClasses;
+import org.junit.platform.suite.api.SuiteDisplayName;
+import org.junit.runner.RunWith;
+
+@RunWith(JUnitPlatform.class)
+@SuiteDisplayName("My Test Suite")
+@SelectClasses({ClassOneUnitTest.class, ClassTwoUnitTest.class})
+public class JUnitRunWithSuite {
+    // runs ClassOneUnitTest and ClassTwoUnitTest
+    // equivalent to JUnitSelectClassesSuite
+}

testing-modules/junit-5-advanced/src/test/java/com/baeldung/testsuite/suites/JUnitSelectClassesSuite.java

@@ -0,0 +1,14 @@
+package com.baeldung.testsuite.suites;
+
+import com.baeldung.testsuite.ClassOneUnitTest;
+import com.baeldung.testsuite.subpackage.ClassTwoUnitTest;
+import org.junit.platform.suite.api.SelectClasses;
+import org.junit.platform.suite.api.Suite;
+import org.junit.platform.suite.api.SuiteDisplayName;
+
+@Suite
+@SuiteDisplayName("My Test Suite")
+@SelectClasses({ClassOneUnitTest.class, ClassTwoUnitTest.class})
+public class JUnitSelectClassesSuite {
+    // runs ClassOneUnitTest and ClassTwoUnitTest
+}

testing-modules/junit-5-advanced/src/test/java/com/baeldung/testsuite/suites/JUnitSelectPackagesSuite.java

@@ -0,0 +1,10 @@
+package com.baeldung.testsuite.suites;
+
+import org.junit.platform.suite.api.SelectPackages;
+import org.junit.platform.suite.api.Suite;
+
+@Suite
+@SelectPackages({"com.baeldung.testsuite", "com.baeldung.testsuitetwo"})
+public class JUnitSelectPackagesSuite {
+    // runs ClassOneUnitTest, ClassTwoUnitTest and ClassThreeUnitTest
+}

testing-modules/junit-5-advanced/src/test/java/com/baeldung/testsuite/suites/JUnitTestExcludeTagsSuite.java

@@ -0,0 +1,12 @@
+package com.baeldung.testsuite.suites;
+
+import org.junit.platform.suite.api.ExcludeTags;
+import org.junit.platform.suite.api.SelectPackages;
+import org.junit.platform.suite.api.Suite;
+
+@Suite
+@SelectPackages("com.baeldung.testsuite")
+@ExcludeTags("slow")
+public class JUnitTestExcludeTagsSuite {
+    // runs ClassOneUnitTest, ClassTwoUnitTest
+}

testing-modules/junit-5-advanced/src/test/java/com/baeldung/testsuite/suites/JUnitTestIncludePackagesSuite.java

@@ -0,0 +1,12 @@
+package com.baeldung.testsuite.suites;
+
+import org.junit.platform.suite.api.IncludePackages;
+import org.junit.platform.suite.api.SelectPackages;
+import org.junit.platform.suite.api.Suite;
+
+@Suite
+@SelectPackages("com.baeldung.testsuite")
+@IncludePackages("com.baeldung.testsuite.subpackage")
+public class JUnitTestIncludePackagesSuite {
+    // runs ClassTwoUnitTest
+}

testing-modules/junit-5-advanced/src/test/java/com/baeldung/testsuite/suites/JUnitTestIncludeTagsSuite.java

@@ -0,0 +1,12 @@
+package com.baeldung.testsuite.suites;
+
+import org.junit.platform.suite.api.IncludeTags;
+import org.junit.platform.suite.api.SelectPackages;
+import org.junit.platform.suite.api.Suite;
+
+@Suite
+@SelectPackages("com.baeldung.testsuite")
+@IncludeTags("slow")
+public class JUnitTestIncludeTagsSuite {
+    // runs ClassTwoUnitTest
+}