Installation and Dependencies

Install wsgi-liveserver with pip install wsgi-liveserver or just download wsgi_liveserver.py and place it in your project directory. There are no dependencies other than the Python Standard Library.

Usage

The wsgi-liveserver LiveServerTestCase can be used instead of unittest.TestCase for any tests that require a running web server. Simply define a create_app() method that returns the WSGI application that you want to have started up in the background, then write your tests as normal. LiveServerTestCase will handle starting and stopping the server for you.

Example

The following is a very basic example of using wsgi-liveserver with the wsgiref demo_app:

import unittest
from wsgiref.simple_server import demo_app
from selenium import webdriver
from wsgi_liveserver import LiveServerTestCase

class SimpleTest(LiveServerTestCase):
    port_range = (9001, 9010)  # default is (8080, 8090)

    def create_app(self):
        return demo_app

    def setUp(self):
        self.driver = webdriver.Firefox()

    def tearDown(self):
        self.driver.close()

    def test_page_title(self):
        self.driver.get(self.url_base())
        self.assertTrue('Hello world!' in self.driver.page_source)

if __name__ == '__main__':
    unittest.main()

Another simple but fully functional bottle web application with tests can be found at: https://github.com/jerrykan/bottle-selenium

Contact

Send your questions, comments, patches to John Kristensen <john@jerrykan.com>