forked from KenRoytman/utPLSQL
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathdefsuite.html
executable file
·110 lines (85 loc) · 3.75 KB
/
defsuite.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
<!-- WARNING! This file is generated. -->
<!-- To alter documentation, edit files in src directory -->
<html><head>
<title>Defining Test Suites</title>
<link rel="stylesheet" href="utplsql.css" content="text/css">
<meta name="keywords" content="utPLSQL, PL\SQL, Unit Testing, Framework, Oracle"/>
<meta name="description" content="Unit Testing PL\SQL"/>
<meta name="title" content="Defining Test Suites"/>
<meta name="author" content="Steven Feuerstein, Chris Rimmer, Patrick Barel"/>
<meta name="copyright" content="(C) 2000-2005 Steven Feuerstein, Chris Rimmer, Patrick Barel"/>
</head><body>
<div class="purple_bar"><a href="index.html"><img src="utplsql.jpg" border=0></a></div>
<p>[ <A href="index.html">Home</A>
| <A href="started.html">Getting Started</A>
| <A href="buildpack.html">Build Test Packages</A>
| <A href="examples.html">Examples</A>
| <A href="userguide.html">User Guide</A>
| <A href="release.html">Release Notes</A>
| <A href="map.html">Document Map</A> ]</p>
<p><A href="utreceq.html">< Previous Section: utRecEq Package</A> | <A href="reporter.html">Next Section: Custom Reporter Packages ></A></p>
<!-- Begin utPLSQL Body -->
<!-- $Id: defsuite.html,v 1.4 2005/05/10 14:23:03 chrisrimmer Exp $ -->
<h1>
Defining Test Suites</h1>
If you define test suites and register packages
within those suites, then utPLSQL will run an unlimited number of
tests with a single command.
<h3>Note</h3>
<ul type="disc">
<li>
All suite names are stored in upper case.</li>
<li>
If you do not specify a directory (dir_in),
you will need to call utConfig.setdir if you want automatic compilation
of your packages to occur.</li>
<li>If you supply a value for seq_in, packages
will be compiled and tested in ascending numeric sequence order.</li>
<li>When you call utSuite.rem, it will remove all
packages for that suite by calling utPackage.rem.</li>
</ul>
<h2>
utSuite - Define Test Suites</h2>
To create and remove test suites, call these programs:
<pre>
PROCEDURE utSuite.add (
name_in IN VARCHAR2,
desc_in IN VARCHAR2 := NULL,
rem_if_exists_in IN BOOLEAN := TRUE
);
PROCEDURE utSuite.rem (name_in IN VARCHAR2);</pre>
These programs manipulate the contents of the ut_suite
table. See the tables.sql file for the DDL creating this table.
<h2>
utPackage - Define Test Packages for a Suite</h2>
To register a package in a suite, call the following:
<pre> PROCEDURE utPackage.add (
suite_in IN VARCHAR2,
package_in IN VARCHAR2,
samepackage_in IN BOOLEAN := FALSE,
prefix_in IN VARCHAR2 := NULL,
dir_in IN VARCHAR2 := NULL,
seq_in IN PLS_INTEGER := NULL,
owner_in IN VARCHAR2 := NULL,
add_tests_in IN BOOLEAN := FALSE,
test_overloads_in IN BOOLEAN := FALSE
);</pre>
This manipulates the contents of the ut_package
table. See the tables.sql file for the DDL creating this table.
Here is a sample script that defines a very small
portion of the PL/Vision test suite:
<pre>BEGIN
utSuite.add ('PLVision');
utPackage.add
'PLVision', 'PLVstr', dir_in => 'e:\utplsql\test');
utPackage.add (
'PLVision', 'PLVdate', dir_in => 'e:\utplsql\test'');
utPLSQL.testsuite ('PLVision', recompile_in => TRUE);
END;
/</pre>
<!-- End utPLSQL Body -->
<p><A href="utreceq.html">< Previous Section: utRecEq Package</A> | <A href="reporter.html">Next Section: Custom Reporter Packages ></A></p>
<div class="purple_bar"><a href="index.html"><img src="utplsql.jpg" border=0></a></div>
<p class="copyright">Copyright (C) 2000-2005 <A href="mailto:[email protected]">Steven Feuerstein<A>, <A href="mailto:[email protected]">Chris Rimmer<A>, <A href="mailto:[email protected]">Patrick Barel<A> All rights reserved</p>
</body></html>