A web and FTP server for use in unit tests / acceptance tests
Python Makefile
Switch branches/tags
Nothing to show


Stub Server

travis build


Web Server stubb

Testing external web dependencies in a mock objects style. Thanks to great contributions this library now supports Python 2.5 upto Python 3.4 (not yet tested with 3.5). There are a comprehensive suite of tests in the test.py file, which serve both as the TDD tests written while creating this library, and as examples / documentation.
It supports any HTTP method, i.e. GET, PUT, POST and DELETE. It supports chunked encoding, but currently we have no use cases for multipart support etc, so it doesn't do it. An excerpt from the tests is below:

  from unittest import TestCase
  from stubserver import StubServer

  class WebTest(TestCase):

      def setUp(self):
          self.server = StubServer(8998)

      def tearDown(self):
          # implicitly calls verify on stop

      def test_put_with_capture(self):
          capture = {}
          self.server.expect(method="PUT", url="/address/\d+$", data_capture=capture)\

          # do stuff here
          captured = eval(capture["body"])
          self.assertEquals("world", captured["hello"])

The stub server has been used extensively over the last 6 years by various teams and is considered stable.

FTP Stub Server

There have been some great contributions to the FTP Stub Server. It is now a reasonably capable FTP server but does not support all FTP commands. There are tests showing usage in the test.py file.

Get it from PyPi

You can install it with pip by running:

pip install stubserver