/usr/share/doc/python-nose-doc/html/testing.html is in python-nose-doc 1.3.4-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Testing with nose — nose 1.3.4 documentation</title>
<link rel="stylesheet" href="_static/nose.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: './',
VERSION: '1.3.4',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<link rel="top" title="nose 1.3.4 documentation" href="index.html" />
<link rel="next" title="Basic usage" href="usage.html" />
<link rel="prev" title="Installation and quick start" href="index.html" />
</head>
<body>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="py-modindex.html" title="Python Module Index"
>modules</a> |</li>
<li class="right" >
<a href="usage.html" title="Basic usage"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="index.html" title="Installation and quick start"
accesskey="P">previous</a> |</li>
<li><a href="index.html">nose 1.3.4 documentation</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body">
<div class="section" id="testing-with-nose">
<h1>Testing with nose<a class="headerlink" href="#testing-with-nose" title="Permalink to this headline">¶</a></h1>
<div class="section" id="writing-tests-is-easier">
<h2>Writing tests is easier<a class="headerlink" href="#writing-tests-is-easier" title="Permalink to this headline">¶</a></h2>
<p>nose collects tests from <tt class="xref py py-class docutils literal"><span class="pre">unittest.TestCase</span></tt> subclasses, of course. But
you can also write simple test functions, as well as test classes that are
<em>not</em> subclasses of <tt class="xref py py-class docutils literal"><span class="pre">unittest.TestCase</span></tt>. nose also supplies a number of
helpful functions for writing timed tests, testing for exceptions, and other
common use cases. See <a class="reference internal" href="writing_tests.html"><em>Writing tests</em></a> and <a class="reference internal" href="testing_tools.html"><em>Testing tools</em></a> for more.</p>
</div>
<div class="section" id="running-tests-is-easier">
<h2>Running tests is easier<a class="headerlink" href="#running-tests-is-easier" title="Permalink to this headline">¶</a></h2>
<p>nose collects tests automatically, as long as you follow some simple
guidelines for organizing your library and test code. There’s no need
to manually collect test cases into test suites. Running tests is
responsive, since nose begins running tests as soon as the first test
module is loaded. See <a class="reference internal" href="finding_tests.html"><em>Finding and running tests</em></a> for more.</p>
</div>
<div class="section" id="setting-up-your-test-environment-is-easier">
<h2>Setting up your test environment is easier<a class="headerlink" href="#setting-up-your-test-environment-is-easier" title="Permalink to this headline">¶</a></h2>
<p>nose supports fixtures at the package, module, class, and test case
level, so expensive initialization can be done as infrequently as
possible. See <a class="reference internal" href="writing_tests.html#fixtures"><em>Fixtures</em></a> for more.</p>
</div>
<div class="section" id="doing-what-you-want-to-do-is-easier">
<h2>Doing what you want to do is easier<a class="headerlink" href="#doing-what-you-want-to-do-is-easier" title="Permalink to this headline">¶</a></h2>
<p>nose comes with a number of <a class="reference internal" href="plugins/builtin.html"><em>builtin plugins</em></a> to help
you with output capture, error introspection, code coverage, doctests, and
more. It also comes with plugin hooks for loading, running, watching and
reporting on tests and test runs. If you don’t like the default collection
scheme, or it doesn’t suit the layout of your project, or you need reports in
a format different from the unittest standard, or you need to collect some
additional information about tests (like code coverage or profiling data), you
can write a plugin to make nose do what you want. See the section on
<a class="reference internal" href="plugins/writing.html"><em>Writing Plugins</em></a> for more. There are also many
<a class="reference external" href="http://nose-plugins.jottit.com/">third-party nose plugins</a> available.</p>
</div>
<div class="section" id="details">
<h2>Details<a class="headerlink" href="#details" title="Permalink to this headline">¶</a></h2>
<div class="toctree-wrapper compound">
<ul>
<li class="toctree-l1"><a class="reference internal" href="usage.html">Basic usage</a><ul>
<li class="toctree-l2"><a class="reference internal" href="usage.html#extended-usage">Extended usage</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="writing_tests.html">Writing tests</a><ul>
<li class="toctree-l2"><a class="reference internal" href="writing_tests.html#fixtures">Fixtures</a></li>
<li class="toctree-l2"><a class="reference internal" href="writing_tests.html#test-packages">Test packages</a></li>
<li class="toctree-l2"><a class="reference internal" href="writing_tests.html#test-modules">Test modules</a></li>
<li class="toctree-l2"><a class="reference internal" href="writing_tests.html#test-classes">Test classes</a></li>
<li class="toctree-l2"><a class="reference internal" href="writing_tests.html#test-functions">Test functions</a></li>
<li class="toctree-l2"><a class="reference internal" href="writing_tests.html#test-generators">Test generators</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="finding_tests.html">Finding and running tests</a></li>
<li class="toctree-l1"><a class="reference internal" href="testing_tools.html">Testing tools</a><ul>
<li class="toctree-l2"><a class="reference internal" href="testing_tools.html#tools-for-testing">Tools for testing</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="plugins/builtin.html">Batteries included: builtin nose plugins</a><ul>
<li class="toctree-l2"><a class="reference internal" href="plugins/allmodules.html">AllModules: collect tests in all modules</a></li>
<li class="toctree-l2"><a class="reference internal" href="plugins/attrib.html">Attrib: tag and select tests with attributes</a></li>
<li class="toctree-l2"><a class="reference internal" href="plugins/capture.html">Capture: capture stdout during tests</a></li>
<li class="toctree-l2"><a class="reference internal" href="plugins/collect.html">Collect: Collect tests quickly</a></li>
<li class="toctree-l2"><a class="reference internal" href="plugins/cover.html">Cover: code coverage</a></li>
<li class="toctree-l2"><a class="reference internal" href="plugins/debug.html">Debug: drop into pdb on errors or failures</a></li>
<li class="toctree-l2"><a class="reference internal" href="plugins/deprecated.html">Deprecated: mark tests as deprecated</a></li>
<li class="toctree-l2"><a class="reference internal" href="plugins/doctests.html">Doctests: run doctests with nose</a></li>
<li class="toctree-l2"><a class="reference internal" href="plugins/failuredetail.html">Failure Detail: introspect asserts</a></li>
<li class="toctree-l2"><a class="reference internal" href="plugins/isolate.html">Isolate: protect tests from (some) side-effects</a></li>
<li class="toctree-l2"><a class="reference internal" href="plugins/logcapture.html">Logcapture: capture logging during tests</a></li>
<li class="toctree-l2"><a class="reference internal" href="plugins/multiprocess.html">Multiprocess: parallel testing</a></li>
<li class="toctree-l2"><a class="reference internal" href="plugins/prof.html">Prof: enable profiling using the hotshot profiler</a></li>
<li class="toctree-l2"><a class="reference internal" href="plugins/skip.html">Skip: mark tests as skipped</a></li>
<li class="toctree-l2"><a class="reference internal" href="plugins/testid.html">Testid: add a test id to each test name output</a></li>
<li class="toctree-l2"><a class="reference internal" href="plugins/xunit.html">Xunit: output test results in xunit format</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="plugins/other.html">Third-party nose plugins</a></li>
<li class="toctree-l1"><a class="reference internal" href="setuptools_integration.html">Setuptools integration</a><ul>
<li class="toctree-l2"><a class="reference internal" href="setuptools_integration.html#nosetests-command"><cite>nosetests</cite> command</a></li>
</ul>
</li>
</ul>
</div>
</div>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar">
<div class="sphinxsidebarwrapper">
<h3><a href="index.html">Table Of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">Testing with nose</a><ul>
<li><a class="reference internal" href="#writing-tests-is-easier">Writing tests is easier</a></li>
<li><a class="reference internal" href="#running-tests-is-easier">Running tests is easier</a></li>
<li><a class="reference internal" href="#setting-up-your-test-environment-is-easier">Setting up your test environment is easier</a></li>
<li><a class="reference internal" href="#doing-what-you-want-to-do-is-easier">Doing what you want to do is easier</a></li>
<li><a class="reference internal" href="#details">Details</a></li>
</ul>
</li>
</ul>
<h4>Previous topic</h4>
<p class="topless"><a href="index.html"
title="previous chapter">Installation and quick start</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="usage.html"
title="next chapter">Basic usage</a></p>
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="_sources/testing.txt"
rel="nofollow">Show Source</a></li>
</ul>
<div id="searchbox" style="display: none">
<h3>Quick search</h3>
<form class="search" action="search.html" method="get">
<input type="text" name="q" />
<input type="submit" value="Go" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
<p class="searchtip" style="font-size: 90%">
Enter search terms or a module, class or function name.
</p>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="py-modindex.html" title="Python Module Index"
>modules</a> |</li>
<li class="right" >
<a href="usage.html" title="Basic usage"
>next</a> |</li>
<li class="right" >
<a href="index.html" title="Installation and quick start"
>previous</a> |</li>
<li><a href="index.html">nose 1.3.4 documentation</a> »</li>
</ul>
</div>
<div class="footer">
© Copyright 2009, Jason Pellerin.
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.2.2.
</div>
</body>
</html>
|