utPLSQL for SQL Developer extends Oracle's SQL Developer to
- run utPLSQL unit tests
- debug utPLSQL unit tests
- run utPLSQL code coverage reports
- generate utPLSQL unit tests (skeletons)
- provide utPLSQL annotations and expectations as snippets
In the Connections window, select a connection or one or more packages or package procedures to run utPLSQL tests. Or you can run utPLSQL tests directly from the PL/SQL editor. The test procedures are determined according to the cursor position in the PL/SQL editor.
Select the tests to debug, the same way you would if you were just running them, but select Debug utPLSQL test... in the context menu.
And then the PL/SQL Debugger is called for the generated, anonymous PL/SQL block.
The initialization timeout for the realtime reporter is increased to 1 hour. The overall timeout is left to the default value of 4 hours. So you have enough time to step through the PL/SQL code and analyse it. Press the Stop button at any time to cancel the test run.
In the Connections window, select a connection or one or more packages for a code coverage report.
In the dialog you can set some parameters. If you run code coverage for a few chosen packages or from the PL/SQL editor the objects to be included are determined according the object dependencies in the Oracle data dictionary.
Press Run to produce the code coverage process in the background. You may minimize or close the dialog. To abort the process, press Cancel.
The HTML report is shown in your default browser.
Select a package, type, function or procedure to build a utPLSQL test package skeleton. The generated package compiles and executes, but still needs some rework.
- Press the button
Create code templatesin the preferences - Type
ut_in the Worksheet or a PL/SQL editor and pressCtrl-Spaceto get the list of a utPLSQL code templates - Press
Returnto paste a code template at the current cursor position
Import utPLSQL snippets for annotations and expectations via the the Import Snippets button of the utPLSQL preferences dialog.
Insert the snippets by drag & drop into your code.
Annotations are used in the package specification for various test configurations.
Expectations are used in the package body to compare actual with expected results.
Set your preferences to change the behaviour of utPLSQL within SQL Developer.
utPLSQL for SQL Developer implements the OddgenGenerator2 interface to
- run existing utPLSQL test suitepaths and test suites
- bulk generate new utPLSQL unit tests into dedicated files
The use of oddgen for SQL Developer is optional.
utPLSQL can run tests based on suitepaths and suites. The next screenshot shows the generated run command for two selected suitepaths.
Use oddgen to generate utPLSQL test package skeletons. When generating to files, a file for each package specification and package body is created.
Binary releases are published here.
-
Start SQL Developer
-
Select
Check for Updates…in the help menu. -
Use the
Install From Local Fileoption to install the previously downloadedutplsql_for_SQLDev_*.zipfile.
-
Start SQL Developer
-
Select
Check for Updates…in the help menu. -
Press
Add…to register thesalvis.comupdate sitehttp://update.salvis.com/. -
Use the
Search Update Centeroption and select thesalvis.comupdate center to install the lastest version ofutPLSQL for SQL Developer.
Please file your bug reports, enhancement requests, questions and other support requests within Github's issue tracker.
- Describe your idea by submitting an issue
- Fork the utPLSQL-SQLDeveloper repository
- Create a branch, commit and publish your changes and enhancements
- Create a pull request
-
Download and install SQL Developer 20.2.0
-
Download and install Apache Maven 3.6.3
-
Download and install a git command line client
-
Clone the utPLSQL-SQLDeveloper repository
-
Open a terminal window in the utPLSQL-SQLDeveloper root folder and type
cd sqldev -
Run maven build by the following command
mvn -Dsqldev.basedir=/Applications/SQLDeveloper20.2.0.app/Contents/Resources/sqldeveloper -DskipTests=true clean packageAmend the parameter sqldev.basedir to match the path of your SQL Developer installation. This folder is used to reference Oracle jar files which are not available in public Maven repositories
-
The resulting file
utplsql_for_SQLDev_x.x.x-SNAPSHOT.zipin thetargetdirectory can be installed within SQL Developer
utPLSQL for SQL Developer is licensed under the Apache License, Version 2.0. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.