Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Commit 1cc10a3

Browse files
AlexisGaldamezAlexisGaldamez
committed
Merge branch 'develop' of https://github.com/utPLSQL/utPLSQL into new_throws_annotation
2 parents 1d1d780 + 953ef6a commit 1cc10a3

5 files changed

Lines changed: 28 additions & 28 deletions

File tree

‎docs/index.md‎

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -45,13 +45,16 @@ Check out the sections on [annotations](userguide/annotations.md) and [expectati
4545

4646

4747
# Command line
48-
49-
The `ut_run` (for linux/unix) and `ut_run.bat` (for windows) are simple yet powerful.
50-
They can provide output from the tests on the fly.
5148

52-
You can also use it to have coloured outputs.
49+
You can use the utPLSQL command line client [utPLSQL-cli](https://github.com/utPLSQL/utPLSQL-cli) to run tests without the need for Oracle Client or any IDE like SQLDeveloper/TOAD etc.
50+
51+
Amongst many benefits they provide ability to:
52+
* see the progress of test execution for long-running tests - real-time reporting
53+
* use many reporting formats simultaneously and save reports to files (publish)
54+
* map your project source files and test files into database objects
5355

54-
Look into [utPLSQL-sql-cli](https://github.com/utPLSQL/utPLSQL-sql-cli) project to see more.
56+
Just download the [latest client](https://github.com/utPLSQL/utPLSQL-cli/releases/latest), download Oracle jdbc driver you are good to go.
57+
See [project readme](https://github.com/utPLSQL/utPLSQL-cli/blob/develop/README.md) for details.
5558

5659
# Coverage
5760

‎docs/userguide/reporters.md‎

Lines changed: 0 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -11,16 +11,6 @@ To invoke tests with documentation reporter use one of following calls from sql
1111

1212
`exec ut.run(ut_documentation_reporter());`
1313

14-
You may also invoke unit tests directly from command line by calling.
15-
16-
`ut_run user/pass@dbsid`
17-
18-
Invoking tests from command line tool `ut_run` allows you to track progress of test execution.
19-
In that case, the documentation reporter will provide information about each test that was executed as soon as it's execution finishes.
20-
For more details on using the `ut_run` script look into [utPLSQL-sql-cli](https://github.com/utPLSQL/utPLSQL-sql-cli) project.
21-
22-
The `ut_documentation_reporter` doesn't accept any arguments.
23-
2414
Example outputs from documentation reporter.
2515

2616
![doc_reporter_outputs](../images/documentation_reporter.png)

‎docs/userguide/running-unit-tests.md‎

Lines changed: 12 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -8,19 +8,25 @@ The utPLSQL framework provides two main entry points to run unit tests from with
88
These two entry points differ in purpose and behavior.
99
Most of the time you will want to use `ut.run` as `ut_runner` is designed for API integration and does not output the results to the screen directly.
1010

11-
# utPLSQL-sql-cli
11+
# Running from CI servers and command line
1212

13-
If you are considering running your tests from a command line or from a CI server like Jenkins/Teamcity, the best way is to use the [utPLSQL-sql-cli](https://github.com/utPLSQL/utPLSQL-sql-cli).
14-
You may download the latest release of the command line client automatically using the command below (Unix).
13+
The best way to run your tests from CI server or command line is to use the [utPLSQL-cli](https://github.com/utPLSQL/utPLSQL-cli) command line client.
14+
15+
Amongst many benefits it provides ability to:
16+
* see the progress of test execution for long-running tests - real-time reporting
17+
* use many reporting formats simultaneously and save reports to files (publish)
18+
* map your project source files and test files into database objects
19+
20+
You may download the latest release of the command line client from [here](https://github.com/utPLSQL/utPLSQL-cli/releases/latest) or do it automatically using the command below (Unix).
1521

1622
```bash
1723
#!/bin/bash
1824
# Get the url to latest release "zip" file
19-
DOWNLOAD_URL=$(curl --silent https://api.github.com/repos/utPLSQL/utPLSQL-sql-cli/releases/latest | awk '/zipball_url/ { print $2 }' | sed -r 's/"|,//g')
25+
DOWNLOAD_URL=$(curl --silent https://api.github.com/repos/utPLSQL/utPLSQL-cli/releases/latest | awk '/zipball_url/ { print $2 }' | sed -r 's/"|,//g')
2026
# Download the latest release "zip" file
21-
curl -Lk "${DOWNLOAD_URL}" -o utplsql-sql-cli.zip
27+
curl -Lk "${DOWNLOAD_URL}" -o utplsql-cli.zip
2228
# Extract downloaded "zip" file
23-
unzip -q utplsql-sql-cli.zip
29+
unzip -q utplsql-cli.zip
2430
```
2531

2632
# ut.run

‎readme.md‎

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ The framework follows industry standards and best patterns of modern Unit Testin
3232
- Integration with SonarQube, Coveralls, Jenkins and Teamcity with [reporters](docs/userguide/reporters.md)
3333
- plugin architecture for reporters and matchers
3434
- flexible and simple test invocation
35-
- multi-reporting from test-run from [command line](https://github.com/utPLSQL/utPLSQL-sql-cli)
35+
- multi-reporting from test-run from [command line](https://github.com/utPLSQL/utPLSQL-cli)
3636

3737
Requirements:
3838
- Version of Oracle under [extended support](http://www.oracle.com/us/support/library/lifetime-support-technology-069183.pdf) (Currently 11.2 and above)
@@ -73,17 +73,18 @@ select * from table(ut.run());
7373

7474
The above commands will run all the suites in the current schema and provide report to dbms_output or as a select statement.
7575

76-
# Command line clients
76+
# Command line client
7777

78-
To have more control over how the tests are invoked, use one of the utPLSQL command line clients: [utPLSQL-sql-cli](https://github.com/utPLSQL/utPLSQL-sql-cli) or [utPLSQL-cli](https://github.com/utPLSQL/utPLSQL-cli).
78+
You can use the utPLSQL command line client [utPLSQL-cli](https://github.com/utPLSQL/utPLSQL-cli) to run tests without the need for Oracle Client or any IDE like SQLDeveloper/TOAD etc.
7979

80-
To use `utPLSQL-sql-cli` you will need to have SQLPlus installed. `utPLSQL-cli` is Java project, so no additional software is needed.
81-
82-
Amongst many benefits they provide ability to:
80+
Amongst many benefits it provides ability to:
8381
* see the progress of test execution for long-running tests - real-time reporting
8482
* use many reporting formats simultaneously and save reports to files (publish)
8583
* map your project source files and test files into database objects
8684

85+
Just download the [latest client](https://github.com/utPLSQL/utPLSQL-cli/releases/latest), download Oracle jdbc driver you are good to go.
86+
See [project readme](https://github.com/utPLSQL/utPLSQL-cli/blob/develop/README.md) for details.
87+
8788

8889
# Example unit test packages
8990

‎source/core/ut_utils.pks‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ create or replace package ut_utils authid definer is
2121
*
2222
*/
2323

24-
gc_version constant varchar2(50) := 'v3.0.4.1573-develop';
24+
gc_version constant varchar2(50) := 'v3.0.4.1577-develop';
2525

2626
/* Constants: Event names */
2727
gc_run constant varchar2(12) := 'run';

0 commit comments

Comments
 (0)