summaryrefslogtreecommitdiff
path: root/src/documentation/content/xdocs/PythonBrokerTest.html
blob: 94b1f0598b9733a6671fd549ececf90a829e82f7 (plain)
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
<html>
    <head>
        <title>Apache Qpid : PythonBrokerTest</title>
	    <link rel="stylesheet" href="styles/site.css" type="text/css" />
        <META http-equiv="Content-Type" content="text/html; charset=UTF-8">	    
    </head>

    <body>
	    <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff">
		    <tr>
			    <td valign="top" class="pagebody">
				    <div class="pageheader">
					    <span class="pagetitle">
                            Apache Qpid : PythonBrokerTest
                                                    </span>
				    </div>
				    <div class="pagesubheading">
					    This page last changed on Oct 19, 2006 by <font color="#0050B2">mmccorma</font>.
				    </div>

				    <h2><a name="PythonBrokerTest-PythonBrokerSystemTestSuite"></a>Python Broker System Test Suite </h2>

<p>This is a suite of python client tests that exercise and verify broker functionality. Python allows us to rapidly develop client test scenarios and provides a 'neutral' set of tests that can run against any AMQP-compliant broker.</p>

<p>The python/tests directory contains a collection of python modules, each containing several unittest classes, each containing a set of test methods that represent some test scenario. Test classes inheirt <tt>qpid.TestBas</tt> from <tt>qpid/testlib.py</tt>, it inherits <tt>unittest.TestCase</tt> but adds some qpid-specific <tt>setUp/tearDown</tt> and convenience functions. </p>

<p>TODO: get pydoc generated up to qpid wiki or website automatically?</p>

<h3><a name="PythonBrokerTest-Runningthetests"></a>Running the tests </h3>

<p>Simplest way to run the tests:</p>

<ul>
	<li>Run a broker on the default port</li>
	<li><tt>./run_tests</tt></li>
</ul>


<p>For additional options: <tt>./run_tests --help</tt></p>

<h3><a name="PythonBrokerTest-Expectedfailures"></a>Expected failures </h3>

<p>Until we complete functionality, tests may fail because the tested<br/>
functionality is missing in the broker. To skip expected failures<br/>
in the C++ or Java brokers:</p>
<div class="code"><div class="codeContent">
<pre class="code-java">./run_tests -I cpp_failing.txt
 ./run_tests -I java_failing.txt</pre>
</div></div>
<p>If you fix a failure, please remove it from the corresponding list.</p>


				    
                    			    </td>
		    </tr>
	    </table>
	    <table border="0" cellpadding="0" cellspacing="0" width="100%">
			<tr>
				<td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td>
			</tr>
		    <tr>
			    <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td>
		    </tr>
	    </table>
    </body>
</html>