utPLSQL-cli

Java command-line client for utPLSQL v3.

Provides an easy way of invoking utPLSQL from command-line. Main features:

Ability to run tests with multiple reporters simultaneously.
Ability to save output from every individual reporter to a separate output file.
Allows execution of selected suites, subset of suite.
~~Maps project and test files to database objects for reporting purposes.~~ (Comming Soon)

Downloading

You can download development versions on Bintray.

Requirements

Java SE Runtime Environment 8
~~When using reporters for Sonar or Coveralls client needs to be invoked from project's root directory.~~

Usage

utplsql run user/pass@[[host][:port]/]db [-p=(ut_path|ut_paths)] [-f=format [-o=output_file] [-s] ...]

user              - Username to connect as.
password          - Password of the user.
host              - Server address, defaults to 127.0.0.1.
port              - Server port, defaults to 1521.
db                - Database to connect to.
-p=suite_path(s)  - A suite path or a comma separated list of suite paths for unit test to be executed.     
                    The path(s) can be in one of the following formats:
                        schema[.package[.procedure]]
                        schema:suite[.suite[.suite][...]][.procedure]
                    Both formats can be mixed in the list.
                    If only schema is provided, then all suites owner by that schema are executed.
                    If -p is omitted, the current schema is used.
-f=format         - A reporter to be used for reporting.
                    If no -f option is provided, the default ut_documentation_reporter is used.
                    Available options:
                        -f=ut_documentation_reporter
                           A textual pretty-print of unit test results (usually use for console output)
                        -f=ut_teamcity_reporter
                           For reporting live progress of test execution with Teamcity CI. 
                        -f=ut_xunit_reporter
                           Used for reporting test results with CI servers like Jenkins/Hudson/Teamcity.
                        -f=ut_coverage_html_reporter
                           Generates a HTML coverage report with summary and line by line information on code coverage.
                           Based on open-source simplecov-html coverage reporter for Ruby.
                           Includes source code in the report.
                        -f=ut_coveralls_reporter
                           Generates a JSON coverage report providing information on code coverage with line numbers.
                           Designed for [Coveralls](https://coveralls.io/).
                        -f=ut_coverage_sonar_reporter
                           Generates a JSON coverage report providing information on code coverage with line numbers.
                           Designed for [SonarQube](https://about.sonarqube.com/) to report coverage.
                        -f=ut_sonar_test_reporter
                           Generates a JSON report providing detailed information on test execution.
                           Designed for [SonarQube](https://about.sonarqube.com/) to report test execution.

-o=output         - Defines file name to save the output from the specified reporter.
                    If defined, the output is not displayed on screen by default. This can be changed with the -s parameter.
                    If not defined, then output will be displayed on screen, even if the parameter -s is not specified.
                    If more than one -o parameter is specified for one -f parameter, the last one is taken into consideration.
-s                - Forces putting output to to screen for a given -f parameter.
-c                - If specified, enables printing of test results in colors as defined by ANSICONSOLE standards. 
                    Works only on reporeters that support colors (ut_documentation_reporter).

Parameters -f, -o, -s are correlated. That is parameters -o and -s are controlling outputs for reporter specified by the preceding -f parameter.

~~Sonar and Coveralls reporter will only provide valid reports, when source_path and/or test_path are provided, and ut_run is executed from your project's root path.~~

Examples:

utplsql run hr/hr@xe -p=hr_test -f=ut_documentation_reporter -o=run.log -s -f=ut_coverage_html_reporter -o=coverage.html -source_path=source

Invokes all Unit tests from schema/package "hr_test" with two reporters:

ut_documentation_reporter - will output to screen and save output to file "run.log"
~~ut_coverage_html_reporter - will report only on database objects that are mapping to file structure from "source" folder and save output to file "coverage.html"~~

utplsql run hr/hr@xe

Invokes all unit test suites from schema "hr". Results are displayed to screen using default ut_documentation_reporter.

Enabling Color Outputs on Windows

To enable color outputs on Windows cmd you need to install an open-source utility called ANSICON.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!