Skip to main content

Savida - Testing HTTP Server Fixture

Project description

Savida Testing Web Server Fixture

Savida is a testing-oriented HTTP server wrapper. It allows to easily launch a Web server during an automated test, define its behavior (i.e. how to respond to different requests) and shut it down easily when the test ends.

This is useful when testing complex HTTP-client based systems - for example at Shoppimon it is used to test our Web monitoring system infrastructure, which needs to access Websites using a complex browser and return different information based on entire page behaviors or even entire passes through the site.

Testing such systems is not possible using current mock HTTP client libraries or naive test server implementations, and this is why we created Savida.

Note that while the examples below refer to py.test, this module is in no way tied to a specific testing framework or methodology.

Usage

In testing frameworks like py.test, usage usually looks something like:

from savida.fixture import http_server

def test_my_browser_works():
    # Set up the server with a static document root directory
    with http_server(document_root='fixtures/webroot') as server:

        # Return 404 on /js/main.js even if it exists in our docroot
        server.when('/js/main.js').response(
            status=404, response='Gone to Lunch')

        # Wait 10 seconds before responding to /slow.php
        server.when('/slow.php').wait(10)

        server.start()

        response = requests.get(server.url + '/js/main.js')
        assert response.status_code == 404

Usage in module setup / teardown functions

TBD

API

TBD

TODO

  • Add documentation
  • Clean up API, replace wait method with something more concise
  • Add support for matching based on HTTP method

License

Copyright (c) 2017 Shoppimon LTD

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

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

savida-0.2.2.tar.gz (4.6 kB view details)

Uploaded Source

Built Distribution

savida-0.2.2-py2.py3-none-any.whl (10.0 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file savida-0.2.2.tar.gz.

File metadata

  • Download URL: savida-0.2.2.tar.gz
  • Upload date:
  • Size: 4.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.0 requests/2.24.0 setuptools/47.1.0 requests-toolbelt/0.9.1 tqdm/4.50.2 CPython/3.8.5

File hashes

Hashes for savida-0.2.2.tar.gz
Algorithm Hash digest
SHA256 058352e81fae83bad849a45ecc2dccc9ec83d6ffafc06602eb29a4cb30488ced
MD5 e1980f95b59acc83ad531bc54f7b0b67
BLAKE2b-256 5e28157efe47bcf5a58e002e0ad4c6a4f29ac63f5cd2fe66f4702e9bed3ecc06

See more details on using hashes here.

File details

Details for the file savida-0.2.2-py2.py3-none-any.whl.

File metadata

  • Download URL: savida-0.2.2-py2.py3-none-any.whl
  • Upload date:
  • Size: 10.0 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.0 requests/2.24.0 setuptools/47.1.0 requests-toolbelt/0.9.1 tqdm/4.50.2 CPython/3.8.5

File hashes

Hashes for savida-0.2.2-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 9ee72f4b469ca75166a10bf09765971955355d06c42aeb37da25ebe9771d0785
MD5 4f8557800fd773c85b9938f81a216416
BLAKE2b-256 5d037ac16d3bab604b2d13904a3a2dfbf82db79c919889ea0acb88e5fd490a7c

See more details on using hashes here.

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