New Optional Feature RANDOM_EXECUTION_ORDER

Also new TestRunnerStatement and TestRunnerOptions

Author: pesse

src/main/java/org/utplsql/api/TestRunner.java

@@ -118,6 +118,17 @@ public TestRunner setReporterFactory(ReporterFactory reporterFactory) {
         return this;
     }
 
+    public TestRunner randomTestOrder(boolean randomTestOrder ) {
+        this.options.randomTestOrder = randomTestOrder;
+        return this;
+    }
+
+    public TestRunner randomTestOrderSeed( Integer seed ) {
+        this.options.randomTestOrderSeed = seed;
+        if ( seed != null ) this.options.randomTestOrder = true;
+        return this;
+    }
+
     private void delayedAddReporters() {
         if (reporterFactory != null) {
             reporterNames.forEach(this::addReporter);

src/main/java/org/utplsql/api/TestRunnerOptions.java

@@ -25,4 +25,6 @@ public class TestRunnerOptions {
     public boolean failOnErrors = false;
     public boolean skipCompatibilityCheck = false;
     public String clientCharacterSet = Charset.defaultCharset().toString();
+    public boolean randomTestOrder = false;
+    public Integer randomTestOrderSeed;
 }

src/main/java/org/utplsql/api/Version.java

@@ -31,10 +31,11 @@ public class Version implements Comparable<Version> {
     public final static Version V3_1_4 = new Version("3.1.4", 3, 1, 4, null, true);
     public final static Version V3_1_5 = new Version("3.1.5", 3, 1, 5, null, true);
     public final static Version V3_1_6 = new Version("3.1.6", 3, 1, 6, null, true);
+    public final static Version V3_1_7 = new Version("3.1.7", 3, 1, 7, null, true);
     private final static Map<String, Version> knownVersions =
-            Stream.of(V3_0_0, V3_0_1, V3_0_2, V3_0_3, V3_0_4, V3_1_0, V3_1_1, V3_1_2, V3_1_3, V3_1_4, V3_1_5, V3_1_6)
+            Stream.of(V3_0_0, V3_0_1, V3_0_2, V3_0_3, V3_0_4, V3_1_0, V3_1_1, V3_1_2, V3_1_3, V3_1_4, V3_1_5, V3_1_6, V3_1_7)
                     .collect(toMap(Version::toString, Function.identity()));
-    public final static Version LATEST = V3_1_6;
+    public final static Version LATEST = V3_1_7;
 
     private final String origString;
     private final Integer major;

src/main/java/org/utplsql/api/compatibility/OptionalFeatures.java

@@ -11,7 +11,8 @@ public enum OptionalFeatures {
     FAIL_ON_ERROR("3.0.3.1266", null),
     FRAMEWORK_COMPATIBILITY_CHECK("3.0.3.1266", null),
     CUSTOM_REPORTERS("3.1.0.1849", null),
-    CLIENT_CHARACTER_SET("3.1.2.2130", null);
+    CLIENT_CHARACTER_SET("3.1.2.2130", null),
+    RANDOM_EXECUTION_ORDER("3.1.7.2795", null);
 
     private final Version minVersion;
     private final Version maxVersion;

src/main/java/org/utplsql/api/testRunner/ActualTestRunnerStatement.java

@@ -22,6 +22,7 @@ protected String getSql() {
         // Workaround because Oracle JDBC doesn't support passing boolean to stored procedures.
         String colorConsoleStr = Boolean.toString(options.colorConsole);
         String failOnErrors = Boolean.toString(options.failOnErrors);
+        String randomExecutionOrder = Boolean.toString(options.randomTestOrder);
 
         return
                 "BEGIN " +
@@ -35,7 +36,9 @@ protected String getSql() {
                         "a_include_objects      => ?, " +
                         "a_exclude_objects      => ?, " +
                         "a_fail_on_errors       => " + failOnErrors + ", " +
-                        "a_client_character_set => ?); " +
+                        "a_client_character_set => ?" +
+                        //(options.randomTestOrderSeed != null ) ?
+                        "); " +
                         "END;";
     }
 

src/main/java/org/utplsql/api/testRunner/Pre317TestRunnerStatement.java

@@ -0,0 +1,50 @@
+package org.utplsql.api.testRunner;
+
+import org.utplsql.api.TestRunnerOptions;
+
+import java.sql.Connection;
+import java.sql.SQLException;
+
+/**
+ * Provides the call to run tests for the most actual Framework version.
+ * Includes fail on error
+ *
+ * @author pesse
+ */
+class Pre317TestRunnerStatement extends AbstractTestRunnerStatement {
+
+    public Pre317TestRunnerStatement(TestRunnerOptions options, Connection connection) throws SQLException {
+        super(options, connection);
+    }
+
+    @Override
+    protected String getSql() {
+        // Workaround because Oracle JDBC doesn't support passing boolean to stored procedures.
+        String colorConsoleStr = Boolean.toString(options.colorConsole);
+        String failOnErrors = Boolean.toString(options.failOnErrors);
+
+        return
+                "BEGIN " +
+                        "ut_runner.run(" +
+                        "a_paths                => ?, " +
+                        "a_reporters            => ?, " +
+                        "a_color_console        => " + colorConsoleStr + ", " +
+                        "a_coverage_schemes     => ?, " +
+                        "a_source_file_mappings => ?, " +
+                        "a_test_file_mappings   => ?, " +
+                        "a_include_objects      => ?, " +
+                        "a_exclude_objects      => ?, " +
+                        "a_fail_on_errors       => " + failOnErrors + ", " +
+                        "a_client_character_set => ?); " +
+                        "END;";
+    }
+
+    @Override
+    protected int createStatement() throws SQLException {
+        int curParamIdx = super.createStatement();
+
+        callableStatement.setString(++curParamIdx, options.clientCharacterSet);
+
+        return curParamIdx;
+    }
+}

src/main/java/org/utplsql/api/testRunner/TestRunnerStatementProvider.java

@@ -35,6 +35,8 @@ public static TestRunnerStatement getCompatibleTestRunnerStatement(Version datab
                 stmt = new Pre303TestRunnerStatement(options, conn);
             } else if (databaseVersion.isLessThan(Version.V3_1_2)) {
                 stmt = new Pre312TestRunnerStatement(options, conn);
+            } else if (databaseVersion.isLessThan(Version.V3_1_7)) {
+                stmt = new Pre317TestRunnerStatement(options, conn);
             }
 
         } catch (InvalidVersionException ignored) {

src/test/java/org/utplsql/api/OptionalFeaturesIT.java

@@ -64,4 +64,15 @@ void clientCharset() throws SQLException, InvalidVersionException {
             assertFalse(available);
         }
     }
+
+    @Test
+    void randomExecutionOrder() throws SQLException, InvalidVersionException {
+        boolean available = OptionalFeatures.RANDOM_EXECUTION_ORDER.isAvailableFor(getConnection());
+
+        if (getDatabaseVersion().isGreaterOrEqualThan(Version.V3_1_7)) {
+            assertTrue(available);
+        } else {
+            assertFalse(available);
+        }
+    }
 }

src/test/java/org/utplsql/api/TestRunnerIT.java

@@ -78,4 +78,14 @@ void failOnErrors() throws SQLException, InvalidVersionException {
         }
     }
 
+    @Test
+    void runWithRandomExecutionOrder() throws SQLException {
+        CompatibilityProxy proxy = new CompatibilityProxy(getConnection());
+
+        new TestRunner()
+                .randomTestOrder(true)
+                .randomTestOrderSeed(123)
+                .run(getConnection());
+    }
+
 }

src/test/java/org/utplsql/api/testRunner/TestRunnerStatementProviderIT.java

@@ -31,8 +31,20 @@ void testGettingPre312Version_from_311() throws SQLException {
     }
 
     @Test
-    void testGettingActualVersion() throws SQLException {
+    void testGettingPre317Version_from_312() throws SQLException {
         TestRunnerStatement stmt = TestRunnerStatementProvider.getCompatibleTestRunnerStatement(Version.V3_1_2, new TestRunnerOptions(), getConnection());
+        assertEquals(Pre317TestRunnerStatement.class, stmt.getClass());
+    }
+
+    @Test
+    void testGettingPre317Version_from_316() throws SQLException {
+        TestRunnerStatement stmt = TestRunnerStatementProvider.getCompatibleTestRunnerStatement(Version.V3_1_6, new TestRunnerOptions(), getConnection());
+        assertEquals(Pre317TestRunnerStatement.class, stmt.getClass());
+    }
+
+    @Test
+    void testGettingActualVersion_from_latest() throws SQLException {
+        TestRunnerStatement stmt = TestRunnerStatementProvider.getCompatibleTestRunnerStatement(Version.LATEST, new TestRunnerOptions(), getConnection());
         assertEquals(ActualTestRunnerStatement.class, stmt.getClass());
     }
 }