Skip to main content

start/stop WSGI applications in the background for functional testing

Project description

wsgi-liveserver provides a simple LiverServerTestCase class that can be used to help start a web server in the background to serve a WSGI compliant application for use with testing. Generally it will be used in conjuction with something like Selenium to perform a series of functional tests using a browser.

Licensed under the GNU GPL v3

Copyright (c) 2013 John Kristensen (unless explicitly stated otherwise).

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.

Port Range

By default LiveServerTestCase will attempt to listen on the first available port in the range 8080-8090 (inclusive). If you wish the LiveServer to attempt to listen on a different range of ports this can be done by setting the port_range class attribute (see the example below).

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>

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

wsgi-liveserver-0.3.1.tar.gz (16.5 kB view details)

Uploaded Source

File details

Details for the file wsgi-liveserver-0.3.1.tar.gz.

File metadata

File hashes

Hashes for wsgi-liveserver-0.3.1.tar.gz
Algorithm Hash digest
SHA256 130a03c8aa9abe31d9c77ed6d1fd13a59bb159b8b044420fdcc1c6bdb571513a
MD5 19d55fa23903e189080a07ad54802c6b
BLAKE2b-256 e280b9b21f2eba48fe1a3922a98090ae9782ad610402229eadb0eb272ab56941

See more details on using hashes here.

Supported by

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