Adds owners parameters for #5

* Adds 2 new parameters : sourcesOwner / testsOwner
* Adds 1 new project sample (owner-param-project)
* Refactor travis build (run tests with ut3 user)
* Improve documentation

Author: jgarec

.travis.yml

@@ -15,8 +15,8 @@ env:
     - MAVEN_HOME=/usr/local/maven
     - MAVEN_CFG=$HOME/.m2
     - DB_URL="127.0.0.1:1521:XE"
-    - DB_USER=app
-    - DB_PASS=app
+    - DB_UT3_USER=ut3
+    - DB_UT3_PASS=ut3
     - ORACLE_VERSION="11g-r2-xe"
     - DOCKER_OPTIONS="--shm-size=1g"
 
@@ -29,14 +29,15 @@ cache:
 install:
   - bash .travis/maven_cfg.sh
   - bash .travis/start_db.sh
-  - bash .travis/install_utplsql.sh
+  - bash .travis/install_utplsql.sh $DB_UT3_USER $DB_UT3_PASS
   - bash .travis/install_demo_project.sh
+  - bash .travis/install_demo_owner_project.sh
 
 script:
   - echo "Run Unit tests"
   - mvn test
   - echo "Run Integration tests"
-  - mvn verify -Dmaven.skip.test -DdbUser="${DB_USER}" -DdbPass="${DB_PASS}" -DdbUrl="jdbc:oracle:thin:@${DB_URL}"
+  - mvn verify -Dmaven.skip.test -DdbUser="${DB_UT3_USER}" -DdbPass="${DB_UT3_PASS}" -DdbUrl="jdbc:oracle:thin:@${DB_URL}"
 
 #before_deploy:
 #  - bash .travis/create_release.sh

.travis/create_api_user.sh

@@ -0,0 +1,50 @@
+#!/bin/bash
+set -ev
+
+PROJECT_FILES_SRC="utplsql-maven-plugin-it/src/it/resources/owner-param-project"
+PROJECT_FILES="resources-owner"
+DB_CODE_USER=CODE_OWNER
+DB_TESTS_USER=TESTS_OWNER
+DB_PASS=pass
+
+cat > demo_project.sh.tmp <<EOF
+sqlplus -S -L sys/oracle@//127.0.0.1:1521/xe AS SYSDBA <<SQL
+create user ${DB_CODE_USER} identified by ${DB_PASS} quota unlimited on USERS default tablespace USERS;
+grant create session, create procedure, create type, create table, create sequence, create view to ${DB_CODE_USER};
+
+create user ${DB_TESTS_USER} identified by ${DB_PASS} quota unlimited on USERS default tablespace USERS;
+grant create session, create procedure, create type, create table, create sequence, create view, create synonym to ${DB_TESTS_USER};
+grant select any dictionary to ${DB_TESTS_USER};
+grant select any table, delete any table, drop any table to ${DB_TESTS_USER};
+grant execute any procedure to ${DB_TESTS_USER};
+exit
+SQL
+
+cd ${PROJECT_FILES}
+sqlplus -S -L ${DB_CODE_USER}/${DB_PASS}@//127.0.0.1:1521/xe <<SQL
+whenever sqlerror exit failure rollback
+whenever oserror  exit failure rollback
+
+@scripts/sources/foo/tables/TO_TEST_ME.tab
+@scripts/sources/foo/packages/PKG_TEST_ME.sql
+@scripts/sources/foo/package_bodies/PKG_TEST_ME.sql
+
+exit
+SQL
+
+sqlplus -S -L ${DB_TESTS_USER}/${DB_PASS}@//127.0.0.1:1521/xe <<SQL
+whenever sqlerror exit failure rollback
+whenever oserror  exit failure rollback
+
+create synonym TO_TEST_ME for ${DB_CODE_USER}.TO_TEST_ME;
+create synonym PKG_TEST_ME for ${DB_CODE_USER}.PKG_TEST_ME;
+@scripts/test/bar/packages/TEST_PKG_TEST_ME.sql
+@scripts/test/bar/package_bodies/TEST_PKG_TEST_ME.sql
+
+exit
+SQL
+EOF
+
+docker cp ./$PROJECT_FILES_SRC $ORACLE_VERSION:/$PROJECT_FILES
+docker cp ./demo_project.sh.tmp $ORACLE_VERSION:/demo_project.sh
+docker exec $ORACLE_VERSION bash demo_project.sh

.travis/install_demo_owner_project.sh

@@ -3,6 +3,8 @@ set -ev
 
 PROJECT_FILES_SRC="utplsql-maven-plugin-it/src/it/resources/simple-project"
 PROJECT_FILES="resources"
+DB_USER=app
+DB_PASS=app
 
 cat > demo_project.sh.tmp <<EOF
 sqlplus -S -L sys/oracle@//127.0.0.1:1521/xe AS SYSDBA <<SQL

.travis/install_demo_project.sh

@@ -17,14 +17,25 @@ curl -L -O "https://github.com/utPLSQL/utPLSQL/releases/download/$UTPLSQL_VERSIO
 cat > install.sh.tmp <<EOF
 tar -xzf ${UTPLSQL_FILE}.tar.gz && rm ${UTPLSQL_FILE}.tar.gz
 cd ${UTPLSQL_FILE}/source
-sqlplus -S -L sys/oracle@//127.0.0.1:1521/xe AS SYSDBA @install_headless.sql ut3 ut3 users
+sqlplus -S -L sys/oracle@//127.0.0.1:1521/xe AS SYSDBA @install_headless.sql $1 $2 users
+
+sqlplus -S -L sys/oracle@//127.0.0.1:1521/xe AS SYSDBA << SQL
+grant execute any procedure to $1;
+grant create any procedure to $1;
+grant execute on dbms_lob to $1;
+grant execute on dbms_sql to $1;
+grant execute on dbms_xmlgen to $1;
+grant execute on dbms_lock to $1;  
+
+
+exit
+SQL
 EOF
 
 # Copy utPLSQL files to the container and install it.
 docker cp ./$UTPLSQL_FILE.tar.gz $ORACLE_VERSION:/$UTPLSQL_FILE.tar.gz
 # docker cp ./$UTPLSQL_FILE $ORACLE_VERSION:/$UTPLSQL_FILE
 docker cp ./install.sh.tmp $ORACLE_VERSION:/install.sh
-docker cp ./create_api_user.sh $ORACLE_VERSION:/create_api_user.sh
 
 # Remove temporary files.
 # rm $UTPLSQL_FILE.tar.gz
@@ -33,4 +44,3 @@ rm install.sh.tmp
 
 # Execute the utPLSQL installation inside the container.
 docker exec $ORACLE_VERSION bash install.sh
-docker exec $ORACLE_VERSION bash create_api_user.sh

.travis/install_utplsql.sh

@@ -34,6 +34,8 @@ You have to be a fully utPLSQL environment available compatible with the Java AP
 
 * `sources`
   * Path to project source files
+* `sourcesOwner`
+  * Owner of the tested code
 * `sourcesRegexExpression`
   * utPLSQL will convert file paths into database objects using the following regular expression
 * `sourcesOwnerSubexpression`
@@ -47,6 +49,8 @@ You have to be a fully utPLSQL environment available compatible with the Java AP
 
 * `tests`
   * Path to project test files
+* `testsOwner`
+  * Owner of the testing code
 * `testsRegexExpression`
   * utPLSQL will convert file paths into database objects using the following regular expression
 * `testsOwnerSubexpression`
@@ -59,21 +63,55 @@ You have to be a fully utPLSQL environment available compatible with the Java AP
   * List of Custom Type Mappings
 
 
+### Comparaison with the CLI
+
+| CLI short parameter | CLI long parameter | maven XML path |
+| --- | --- | --- |
+| -c | --color | |
+| | --failure-exit-code | |
+| | | ignoreFailure |
+| -f | --format | reporters.reporter.name |
+| -o | | reporters.reporter.fileOutput |
+| -s | | reporters.reporter.consoleOutput |
+| -p | --path | paths.path |
+| -scc | --skip-compatibility-check | skipCompatibilityCheck |
+| -exclude | | excludeObject |
+| -include | | includeObject |
+| | | |
+| -source_path | | sources.source.directory |
+| -owner | | sourcesOwner |
+| -regex_expression | | sourcesRegexExpression |
+| -type_mapping | | list of testsCustomTypeMapping.customTypeMapping |
+| -owner_subexpression | | sourcesOwnerSubexpression |
+| -type_subexpression | | sourcesTypeSubexpression |
+| -name_subexpression | | sourcesNameSubexpression |
+| | | |
+| -test_path | | tests.test.directory |
+| -owner | | testsOwner |
+| -regex_expression | | testsRegexExpression |
+| -type_mapping | | list of testsCustomTypeMapping.customTypeMapping |
+| -owner_subexpression | | testsOwnerSubexpression |
+| -type_subexpression | | testsTypeSubexpression |
+| -name_subexpression | | testsNameSubexpression |
+
 ### Sample of use
 The next snippet is a sample of declaration of the pom
 ```xml
 	<plugin>
 		<groupId>org.utplsql</groupId>
 		<artifactId>utplsql-maven-plugin</artifactId>
-		<version>1.0.0-SNAPSHOT</version>
+		<version>3.1.0</version>
 		<goals>
 			<goal>test</goal>
 		</goals>
 		<configuration>
 			<dbUrl>url_of_connection</dbUrl>
 			<dbUser>user</dbUser>
 			<dbPass>password</dbPass>
-			<failOnErrors>false</failOnErrors>
+			<ignoreFailure>false</ignoreFailure>
+			<paths>
+				<path>schema_name</path>
+			</paths>
 			<reporters>
 				<reporter>
 					<name>UT_COVERAGE_SONAR_REPORTER</name>
@@ -115,3 +153,5 @@ More project samples are available in the src/test/resources directory :
 * simple-project : minimalist test project with standard project directory structure
 * regex-project : override project directory structure and use additional parameters (sourcesRegexExpression, testsRegexExpression, ...) to tell utPLSQL how the project files are to be mapped into database objects.
 * type-mapping-project : This project shows how to use regex and custom type parameters togethers.
+* owner-param-project : This project demonstrates how to use sourcesOwner and testsOwner parameters.
+