1 from DocXMLRPCServer
import DocXMLRPCServer
3 from test
import test_support
11 def server(evt
, numrequests
):
13 serv
= DocXMLRPCServer(("localhost", 0), logRequests
=False)
16 PORT
= serv
.socket
.getsockname()[1]
18 # Add some documentation
19 serv
.set_server_title("DocXMLRPCServer Test Documentation")
20 serv
.set_server_name("DocXMLRPCServer Test Docs")
21 serv
.set_server_documentation(
22 """This is an XML-RPC server's documentation, but the server can be used by
23 POSTing to /RPC2. Try self.add, too.""")
25 # Create and register classes and functions
26 class TestClass(object):
27 def test_method(self
, arg
):
28 """Test method's docs. This method truly does very little."""
31 serv
.register_introspection_functions()
32 serv
.register_instance(TestClass())
35 """Add two instances together. This follows PEP008, but has nothing
36 to do with RFC1952. Case should matter: pEp008 and rFC1952. Things
37 that start with http and ftp should be auto-linked, too:
42 serv
.register_function(add
)
43 serv
.register_function(lambda x
, y
: x
-y
)
45 while numrequests
> 0:
48 except socket
.timeout
:
55 class DocXMLRPCHTTPGETServer(unittest
.TestCase
):
57 # Enable server feedback
58 DocXMLRPCServer
._send
_traceback
_header
= True
60 self
.evt
= threading
.Event()
61 threading
.Thread(target
=server
, args
=(self
.evt
, 1)).start()
63 # wait for port to be assigned
65 while n
> 0 and PORT
is None:
69 self
.client
= httplib
.HTTPConnection("localhost:%d" % PORT
)
76 # Disable server feedback
77 DocXMLRPCServer
._send
_traceback
_header
= False
79 def test_valid_get_response(self
):
80 self
.client
.request("GET", "/")
81 response
= self
.client
.getresponse()
83 self
.assertEqual(response
.status
, 200)
84 self
.assertEqual(response
.getheader("Content-type"), "text/html")
86 # Server throws an exception if we don't start to read the data
89 def test_invalid_get_response(self
):
90 self
.client
.request("GET", "/spam")
91 response
= self
.client
.getresponse()
93 self
.assertEqual(response
.status
, 404)
94 self
.assertEqual(response
.getheader("Content-type"), "text/plain")
98 def test_lambda(self
):
99 """Test that lambda functionality stays the same. The output produced
100 currently is, I suspect invalid because of the unencoded brackets in the
103 The subtraction lambda method is tested.
105 self
.client
.request("GET", "/")
106 response
= self
.client
.getresponse()
109 """<dl><dt><a name="-<lambda>"><strong><lambda></strong></a>(x, y)</dt></dl>"""
112 def test_autolinking(self
):
113 """Test that the server correctly automatically wraps references to PEPS
114 and RFCs with links, and that it linkifies text starting with http or
115 ftp protocol prefixes.
117 The documentation for the "add" method contains the test material.
119 self
.client
.request("GET", "/")
120 response
= self
.client
.getresponse()
122 self
.assert_( # This is ugly ... how can it be made better?
123 """<dl><dt><a name="-add"><strong>add</strong></a>(x, y)</dt><dd><tt>Add two instances together. This follows <a href="http://www.python.org/dev/peps/pep-0008/">PEP008</a>, but has nothing<br>\nto do with <a href="http://www.rfc-editor.org/rfc/rfc1952.txt">RFC1952</a>. Case should matter: pEp008 and rFC1952. Things<br>\nthat start with http and ftp should be auto-linked, too:<br>\n<a href="http://google.com">http://google.com</a>.</tt></dd></dl>"""
126 def test_system_methods(self
):
127 """Test the precense of three consecutive system.* methods.
129 This also tests their use of parameter type recognition and the systems
130 related to that process.
132 self
.client
.request("GET", "/")
133 response
= self
.client
.getresponse()
136 """<dl><dt><a name="-system.listMethods"><strong>system.listMethods</strong></a>()</dt><dd><tt><a href="#-system.listMethods">system.listMethods</a>() => [\'add\', \'subtract\', \'multiple\']<br>\n <br>\nReturns a list of the methods supported by the server.</tt></dd></dl>\n <dl><dt><a name="-system.methodHelp"><strong>system.methodHelp</strong></a>(method_name)</dt><dd><tt><a href="#-system.methodHelp">system.methodHelp</a>(\'add\') => "Adds two integers together"<br>\n <br>\nReturns a string containing documentation for the specified method.</tt></dd></dl>\n <dl><dt><a name="-system.methodSignature"><strong>system.methodSignature</strong></a>(method_name)</dt><dd><tt><a href="#-system.methodSignature">system.methodSignature</a>(\'add\') => [double, int, int]<br>\n <br>\nReturns a list describing the signature of the method. In the<br>\nabove example, the add method takes two integers as arguments<br>\nand returns a double result.<br>\n <br>\nThis server does NOT support system.methodSignature.</tt></dd></dl>"""
139 def test_autolink_dotted_methods(self
):
140 """Test that selfdot values are made strong automatically in the
142 self
.client
.request("GET", "/")
143 response
= self
.client
.getresponse()
145 self
.assert_("""Try self.<strong>add</strong>, too.""" in
149 test_support
.run_unittest(DocXMLRPCHTTPGETServer
)
151 if __name__
== '__main__':