nunit 2.4.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- data/docs/addinsDialog.html +74 -0
- data/docs/assertions.html +91 -0
- data/docs/attributes.html +89 -0
- data/docs/category.html +265 -0
- data/docs/classicModel.html +92 -0
- data/docs/codeFuncs.js +77 -0
- data/docs/collectionAssert.html +162 -0
- data/docs/collectionConstraints.html +130 -0
- data/docs/comparisonAsserts.html +271 -0
- data/docs/comparisonConstraints.html +109 -0
- data/docs/compoundConstraints.html +97 -0
- data/docs/conditionAsserts.html +123 -0
- data/docs/conditionConstraints.html +106 -0
- data/docs/configEditor.html +93 -0
- data/docs/configFiles.html +155 -0
- data/docs/consoleCommandLine.html +271 -0
- data/docs/constraintModel.html +134 -0
- data/docs/contextMenu.html +106 -0
- data/docs/culture.html +255 -0
- data/docs/customAsserts.html +115 -0
- data/docs/customConstraints.html +101 -0
- data/docs/description.html +178 -0
- data/docs/equalConstraint.html +139 -0
- data/docs/equalityAsserts.html +187 -0
- data/docs/exception.html +296 -0
- data/docs/explicit.html +256 -0
- data/docs/extensibility.html +83 -0
- data/docs/favicon.ico +0 -0
- data/docs/features.html +75 -0
- data/docs/fileAssert.html +114 -0
- data/docs/files/QuickStart.Spanish.doc +0 -0
- data/docs/files/QuickStart.doc +0 -0
- data/docs/files/Results.xsd +70 -0
- data/docs/files/Summary.xslt +47 -0
- data/docs/files/TestResult.xml +103 -0
- data/docs/files/Thumbs.db +0 -0
- data/docs/fixtureSetup.html +201 -0
- data/docs/fixtureTeardown.html +204 -0
- data/docs/getStarted.html +80 -0
- data/docs/guiCommandLine.html +183 -0
- data/docs/identityAsserts.html +99 -0
- data/docs/ignore.html +249 -0
- data/docs/img/addinsDialog.JPG +0 -0
- data/docs/img/assembliesTab.jpg +0 -0
- data/docs/img/assemblyReloadOptions.JPG +0 -0
- data/docs/img/bulletOff.gif +0 -0
- data/docs/img/bulletOn.gif +0 -0
- data/docs/img/configEditor.jpg +0 -0
- data/docs/img/console-mock.jpg +0 -0
- data/docs/img/displayTab.jpg +0 -0
- data/docs/img/generalOptions.jpg +0 -0
- data/docs/img/generalTab.jpg +0 -0
- data/docs/img/gui-screenshot.jpg +0 -0
- data/docs/img/gui-verify.jpg +0 -0
- data/docs/img/langFilter.gif +0 -0
- data/docs/img/logo.gif +0 -0
- data/docs/img/miniGui.jpg +0 -0
- data/docs/img/optionsDialog.jpg +0 -0
- data/docs/img/resultTab.jpg +0 -0
- data/docs/img/testLoadOptions.jpg +0 -0
- data/docs/img/testOutputOptions.jpg +0 -0
- data/docs/img/testProperties.jpg +0 -0
- data/docs/img/testResultOptions.JPG +0 -0
- data/docs/img/testTab.jpg +0 -0
- data/docs/img/testsTab.JPG +0 -0
- data/docs/img/textOutputOptions.jpg +0 -0
- data/docs/img/treeDisplayOptions.JPG +0 -0
- data/docs/img/visualStudioOptions.JPG +0 -0
- data/docs/index.html +75 -0
- data/docs/installation.html +172 -0
- data/docs/license.html +88 -0
- data/docs/listMapper.html +100 -0
- data/docs/mainMenu.html +260 -0
- data/docs/multiAssembly.html +130 -0
- data/docs/nunit-console.html +84 -0
- data/docs/nunit-gui.html +115 -0
- data/docs/nunit.css +118 -0
- data/docs/nunitAddins.html +331 -0
- data/docs/optionsDialog.html +262 -0
- data/docs/platform.html +285 -0
- data/docs/platformSupport.html +99 -0
- data/docs/projectEditor.html +127 -0
- data/docs/property.html +219 -0
- data/docs/propertyConstraint.html +89 -0
- data/docs/quickStart.html +314 -0
- data/docs/releaseNotes.html +1235 -0
- data/docs/sameasConstraint.html +98 -0
- data/docs/samples.html +126 -0
- data/docs/setCulture.html +173 -0
- data/docs/setup.html +199 -0
- data/docs/setupFixture.html +198 -0
- data/docs/stringAssert.html +107 -0
- data/docs/stringConstraints.html +111 -0
- data/docs/suite.html +222 -0
- data/docs/teardown.html +204 -0
- data/docs/test.html +171 -0
- data/docs/testFixture.html +168 -0
- data/docs/testProperties.html +76 -0
- data/docs/typeAsserts.html +101 -0
- data/docs/typeConstraints.html +103 -0
- data/docs/upgrade.html +97 -0
- data/docs/utilityAsserts.html +108 -0
- data/docs/vsSupport.html +140 -0
- data/lib/net-1.1/Failure.jpg +0 -0
- data/lib/net-1.1/Ignored.jpg +0 -0
- data/lib/net-1.1/NUnitFitTests.html +277 -0
- data/lib/net-1.1/NUnitTests.config +84 -0
- data/lib/net-1.1/NUnitTests.nunit +14 -0
- data/lib/net-1.1/Success.jpg +0 -0
- data/lib/net-1.1/clr.bat +96 -0
- data/lib/net-1.1/fit.dll +0 -0
- data/lib/net-1.1/loadtest-assembly.dll +0 -0
- data/lib/net-1.1/mock-assembly.dll +0 -0
- data/lib/net-1.1/nonamespace-assembly.dll +0 -0
- data/lib/net-1.1/notestfixtures-assembly.dll +0 -0
- data/lib/net-1.1/nunit-console-runner.dll +0 -0
- data/lib/net-1.1/nunit-console.exe +0 -0
- data/lib/net-1.1/nunit-console.exe.config +117 -0
- data/lib/net-1.1/nunit-console.tests.dll +0 -0
- data/lib/net-1.1/nunit-gui-runner.dll +0 -0
- data/lib/net-1.1/nunit-gui.tests.dll +0 -0
- data/lib/net-1.1/nunit.core.dll +0 -0
- data/lib/net-1.1/nunit.core.extensions.dll +0 -0
- data/lib/net-1.1/nunit.core.interfaces.dll +0 -0
- data/lib/net-1.1/nunit.core.tests.dll +0 -0
- data/lib/net-1.1/nunit.exe +0 -0
- data/lib/net-1.1/nunit.exe.config +121 -0
- data/lib/net-1.1/nunit.extensions.tests.dll +0 -0
- data/lib/net-1.1/nunit.fixtures.dll +0 -0
- data/lib/net-1.1/nunit.fixtures.tests.dll +0 -0
- data/lib/net-1.1/nunit.framework.dll +0 -0
- data/lib/net-1.1/nunit.framework.extensions.dll +0 -0
- data/lib/net-1.1/nunit.framework.tests.dll +0 -0
- data/lib/net-1.1/nunit.framework.xml +5622 -0
- data/lib/net-1.1/nunit.mocks.dll +0 -0
- data/lib/net-1.1/nunit.mocks.tests.dll +0 -0
- data/lib/net-1.1/nunit.uikit.dll +0 -0
- data/lib/net-1.1/nunit.uikit.tests.dll +0 -0
- data/lib/net-1.1/nunit.util.dll +0 -0
- data/lib/net-1.1/nunit.util.tests.dll +0 -0
- data/lib/net-1.1/runFile.exe +0 -0
- data/lib/net-1.1/runFile.exe.config +43 -0
- data/lib/net-1.1/test-assembly.dll +0 -0
- data/lib/net-1.1/test-utilities.dll +0 -0
- data/lib/net-1.1/timing-tests.dll +0 -0
- data/lib/net-2.0/Failure.jpg +0 -0
- data/lib/net-2.0/Ignored.jpg +0 -0
- data/lib/net-2.0/NUnitFitTests.html +277 -0
- data/lib/net-2.0/NUnitTests.config +84 -0
- data/lib/net-2.0/NUnitTests.nunit +14 -0
- data/lib/net-2.0/Success.jpg +0 -0
- data/lib/net-2.0/clr.bat +96 -0
- data/lib/net-2.0/fit.dll +0 -0
- data/lib/net-2.0/loadtest-assembly.dll +0 -0
- data/lib/net-2.0/mock-assembly.dll +0 -0
- data/lib/net-2.0/nonamespace-assembly.dll +0 -0
- data/lib/net-2.0/notestfixtures-assembly.dll +0 -0
- data/lib/net-2.0/nunit-console-runner.dll +0 -0
- data/lib/net-2.0/nunit-console-x86.exe +0 -0
- data/lib/net-2.0/nunit-console-x86.exe.config +117 -0
- data/lib/net-2.0/nunit-console.exe +0 -0
- data/lib/net-2.0/nunit-console.exe.config +117 -0
- data/lib/net-2.0/nunit-console.tests.dll +0 -0
- data/lib/net-2.0/nunit-gui-runner.dll +0 -0
- data/lib/net-2.0/nunit-gui.tests.dll +0 -0
- data/lib/net-2.0/nunit-x86.exe +0 -0
- data/lib/net-2.0/nunit-x86.exe.config +121 -0
- data/lib/net-2.0/nunit.core.dll +0 -0
- data/lib/net-2.0/nunit.core.extensions.dll +0 -0
- data/lib/net-2.0/nunit.core.interfaces.dll +0 -0
- data/lib/net-2.0/nunit.core.tests.dll +0 -0
- data/lib/net-2.0/nunit.exe +0 -0
- data/lib/net-2.0/nunit.exe.config +121 -0
- data/lib/net-2.0/nunit.extensions.tests.dll +0 -0
- data/lib/net-2.0/nunit.fixtures.dll +0 -0
- data/lib/net-2.0/nunit.fixtures.tests.dll +0 -0
- data/lib/net-2.0/nunit.framework.dll +0 -0
- data/lib/net-2.0/nunit.framework.extensions.dll +0 -0
- data/lib/net-2.0/nunit.framework.tests.dll +0 -0
- data/lib/net-2.0/nunit.framework.xml +5622 -0
- data/lib/net-2.0/nunit.mocks.dll +0 -0
- data/lib/net-2.0/nunit.mocks.tests.dll +0 -0
- data/lib/net-2.0/nunit.uikit.dll +0 -0
- data/lib/net-2.0/nunit.uikit.tests.dll +0 -0
- data/lib/net-2.0/nunit.util.dll +0 -0
- data/lib/net-2.0/nunit.util.tests.dll +0 -0
- data/lib/net-2.0/runFile.exe +0 -0
- data/lib/net-2.0/runFile.exe.config +43 -0
- data/lib/net-2.0/test-assembly.dll +0 -0
- data/lib/net-2.0/test-utilities.dll +0 -0
- data/lib/net-2.0/timing-tests.dll +0 -0
- metadata +262 -0
|
@@ -0,0 +1,271 @@
|
|
|
1
|
+
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN">
|
|
2
|
+
<html>
|
|
3
|
+
<!-- Standard Head Part -->
|
|
4
|
+
<head>
|
|
5
|
+
<title>NUnit - ConsoleCommandLine</title>
|
|
6
|
+
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
|
|
7
|
+
<meta http-equiv="Content-Language" content="en-US">
|
|
8
|
+
<link rel="stylesheet" type="text/css" href="nunit.css">
|
|
9
|
+
<link rel="shortcut icon" href="favicon.ico">
|
|
10
|
+
</head>
|
|
11
|
+
<!-- End Standard Head Part -->
|
|
12
|
+
|
|
13
|
+
<body>
|
|
14
|
+
|
|
15
|
+
<!-- Standard Header for NUnit.org -->
|
|
16
|
+
<div id="header">
|
|
17
|
+
<a id="logo" href="http://www.nunit.org"><img src="img/logo.gif" alt="NUnit.org" title="NUnit.org"></a>
|
|
18
|
+
<div id="nav">
|
|
19
|
+
<a href="http://www.nunit.org">NUnit</a>
|
|
20
|
+
<a class="active" href="index.html">Documentation</a>
|
|
21
|
+
</div>
|
|
22
|
+
</div>
|
|
23
|
+
<!-- End of Header -->
|
|
24
|
+
|
|
25
|
+
<div id="content">
|
|
26
|
+
|
|
27
|
+
<h2>NUnit-Console Command Line Options</h2>
|
|
28
|
+
<p>The console interface has a few additional options compared to the forms
|
|
29
|
+
interface. The command line must always specify one or more file names. The
|
|
30
|
+
console interface always creates an XML representation of the test results.
|
|
31
|
+
This file by default is called TestResult.xml and is placed in the working
|
|
32
|
+
directory.</p>
|
|
33
|
+
<p><b>Note:</b> By default the nunit-console program is not added to your path. You
|
|
34
|
+
must do this manually if this is the desired behavior.</p>
|
|
35
|
+
<p><b>Note:</b> Under the Windows operating system, options may be prefixed by either
|
|
36
|
+
a forward slash or a hyphen. Under Linux, a hyphen must be used. Options that
|
|
37
|
+
take values may use an equal sign, a colon or a space to separate the option
|
|
38
|
+
from its value.</p>
|
|
39
|
+
<h4>Specifying an Assembly</h4>
|
|
40
|
+
The console program must always have an assembly or project specified. To run
|
|
41
|
+
the tests contained in the nunit.tests.dll use the following command:
|
|
42
|
+
<pre class="programtext"> nunit-console nunit.tests.dll</pre>
|
|
43
|
+
</p>
|
|
44
|
+
<p>To run the tests in nunit.tests.dll through the Visual Studio project, use:
|
|
45
|
+
<pre class="programtext"> nunit-console nunit.tests.csproj</pre>
|
|
46
|
+
</p>
|
|
47
|
+
<p>To run the same tests through an NUnit test project you have defined, use:
|
|
48
|
+
<pre class="programtext"> nunit-console nunit.tests.nunit</pre>
|
|
49
|
+
</p>
|
|
50
|
+
<h4>Specifying an Assembly and a Test to be Run</h4>
|
|
51
|
+
<p>You may specify a test to be run by proviig the full name of the test along
|
|
52
|
+
with the containing assembly. For example to run NUnit.Tests.AssertionTests
|
|
53
|
+
in the nunit.tests assembly use the following command:
|
|
54
|
+
<pre class="programtext"> nunit-console /run:NUnit.Tests.AssertionTests nunit.tests.dll</pre>
|
|
55
|
+
|
|
56
|
+
<p>The name of the test to be run may be that of a test case, test fixture or
|
|
57
|
+
a namespace. Unlike the <b>/fixture</b> option, this option affects the running
|
|
58
|
+
rather than the loading of the tests. Consequently it supports much broader use,
|
|
59
|
+
including situations involving SetUpFixtures, which are not run if the class
|
|
60
|
+
in question is not loaded. You should use <b>/run</b> in lieu of <b>/fixture</b>
|
|
61
|
+
in most cases.
|
|
62
|
+
|
|
63
|
+
<h4>Specifying an Assembly and a Fixture to be Loaded</h4>
|
|
64
|
+
<p>When specifying a fixture, you must give the full name of the test fixture
|
|
65
|
+
along with the containing assembly. For example, to load the
|
|
66
|
+
NUnit.Tests.AssertionTests in the nunit.tests.dll assembly use the following
|
|
67
|
+
command:
|
|
68
|
+
<pre class="programtext"> nunit-console /fixture:NUnit.Tests.AssertionTests nunit.tests.dll</pre>
|
|
69
|
+
</p>
|
|
70
|
+
<p>The name specified after the <b>/fixture</b> option may be that of a TestFixture
|
|
71
|
+
class, a legacy suite (using the Suite property ) or a namespace. If a
|
|
72
|
+
namespace is given, then all fixtures under that namespace are loaded.</p>
|
|
73
|
+
<p>This option is provided for backward compatibility. In most cases, you will
|
|
74
|
+
be better served by using the <b>/run</b> option.
|
|
75
|
+
|
|
76
|
+
<h4>Specifying the Version of the CLR</h4>
|
|
77
|
+
|
|
78
|
+
<p>Most applications are written to run under a specific version of the CLR.
|
|
79
|
+
A few are designed to operate correctly under multiple versions. In either case,
|
|
80
|
+
it is important to be able to specify the CLR version to be used for testing.</p>
|
|
81
|
+
|
|
82
|
+
<p>When only one version of the CLR is used, the config files for nunit-gui and
|
|
83
|
+
nunit-console may be set up to specify that version. As a more convenient
|
|
84
|
+
alternative when switching CLRs, you may use the provided <b>clr.bat</b>
|
|
85
|
+
command to specify the version under which NUnit should run.</p>
|
|
86
|
+
|
|
87
|
+
<p>For example, to run the tests in nunit.tests.dll under the RTM version of
|
|
88
|
+
the .Net 2.0 framework, use:</p>
|
|
89
|
+
|
|
90
|
+
<pre class="programtext"> clr net-2.0 nunit-console nunit.tests.dll</pre>
|
|
91
|
+
|
|
92
|
+
<p>The <b>clr.bat</b> file is located in the NUnit <b>bin</b> directory. You may
|
|
93
|
+
put this on your path, or copy it to a convenient location. Enter <b>clr /?</b>
|
|
94
|
+
for a list of options.</p>
|
|
95
|
+
|
|
96
|
+
<p><b>Note:</b> If you use a <startup> section in the config file, it takes
|
|
97
|
+
precedence over this option.</p>
|
|
98
|
+
|
|
99
|
+
<p><b>Note:</b> This command is specific to the Microsoft .Net
|
|
100
|
+
framework. The Mono framework provides other means to specify the version
|
|
101
|
+
to be used when running a command.</p>
|
|
102
|
+
|
|
103
|
+
<h4>Specifying Test Categories to Include or Exclude</h4>
|
|
104
|
+
<p>NUnit provides CategoryAttribute for use in marking tests as belonging to
|
|
105
|
+
one or more categories. Categories may be included or excluded in a test run
|
|
106
|
+
using the <b>/include</b> and <b>/exclude</b> options. The following command
|
|
107
|
+
runs only the tests in the BaseLine category:
|
|
108
|
+
<pre class="programtext"> nunit-console myassembly.dll /include:BaseLine</pre>
|
|
109
|
+
</p>
|
|
110
|
+
<p>The following command runs all tests <b>except</b> those in the Database
|
|
111
|
+
category:
|
|
112
|
+
<pre class="programtext"> nunit-console myassembly.dll /exclude:Database</pre>
|
|
113
|
+
</p>
|
|
114
|
+
<p>
|
|
115
|
+
Multiple categories may be specified on either option, by using commas to
|
|
116
|
+
separate them.
|
|
117
|
+
<p><b>Notes:</b> Beginning with NUnit 2.4, the /include and /exclude options may
|
|
118
|
+
be combined on the command line. When both are used, all tests with the included
|
|
119
|
+
categories are run except for those with the excluded categories.</p>
|
|
120
|
+
|
|
121
|
+
<p>Beginning with NUnit 2.4.6, you may use a <b>Category Expression</b> with either
|
|
122
|
+
of these options:
|
|
123
|
+
<dl>
|
|
124
|
+
<dt>A|B|C
|
|
125
|
+
<dd>Selects tests having any of the categories A, B or C.
|
|
126
|
+
<dt>A,B,C
|
|
127
|
+
<dd>Selects tests having any of the categories A, B or C.
|
|
128
|
+
<dt>A+B+C
|
|
129
|
+
<dd>Selects only tests having all three of the categories assigned
|
|
130
|
+
<dt>A+B|C
|
|
131
|
+
<dd>Selects tests with both A and B OR with category C.
|
|
132
|
+
<dt>A+B-C
|
|
133
|
+
<dd>Selects tests with both A and B but not C.
|
|
134
|
+
<dt>-A
|
|
135
|
+
<dd>Selects tests not having category A assigned
|
|
136
|
+
<dt>A+(B|C)
|
|
137
|
+
<dd>Selects tests having both category A and either of B or C
|
|
138
|
+
</dl>
|
|
139
|
+
<p>The comma operator is equivalent to | but has a higher precendence. Order
|
|
140
|
+
of evaluation is as follows:
|
|
141
|
+
<ol>
|
|
142
|
+
<li>Unary exclusion operator (-)
|
|
143
|
+
<li>High-precendence union operator (,)
|
|
144
|
+
<li>Intersection and set subtraction operators (+ and binary -)
|
|
145
|
+
<li>Low-precedence union operator (|)
|
|
146
|
+
</ol>
|
|
147
|
+
|
|
148
|
+
|
|
149
|
+
<p>For a clear understanding of how category
|
|
150
|
+
selection works, review the documentation for both the
|
|
151
|
+
<a href="category.html">Category Attribute</a> and the
|
|
152
|
+
<a href="explicit.html">Explicit Attribute</a>.</p>
|
|
153
|
+
<h4>Redirecting Output</h4>
|
|
154
|
+
<p>The output that is normally shown on the console may be redirected to a file.
|
|
155
|
+
This includes output created by the test program as well as what NUnit itself
|
|
156
|
+
creates. The following command redirects standard output to the TestResult.txt
|
|
157
|
+
file:
|
|
158
|
+
<pre class="programtext"> nunit-console nunit.tests.dll /out:TestResult.txt</pre>
|
|
159
|
+
</p>
|
|
160
|
+
<p>The following command redirects standard error output to the StdErr.txt file.
|
|
161
|
+
<pre class="programtext"> nunit-console nunit.tests.dll /err:StdErr.txt</pre>
|
|
162
|
+
</p>
|
|
163
|
+
<h4>Labeling Test Output</h4>
|
|
164
|
+
<p>The output from each test normally follows right after that of the preceding
|
|
165
|
+
test. You may use the <b>/labels</b> option to cause an identifying label to be
|
|
166
|
+
displayed at the start of each test case.</p>
|
|
167
|
+
<h4>Specifying the XML file name</h4>
|
|
168
|
+
<p>As stated above, the console program always creates an XML representation of the
|
|
169
|
+
test results. To change the name of the output file to
|
|
170
|
+
"console-test.xml" use the following command line option:
|
|
171
|
+
<pre class="programtext"> nunit-console /xml:console-test.xml nunit.tests.dll</pre>
|
|
172
|
+
</p>
|
|
173
|
+
<h4>Specifying the Transform file</h4>
|
|
174
|
+
<p>The console interface uses XSLT to transform the test results from the XML file
|
|
175
|
+
to what is printed to the screen when the program executes. The console
|
|
176
|
+
interface has a default transformation that is part of the executable. To
|
|
177
|
+
specify your own transformation named "myTransform.xslt" use the
|
|
178
|
+
following command line option:
|
|
179
|
+
<pre class="programtext"> nunit-console /transform:myTransform.xslt nunit.tests.dll</pre>
|
|
180
|
+
</p>
|
|
181
|
+
<p><b>Note:</b> For additional information see the XML schema for the test results.
|
|
182
|
+
This file is in the same directory as the executable and is called
|
|
183
|
+
<a href="files/Results.xsd">Results.xsd</a>.
|
|
184
|
+
The default transform <a href="files/Summary.xslt">Summary.xslt</a> is located in the core source directory.</p>
|
|
185
|
+
<h4>Specifying which Configuration to run</h4>
|
|
186
|
+
<p>When running tests from a Visual Studio or NUnit project, the first
|
|
187
|
+
configuration found will be loaded by default. Usually this is Debug. The
|
|
188
|
+
configuration loaded may be controlled by using the <b>/config</b> switch. The
|
|
189
|
+
following will load and run tests for the Release configuration of
|
|
190
|
+
nunit.tests.dll.
|
|
191
|
+
<pre class="programtext"> nunit-console nunit.tests.csproj /config:Release</pre>
|
|
192
|
+
</p>
|
|
193
|
+
<p><b>Note:</b> This option has no effect when loading an assembly directly.</p>
|
|
194
|
+
<h4>Specifying Multiple Assemblies</h4>
|
|
195
|
+
<p>You may run tests from multiple assemblies in one run using the console
|
|
196
|
+
interface even if you have not defined an NUnit test project file. The
|
|
197
|
+
following command would run a suite of tests contained in assembly1.dll,
|
|
198
|
+
assembly2.dll and assembly3.dll.
|
|
199
|
+
<pre class="programtext"> nunit-console assembly1.dll assembly2.dll assembly3.dll</pre>
|
|
200
|
+
</p>
|
|
201
|
+
<p><b>Notes:</b> You may specify multiple assemblies, but not multiple NUnit or
|
|
202
|
+
Visual Studio projects on the command line. Further, you may not specify an
|
|
203
|
+
NUnit or Visual Studio project together with a list of assemblies.</p>
|
|
204
|
+
<p>Beginning with NUnit 2.4, the console loads multiple assemblies specified
|
|
205
|
+
in this way into separate AppDomains by default. You may provide a separate
|
|
206
|
+
config file for each assembly. You may override the default by use of the
|
|
207
|
+
<b>/domain</b> option.
|
|
208
|
+
<p>Beginning with NUnit 2.4, the <b>/fixture</b>
|
|
209
|
+
option, when used with multiple assemblies, will run tests matching the
|
|
210
|
+
fixture name in all the assemblies. In earlier versions, only the first
|
|
211
|
+
test found was executed.</p>
|
|
212
|
+
<h4>Controlling the Use of AppDomains</h4>
|
|
213
|
+
<p>The <b>/domain</b> option controls of the creation of AppDomains for running tests.
|
|
214
|
+
The following values are recognized:</p>
|
|
215
|
+
<dl style="margin-left: 2em">
|
|
216
|
+
<dt><b>None</b>
|
|
217
|
+
<dd>No domain is created - the tests are run in the primary domain. This normally
|
|
218
|
+
requires copying the <b>NUnit</b> assemblies into the same directory as your tests.
|
|
219
|
+
<dt><b>Single</b>
|
|
220
|
+
<dd>A test domain is created - this is how NUnit worked prior to version 2.4
|
|
221
|
+
<dt><b>Multiple</b>
|
|
222
|
+
<dd>A separate test domain is created for each assembly
|
|
223
|
+
</dl>
|
|
224
|
+
<p>The default is to use multiple domains if multiple assemblies are listed on
|
|
225
|
+
the command line. Otherwise a single domain is used.</p>
|
|
226
|
+
<h4>Other Options</h4>
|
|
227
|
+
<p>The <b>/noshadow</b> option disables shadow copying of the assembly in order to
|
|
228
|
+
provide improved performance.</p>
|
|
229
|
+
<p>The <b>/nothread</b> option suppresses use of a separate thread for running the
|
|
230
|
+
tests and uses the main thread instead.</p>
|
|
231
|
+
<p>The <b>/wait</b> option causes the program to wait for user input before
|
|
232
|
+
exiting. This is useful when running nunit-console from a shortcut.</p>
|
|
233
|
+
<p>The <b>/xmlconsole</b> option displays raw XML output on the console rather than
|
|
234
|
+
transforming it. This is useful when debugging problems with the XML format.</p>
|
|
235
|
+
<p>The <b>/nologo</b> option disables display of the copyright information at the
|
|
236
|
+
start of the program.</p>
|
|
237
|
+
<p>The <b>/help</b> or <b>/?</b> option displays a brief help message</p>
|
|
238
|
+
|
|
239
|
+
</div>
|
|
240
|
+
|
|
241
|
+
<!-- Submenu -->
|
|
242
|
+
<div id="subnav">
|
|
243
|
+
<ul>
|
|
244
|
+
<li><a href="index.html">NUnit 2.4.8</a></li>
|
|
245
|
+
<ul>
|
|
246
|
+
<li><a href="getStarted.html">Getting Started</a></li>
|
|
247
|
+
<li><a href="assertions.html">Assertions</a></li>
|
|
248
|
+
<li><a href="attributes.html">Attributes</a></li>
|
|
249
|
+
<li><a href="nunit-console.html">Console Runner</a></li>
|
|
250
|
+
<ul>
|
|
251
|
+
<li id="current"><a href="consoleCommandLine.html">Command-Line</a></li>
|
|
252
|
+
</ul>
|
|
253
|
+
<li><a href="nunit-gui.html">Gui Runner</a></li>
|
|
254
|
+
<li><a href="features.html">Other Features</a></li>
|
|
255
|
+
<li><a href="releaseNotes.html">Release Notes</a></li>
|
|
256
|
+
<li><a href="samples.html">Samples</a></li>
|
|
257
|
+
<li><a href="license.html">License</a></li>
|
|
258
|
+
</ul>
|
|
259
|
+
</ul>
|
|
260
|
+
</div>
|
|
261
|
+
<!-- End of Submenu -->
|
|
262
|
+
|
|
263
|
+
|
|
264
|
+
<!-- Standard Footer for NUnit.org -->
|
|
265
|
+
<div id="footer">
|
|
266
|
+
Copyright © 2008 Charlie Poole. All Rights Reserved.
|
|
267
|
+
</div>
|
|
268
|
+
<!-- End of Footer -->
|
|
269
|
+
|
|
270
|
+
</body>
|
|
271
|
+
</html>
|
|
@@ -0,0 +1,134 @@
|
|
|
1
|
+
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN">
|
|
2
|
+
<html>
|
|
3
|
+
<!-- Standard Head Part -->
|
|
4
|
+
<head>
|
|
5
|
+
<title>NUnit - ConstraintModel</title>
|
|
6
|
+
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
|
|
7
|
+
<meta http-equiv="Content-Language" content="en-US">
|
|
8
|
+
<link rel="stylesheet" type="text/css" href="nunit.css">
|
|
9
|
+
<link rel="shortcut icon" href="favicon.ico">
|
|
10
|
+
</head>
|
|
11
|
+
<!-- End Standard Head Part -->
|
|
12
|
+
|
|
13
|
+
<body>
|
|
14
|
+
|
|
15
|
+
<!-- Standard Header for NUnit.org -->
|
|
16
|
+
<div id="header">
|
|
17
|
+
<a id="logo" href="http://www.nunit.org"><img src="img/logo.gif" alt="NUnit.org" title="NUnit.org"></a>
|
|
18
|
+
<div id="nav">
|
|
19
|
+
<a href="http://www.nunit.org">NUnit</a>
|
|
20
|
+
<a class="active" href="index.html">Documentation</a>
|
|
21
|
+
</div>
|
|
22
|
+
</div>
|
|
23
|
+
<!-- End of Header -->
|
|
24
|
+
|
|
25
|
+
<div id="content">
|
|
26
|
+
|
|
27
|
+
<h2>Constraint-Based Assert Model (NUnit 2.4)</h2>
|
|
28
|
+
|
|
29
|
+
<p>The constraint-based Assert model uses a single method of the Assert class
|
|
30
|
+
for all assertions. The logic necessary to carry out each assertion is
|
|
31
|
+
embedded in the constraint object passed as the second parameter to that
|
|
32
|
+
method.
|
|
33
|
+
|
|
34
|
+
<p>Here's a very simple assert using the constraint model:
|
|
35
|
+
<pre> Assert.That( myString, Is.EqualTo("Hello") );</pre>
|
|
36
|
+
|
|
37
|
+
<p>The second argument in this assertion uses one of NUnit's <b>syntax helpers</b>
|
|
38
|
+
to create an <b>EqualConstraint</b>. The same assertion could also be made in this form:
|
|
39
|
+
<pre> Assert.That( myString, new EqualConstraint("Hello") );</pre>
|
|
40
|
+
|
|
41
|
+
<p>Using this model, all assertions are made using one of the forms of the
|
|
42
|
+
Assert.That() method, which has a number of overloads...
|
|
43
|
+
|
|
44
|
+
<div class="code" style="width: 36em">
|
|
45
|
+
<pre>Assert.That( object actual, IConstraint constraint )
|
|
46
|
+
Assert.That( object actual, IConstraint constraint, string message )
|
|
47
|
+
Assert.That( object actual, IConstraint constraint, string message,
|
|
48
|
+
object[] parms )
|
|
49
|
+
|
|
50
|
+
Assert.That( bool condition );
|
|
51
|
+
Assert.That( bool condition, string message );
|
|
52
|
+
Assert.That( bool condition, string message, object[] parms );</pre>
|
|
53
|
+
</div>
|
|
54
|
+
|
|
55
|
+
<p>If you derive your test fixture class from <b>AssertionHelper</b>, the
|
|
56
|
+
Expect() method may be used in place of Assert.That()...
|
|
57
|
+
|
|
58
|
+
<div class="code" style="width: 36em">
|
|
59
|
+
<pre>Expect( object actual, IConstraint constraint )
|
|
60
|
+
Expect( object actual, IConstraint constraint, string message )
|
|
61
|
+
Expect( object actual, IConstraint constraint, string message,
|
|
62
|
+
object[] parms )
|
|
63
|
+
|
|
64
|
+
Expect( bool condition );
|
|
65
|
+
Expect( bool condition, string message );
|
|
66
|
+
Expect( bool condition, string message, object[] parms );</pre>
|
|
67
|
+
</div>
|
|
68
|
+
|
|
69
|
+
<p>The overloads that take a bool work exactly like Assert.IsTrue.
|
|
70
|
+
|
|
71
|
+
<p>For overloads taking a constraint, the argument must be a object implementing
|
|
72
|
+
the <b>IConstraint</b> interface, which supports performing a test
|
|
73
|
+
on an actual value and generating appropriate messages. This interface
|
|
74
|
+
is described in more detail under
|
|
75
|
+
<a href="customConstraints.html">Custom Constraints</a>.
|
|
76
|
+
|
|
77
|
+
<p>NUnit provides a number of constraint classes similar to the <b>EqualConstraint</b>
|
|
78
|
+
used in the example above. Generally, these classes may be used directly or
|
|
79
|
+
through a syntax helper. Test fixture classes inheriting from <b>AssertionHelper</b>
|
|
80
|
+
are able to use shorter forms. The valid forms are described on the pages related to
|
|
81
|
+
each constraint. Note that the menu items listed to the right generally reflect the
|
|
82
|
+
names of the syntax helpers.
|
|
83
|
+
|
|
84
|
+
<p><b>See also:</b> the
|
|
85
|
+
<a href="classicModel.html">classic model</a> of assertions.
|
|
86
|
+
|
|
87
|
+
|
|
88
|
+
</div>
|
|
89
|
+
|
|
90
|
+
<!-- Submenu -->
|
|
91
|
+
<div id="subnav">
|
|
92
|
+
<ul>
|
|
93
|
+
<li><a href="index.html">NUnit 2.4.8</a></li>
|
|
94
|
+
<ul>
|
|
95
|
+
<li><a href="getStarted.html">Getting Started</a></li>
|
|
96
|
+
<li><a href="assertions.html">Assertions</a></li>
|
|
97
|
+
<ul>
|
|
98
|
+
<li><a href="classicModel.html">Classic Model</a></li>
|
|
99
|
+
<li id="current"><a href="constraintModel.html">Constraint Model</a></li>
|
|
100
|
+
<ul>
|
|
101
|
+
<li><a href="equalConstraint.html">Equal Constraint</a></li>
|
|
102
|
+
<li><a href="sameasConstraint.html">SameAs Constraint</a></li>
|
|
103
|
+
<li><a href="conditionConstraints.html">Condition Constraints</a></li>
|
|
104
|
+
<li><a href="comparisonConstraints.html">Comparison Constrants</a></li>
|
|
105
|
+
<li><a href="typeConstraints.html">Type Constraints</a></li>
|
|
106
|
+
<li><a href="stringConstraints.html">String Constraints</a></li>
|
|
107
|
+
<li><a href="collectionConstraints.html">Collection Constraints</a></li>
|
|
108
|
+
<li><a href="propertyConstraint.html">Property Constraint</a></li>
|
|
109
|
+
<li><a href="compoundConstraints.html">Compound Constraints</a></li>
|
|
110
|
+
<li><a href="customConstraints.html">Custom Constraints</a></li>
|
|
111
|
+
<li><a href="listMapper.html">List Mapper</a></li>
|
|
112
|
+
</ul>
|
|
113
|
+
</ul>
|
|
114
|
+
<li><a href="attributes.html">Attributes</a></li>
|
|
115
|
+
<li><a href="nunit-console.html">Console Runner</a></li>
|
|
116
|
+
<li><a href="nunit-gui.html">Gui Runner</a></li>
|
|
117
|
+
<li><a href="features.html">Other Features</a></li>
|
|
118
|
+
<li><a href="releaseNotes.html">Release Notes</a></li>
|
|
119
|
+
<li><a href="samples.html">Samples</a></li>
|
|
120
|
+
<li><a href="license.html">License</a></li>
|
|
121
|
+
</ul>
|
|
122
|
+
</ul>
|
|
123
|
+
</div>
|
|
124
|
+
<!-- End of Submenu -->
|
|
125
|
+
|
|
126
|
+
|
|
127
|
+
<!-- Standard Footer for NUnit.org -->
|
|
128
|
+
<div id="footer">
|
|
129
|
+
Copyright © 2008 Charlie Poole. All Rights Reserved.
|
|
130
|
+
</div>
|
|
131
|
+
<!-- End of Footer -->
|
|
132
|
+
|
|
133
|
+
</body>
|
|
134
|
+
</html>
|
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN">
|
|
2
|
+
<html>
|
|
3
|
+
<!-- Standard Head Part -->
|
|
4
|
+
<head>
|
|
5
|
+
<title>NUnit - ContextMenu</title>
|
|
6
|
+
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
|
|
7
|
+
<meta http-equiv="Content-Language" content="en-US">
|
|
8
|
+
<link rel="stylesheet" type="text/css" href="nunit.css">
|
|
9
|
+
<link rel="shortcut icon" href="favicon.ico">
|
|
10
|
+
</head>
|
|
11
|
+
<!-- End Standard Head Part -->
|
|
12
|
+
|
|
13
|
+
<body>
|
|
14
|
+
|
|
15
|
+
<!-- Standard Header for NUnit.org -->
|
|
16
|
+
<div id="header">
|
|
17
|
+
<a id="logo" href="http://www.nunit.org"><img src="img/logo.gif" alt="NUnit.org" title="NUnit.org"></a>
|
|
18
|
+
<div id="nav">
|
|
19
|
+
<a href="http://www.nunit.org">NUnit</a>
|
|
20
|
+
<a class="active" href="index.html">Documentation</a>
|
|
21
|
+
</div>
|
|
22
|
+
</div>
|
|
23
|
+
<!-- End of Header -->
|
|
24
|
+
|
|
25
|
+
<div id="content">
|
|
26
|
+
|
|
27
|
+
<h2>Context Menu</h2>
|
|
28
|
+
|
|
29
|
+
<p>The context menu is displayed when one of the tree nodes is right-clicked.</p>
|
|
30
|
+
|
|
31
|
+
<h4>Run</h4>
|
|
32
|
+
<p>Runs the selected test - disabled if a test is running.</p>
|
|
33
|
+
|
|
34
|
+
<h4>Run All</h4>
|
|
35
|
+
<p>Runs all the tests.</p>
|
|
36
|
+
|
|
37
|
+
<h4>Run Failed</h4>
|
|
38
|
+
<p>Runs only the tests that failed on the previous run.</p>
|
|
39
|
+
|
|
40
|
+
<h4>Show Checkboxes</h4>
|
|
41
|
+
<p>Turns the display of checkboxes in the tree on or off. The checkboxes may
|
|
42
|
+
be used to select multiple tests for running.</p>
|
|
43
|
+
|
|
44
|
+
<h4>Expand</h4>
|
|
45
|
+
<p>Expands the selected test node � invisible if the node is expanded or has no children.</p>
|
|
46
|
+
|
|
47
|
+
<h4>Collapse</h4>
|
|
48
|
+
<p>Collapses the selected test node � invisible if the node is collapsed or has no children.</p>
|
|
49
|
+
|
|
50
|
+
<h4>Expand All</h4>
|
|
51
|
+
<p>Expands all nodes of the tree.</p>
|
|
52
|
+
|
|
53
|
+
<h4>Collapse All</h4>
|
|
54
|
+
<p>Collapses all nodes in the tree to the root.</p>
|
|
55
|
+
|
|
56
|
+
<h4>Load Fixture</h4>
|
|
57
|
+
<p>Reloads only the currently selected fixture or namespace. The fixture,
|
|
58
|
+
once loaded, remains in effect through any subsequent reloads. This generally
|
|
59
|
+
results in substantial reduction in load time.</p>
|
|
60
|
+
|
|
61
|
+
<h4>Clear Fixture</h4>
|
|
62
|
+
<p>Reloads all the tests, clearing the currently loaded fixture.</p>
|
|
63
|
+
|
|
64
|
+
<h4>Properties</h4>
|
|
65
|
+
<p>Displays the <a href="testProperties.html">Test Properties</a> for the selected test node.</p>
|
|
66
|
+
|
|
67
|
+
</div>
|
|
68
|
+
|
|
69
|
+
<!-- Submenu -->
|
|
70
|
+
<div id="subnav">
|
|
71
|
+
<ul>
|
|
72
|
+
<li><a href="index.html">NUnit 2.4.8</a></li>
|
|
73
|
+
<ul>
|
|
74
|
+
<li><a href="getStarted.html">Getting Started</a></li>
|
|
75
|
+
<li><a href="assertions.html">Assertions</a></li>
|
|
76
|
+
<li><a href="attributes.html">Attributes</a></li>
|
|
77
|
+
<li><a href="nunit-console.html">Console Runner</a></li>
|
|
78
|
+
<li><a href="nunit-gui.html">Gui Runner</a></li>
|
|
79
|
+
<ul>
|
|
80
|
+
<li><a href="guiCommandLine.html">Command-Line</a></li>
|
|
81
|
+
<li><a href="mainMenu.html">Main Menu</a></li>
|
|
82
|
+
<li id="current"><a href="contextMenu.html">Context Menu</a></li>
|
|
83
|
+
<li><a href="optionsDialog.html">Options Dialog</a></li>
|
|
84
|
+
<li><a href="addinsDialog.html">Addins Dialog</a></li>
|
|
85
|
+
<li><a href="testProperties.html">Test Properties</a></li>
|
|
86
|
+
<li><a href="configEditor.html">Configuration Editor</a></li>
|
|
87
|
+
<li><a href="projectEditor.html">Project Editor</a></li>
|
|
88
|
+
</ul>
|
|
89
|
+
<li><a href="features.html">Other Features</a></li>
|
|
90
|
+
<li><a href="releaseNotes.html">Release Notes</a></li>
|
|
91
|
+
<li><a href="samples.html">Samples</a></li>
|
|
92
|
+
<li><a href="license.html">License</a></li>
|
|
93
|
+
</ul>
|
|
94
|
+
</ul>
|
|
95
|
+
</div>
|
|
96
|
+
<!-- End of Submenu -->
|
|
97
|
+
|
|
98
|
+
|
|
99
|
+
<!-- Standard Footer for NUnit.org -->
|
|
100
|
+
<div id="footer">
|
|
101
|
+
Copyright © 2008 Charlie Poole. All Rights Reserved.
|
|
102
|
+
</div>
|
|
103
|
+
<!-- End of Footer -->
|
|
104
|
+
|
|
105
|
+
</body>
|
|
106
|
+
</html>
|