utPLSQL · jgebal · Nov 10, 2019 · Sep 3, 2019 · Sep 4, 2019 · Sep 4, 2019
diff --git a/.gitattributes b/.gitattributes
@@ -9,3 +9,8 @@ tests                     export-ignore
 development               export-ignore
 node_modules              export-ignore
 ^docs/*                   linguist-documentation
+*.pkb                     linguist-language=PLSQL
+*.pks                     linguist-language=PLSQL
+*.sql                     linguist-language=PLSQL
+*.tpb                     linguist-language=PLSQL
+*.tps                     linguist-language=PLSQL
diff --git a/.travis.yml b/.travis.yml
@@ -5,13 +5,11 @@ addons:
   apt:
     packages:
       - unzip
-      # Java9 Required for Sonar and SQLCL
-      - oracle-java9-installer
-      - oracle-java9-set-default
+      # Java9+ Required for Sonar and SQLCL
+      - openjdk-9-jre-headless
   sonarcloud:
     organization: utplsql
-    token:
-      secure: ${SONAR_TOKEN}
+    token:   ${SONAR_TOKEN}
 
 services:
   - docker
@@ -47,7 +45,7 @@ env:
     #utPLSQL released version directory
     - UTPLSQL_DIR="utPLSQL_latest_release"
     - SELFTESTING_BRANCH=${TRAVIS_BRANCH}
-    - UTPLSQL_CLI_VERSION="3.1.6"
+    - UTPLSQL_CLI_VERSION="3.1.8"
     # Maven
     - MAVEN_HOME=/usr/local/maven
     - MAVEN_CFG=$HOME/.m2

diff --git a/VERSION b/VERSION
@@ -1 +1 @@
-v3.1.8
+v3.1.9
diff --git a/docs/about/authors.md b/docs/about/authors.md
@@ -1,4 +1,4 @@
-![version](https://img.shields.io/badge/version-v3.1.8.3188-blue.svg)
+![version](https://img.shields.io/badge/version-v3.1.9.3268-blue.svg)
 
 ### utPLSQL v3 Major Contributors 
 

diff --git a/docs/about/license.md b/docs/about/license.md
@@ -1,4 +1,4 @@
-![version](https://img.shields.io/badge/version-v3.1.8.3188-blue.svg)
+![version](https://img.shields.io/badge/version-v3.1.9.3268-blue.svg)
 
 # Version Information
 

diff --git a/docs/about/project-details.md b/docs/about/project-details.md
@@ -1,4 +1,4 @@
-![version](https://img.shields.io/badge/version-v3.1.8.3188-blue.svg)
+![version](https://img.shields.io/badge/version-v3.1.9.3268-blue.svg)
 
 # utPLSQL Project Details
 

diff --git a/docs/about/support.md b/docs/about/support.md
@@ -1,4 +1,4 @@
-![version](https://img.shields.io/badge/version-v3.1.8.3188-blue.svg)
+![version](https://img.shields.io/badge/version-v3.1.9.3268-blue.svg)
 
 # How to get support
 

diff --git a/docs/compare_version2_to_3.md b/docs/compare_version2_to_3.md
@@ -0,0 +1,56 @@
+For version 3 has been a complete rewrite of the framework, the way it can be used is different to
+the previous versions, but also more in line with other modern unit-testing frameworks like JUnit and RSpec.
+
+There is a [migration tool](https://github.com/utPLSQL/utPLSQL-v2-v3-migration) that can help you to migrate your existing utPLSQL v2 tests to the v3 capabilities. 
+
+# Feature comparison
+
+| Feature                                | Version 2              | Version 3              |
+| -------------------------------------- | ---------------------- | ---------------------- |
+| Easy to install                        | Yes                    | Yes                    |
+| Documentation                          | Yes                    | Yes                    |
+| License                                | GPL v2                 | Apache 2.0             |
+| **Tests Creation**                     |                        |                        |
+| Declarative test configuration         | No                     | Yes - Annotations<sup>1</sup>|
+| Tests as Packages                      | Yes                    | Yes                    |
+| Multiple Tests in a single Package     | Yes                    | Yes                    |
+| Optional Setup/Teardown                | No                     | Yes                    |
+| Different Setup/Teardown <br/> For Each Test in a Single Package| No  | Yes - Annotations<sup>1</sup> |
+| Suite Definition Storage               | Tables                 | Package - Annotations<sup>1</sup> |
+| Multiple Suites                        | Yes                    | Yes                    |
+| Suites can contain Suites              | No                     | Yes                    |
+| Automatic Test detection               | No                     | Yes - Annotations<sup>1</sup>|
+| Unconstrained naming of Test packages  | No - prefixes          | Yes - name not relevant|
+| Require Prefix on Test procedures      | No - prefixes          | Yes - name not relevant|
+| Auto Compilation of Tests              | Yes                    | No (Let us know if you use this) | 
+| Assertion Library                      | 30 assertions<sup>2</sup> | 26 matchers (13 + 13 negated) |
+| Extendable assertions                  | No                     | Yes - custom matchers  |
+| PLSQL Record Assertions	             | generated code through **utRecEq** Package | [possible on Oracle 12c+](https://oracle-base.com/articles/12c/using-the-table-operator-with-locally-defined-types-in-plsql-12cr1) using [cursor matchers](userguide/expectations.md#comparing-cursors)| 
+| Test Skeleton Generation               | Yes                    | No (Let us know if you use this) |
+| **Test Execution<sup>3</sup>**         |                        |                        |
+| Single Test Package Execution          |  Yes                   | Yes                    | 
+| Single Test Procedure Execution        |  No                    | Yes                    | 
+| Test Suite Execution                   |  Yes                   | Yes                    |
+| Subset of Suite Execution              |  No                    | Yes                    |
+| Multiple Suite Execution               |  No                    | Yes                    |
+| Organizing Suites into hierarchies     |  No                    | Yes                    |
+| **Code Coverage Reporting**            |  No                    | Yes                    |
+| Html Coverage Report                   |  No                    | Yes                    |
+| Sonar XML Coverage Report              |  No                    | Yes                    |
+| Coveralls Json Coverage Report         |  No                    | Yes                    |
+| Framework Transaction Control          |  No                    | Yes - Annotations<sup>1</sup> | 
+| **Test Output**                        |                        |                        |
+| Real-time test execution progress reporting | No                | Yes                    |
+| Multiple Output Reporters can be used during test execution | No| Yes                    |
+| DBMS_OUTPUT                            | Yes                    | Yes (clean formatting) |
+| File                                   | Yes (to db server only)| Yes (on client side)   |
+| Stored in Table                        | Yes                    | No (can be added as custom reporter) |
+| XUnit format support                   | No                     | Yes                    |
+| HTML Format                            | Yes                    | No                     |
+| Custom Output reporter                 | Yes-needs configuration| Yes - no config needed |
+
+<sup>1</sup> Annotations are specially formatted comments in your package specification.  This enables *declarative* test configuration that is coupled with the source code.   See Documentation for more details. 
+
+<sup>2</sup> **utAssert2** package - Contains 59 Assertions - 2 Not implemented = 57, 28 are duplicated only change on outcome_in parameter 57-28 = 29, **utPipe** package - Contains 1 Assertion 29 + 1 = 30
+
+<sup>3</sup> Test execution comparison is in a single call so the results are combined.   We know it was always possible to group in any way with multiple calls.  But that may not be desired under a CI system where you want a single JUnit XML Output.
diff --git a/docs/index.md b/docs/index.md
@@ -1,4 +1,4 @@
-![version](https://img.shields.io/badge/version-v3.1.8.3188-blue.svg)
+![version](https://img.shields.io/badge/version-v3.1.9.3268-blue.svg)
 
 # Introduction to utPLSQL
 
@@ -25,6 +25,7 @@ The framework follows industry standards and best patterns of modern Unit Testin
        - [License](about/license.md)
        - [Support](about/support.md)
        - [Authors](about/authors.md)
+  - [Version 2 to Version 3 Comparison](compare_version2_to_3.md)
 
 # Demo project
 

diff --git a/docs/userguide/advanced_data_comparison.md b/docs/userguide/advanced_data_comparison.md
@@ -1,4 +1,4 @@
-![version](https://img.shields.io/badge/version-v3.1.8.3188-blue.svg)
+![version](https://img.shields.io/badge/version-v3.1.9.3268-blue.svg)
 
 # Advanced data comparison