2015-06-22 13:12:20 +00:00
|
|
|
{% extends "docframe.html" %} {% block body %}
|
2012-06-23 23:14:54 +00:00
|
|
|
<div class="page-header">
|
2015-06-22 13:12:20 +00:00
|
|
|
<h1>
|
2012-06-23 23:14:54 +00:00
|
|
|
libpathod.test
|
2015-06-22 13:12:20 +00:00
|
|
|
<small>Using libpathod in unit tests.</small>
|
2012-06-23 23:14:54 +00:00
|
|
|
</h1>
|
|
|
|
</div>
|
2012-07-30 08:58:59 +00:00
|
|
|
|
2015-06-22 13:12:20 +00:00
|
|
|
<p>The <b>libpathod.test</b> module is a light, flexible testing layer for HTTP clients.
|
|
|
|
It works by firing up a Pathod instance in a separate thread, letting you use Pathod's
|
|
|
|
full abilities to generate responses, and then query Pathod's internal logs to establish
|
|
|
|
what happened. All the mechanics of startup, shutdown, finding free ports and so forth
|
|
|
|
are taken care of for you.
|
|
|
|
</p>
|
2012-07-30 08:58:59 +00:00
|
|
|
|
2015-06-22 13:12:20 +00:00
|
|
|
<p>The canonical docs can be accessed using pydoc: </p>
|
2012-07-30 08:58:59 +00:00
|
|
|
|
2015-06-22 13:12:20 +00:00
|
|
|
<pre class="terminal">pydoc libpathod.test</pre>
|
2012-07-30 08:58:59 +00:00
|
|
|
|
2015-06-22 13:12:20 +00:00
|
|
|
<p>
|
|
|
|
The remainder of this page demonstrates some common interaction patterns using
|
|
|
|
<a
|
|
|
|
href="http://nose.readthedocs.org/en/latest/">nose</a>. These examples are also applicable with only minor modification to most
|
|
|
|
commonly used Python testing engines.
|
|
|
|
</p>
|
2012-07-30 08:58:59 +00:00
|
|
|
|
2015-06-22 13:12:20 +00:00
|
|
|
<section>
|
|
|
|
<div class="page-header">
|
|
|
|
<h1>Context Manager</h1>
|
2012-07-30 08:58:59 +00:00
|
|
|
</div>
|
|
|
|
|
2015-06-22 13:12:20 +00:00
|
|
|
{% include "examples_context.html" %}
|
|
|
|
</section>
|
2012-07-30 08:58:59 +00:00
|
|
|
|
2015-06-22 13:12:20 +00:00
|
|
|
<section>
|
|
|
|
<div class="page-header">
|
|
|
|
<h1>One instance per test</h1>
|
2012-07-30 08:58:59 +00:00
|
|
|
</div>
|
|
|
|
|
2015-06-22 13:12:20 +00:00
|
|
|
{% include "examples_setup.html" %}
|
|
|
|
</section>
|
2012-07-30 08:58:59 +00:00
|
|
|
|
2015-06-22 13:12:20 +00:00
|
|
|
<section>
|
|
|
|
<div class="page-header">
|
|
|
|
<h1>One instance per suite</h1>
|
|
|
|
</div>
|
2012-07-30 08:58:59 +00:00
|
|
|
|
2015-06-22 13:12:20 +00:00
|
|
|
{% include "examples_setupall.html" %}
|
|
|
|
</section>
|
|
|
|
{% endblock %}
|