Skip to main content

Eases the testing of web services.

Project description

webunit2 is a spiritual successor to Richard Jones’ webunit, but is by no means a fork. This library has been built from the ground up, complete with documentation and testing. It’s also hosted on GitHub, making it a cinch to fork.


Documentation is available on PyPi..

You can also build the documentation yourself. Make sure Sphinx is installed by running:

$ easy_install -U sphinx

Then, clone the repository, cd into it, and run:

$ python build_sphinx

Documentation is available in build/sphinx/html.

Getting Started

Getting started is really, really easy. All you need to do is implement webunit2.testcase.Testcase and start writing unit tests.

import webunit2

class TestMyApp(webunit2.TestCase):

    def __init__(self):
        # You aren't required to initialize the base class here, but it
        # makes dealing with subsequent requests easier--because they can
        # be relative paths!
        webunit2.TestCase.__init__(self, "")

    def test_some_url(self):
        # Just do a normal get

        # Lets post some data'/somepath', post_params={"key": "value"})

        # No helper function for your HTTP method?  No problem!
        self.make_request("HEAD", "/somepath")

Of course, because this is a unit testing framework, you’ll probably be making a lot of assertions–especially in content. That’s easy too!

def test_for_content(self):
    # Assert the word `hippo` appears in the content.
    self.get_assertContent('/something', content="hippo")
    # Assert that the `X-Customheader` header was set.
    self.get_assertHeader('/something', 'X-Customheader')

If either of these fail (i.e., the return code is not 200 or the content does not contain hippo), an AssertionError is raised as normal. And of course, if you need to check for multiple values on the response, the same assert* functions are available directly on the response. For example, the above could be rewritten as:

def test_for_content_resp(self):
    resp = self.get('/something')
    # Assert the word `hippo` appears in the content.
    # Assert that the `X-Customheader` header was set.

This also allows you to chain many more assertions together–i.e., checking for headers, cookies, etc.. These were all designed to make testing easier, so if you have suggestions or complaints…


The source code is hosted on Github, which makes it a cinch to fork and contribute. Please submit issues using the GitHub tracker! I love getting feedback, and I urge you to file tickets for features and/or bugs.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

webunit2-0.2.2.tar.gz (7.1 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page