如何对自定义HTTP请求处理器进行单元测试



我有一个自定义的HTTP请求处理程序,可以简化为如下内容:

# Python 3:
from http import server
class MyHandler(server.BaseHTTPRequestHandler):
    def do_GET(self):
        self.send_response(200)
        self.send_header("Content-type", "text/html")
        self.end_headers()
        # Here's where all the complicated logic is done to generate HTML.
        # For clarity here, replace with a simple stand-in:
        html = "<html><p>hello world</p></html>"
        self.wfile.write(html.encode())

我想单元测试这个处理程序(即确保我的do_GET执行没有异常)没有实际启动web服务器。是否有任何轻量级的方法来模拟SimpleHTTPServer,以便我可以测试此代码?

扩展jakevdp的答案,我也能够检查输出:

try:
    import unittest2 as unittest
except ImportError:
    import unittest
try:
    from io import BytesIO as IO
except ImportError:
    from StringIO import StringIO as IO
from server import MyHandlerSSL  # My BaseHTTPRequestHandler child

class TestableHandler(MyHandlerSSL):
    # On Python3, in socketserver.StreamRequestHandler, if this is
    # set it will use makefile() to produce the output stream. Otherwise,
    # it will use socketserver._SocketWriter, and we won't be able to get
    # to the data
    wbufsize = 1
    def finish(self):
        # Do not close self.wfile, so we can read its value
        self.wfile.flush()
        self.rfile.close()
    def date_time_string(self, timestamp=None):
        """ Mocked date time string """
        return 'DATETIME'
    def version_string(self):
        """ mock the server id """
        return 'BaseHTTP/x.x Python/x.x.x'

class MockSocket(object):
    def getsockname(self):
        return ('sockname',)

class MockRequest(object):
    _sock = MockSocket()
    def __init__(self, path):
        self._path = path
    def makefile(self, *args, **kwargs):
        if args[0] == 'rb':
            return IO(b"GET %s HTTP/1.0" % self._path)
        elif args[0] == 'wb':
            return IO(b'')
        else:
            raise ValueError("Unknown file type to make", args, kwargs)

class HTTPRequestHandlerTestCase(unittest.TestCase):
    maxDiff = None
    def _test(self, request):
        handler = TestableHandler(request, (0, 0), None)
        return handler.wfile.getvalue()
    def test_unauthenticated(self):
        self.assertEqual(
                self._test(MockRequest(b'/')),
                b"""HTTP/1.0 401 Unauthorizedr
Server: BaseHTTP/x.x Python/x.x.xr
Date: DATETIMEr
WWW-Authenticate: Basic realm="MyRealm", charset="UTF-8"r
Content-type: text/htmlr
r
<html><head><title>Authentication Failed</title></html><body><h1>Authentication Failed</h1><p>Authentication Failed. Authorised Personnel Only.</p></body></html>"""
                )

def main():
    unittest.main()

if __name__ == "__main__":
    main()

我正在测试的代码返回401未经授权的"/"。根据您的测试用例更改响应。

这是我想到的一种模拟服务器的方法。请注意,这应该与Python 2和Python 3兼容。唯一的问题是,我找不到一种方法来访问GET请求的结果,但至少测试将捕获它遇到的任何异常!

try:
    # Python 2.x
    import BaseHTTPServer as server
    from StringIO import StringIO as IO
except ImportError:
    # Python 3.x
    from http import server
    from io import BytesIO as IO

class MyHandler(server.BaseHTTPRequestHandler):
    """Custom handler to be tested"""
    def do_GET(self):
        # print just to confirm that this method is being called
        print("executing do_GET") # just to confirm...
        self.send_response(200)
        self.send_header("Content-type", "text/html")
        self.end_headers()
        # Here's where all the complicated logic is done to generate HTML.
        # For clarity here, replace with a simple stand-in:
        html = "<html><p>hello world</p></html>"
        self.wfile.write(html.encode())

def test_handler():
    """Test the custom HTTP request handler by mocking a server"""
    class MockRequest(object):
        def makefile(self, *args, **kwargs):
            return IO(b"GET /")
    class MockServer(object):
        def __init__(self, ip_port, Handler):
            handler = Handler(MockRequest(), ip_port, self)
    # The GET request will be sent here
    # and any exceptions will be propagated through.
    server = MockServer(('0.0.0.0', 8888), MyHandler)

test_handler()

所以这有点棘手,这取决于您想要进入BaseHTTPRequestHandler行为以定义单元测试的"深度"。在最基本的层面上,我认为你可以使用mock库中的这个例子:

>>> from mock import MagicMock
>>> thing = ProductionClass()
>>> thing.method = MagicMock(return_value=3)
>>> thing.method(3, 4, 5, key='value')
3
>>> thing.method.assert_called_with(3, 4, 5, key='value')

所以如果你知道BaseHTTPRequestHandler中你的类要调用哪些方法,你可以模拟这些方法的结果是可以接受的。当然,这可能会变得相当复杂,这取决于您要测试的服务器响应的不同类型。

相关内容

  • 没有找到相关文章

最新更新