Some WSGI applications require a lot of prior setup before they can be use. Since we want most of that setup to happen in fixtures, wsgi-interception is delayed until after all extant fixtures have been started. This is done with a built in default fixture that is run as the most deeply nested of the context managers. The intecept callable is passed on along to the tests so that suite can be made aware of and use it when using the intercept context manager. If the callable is a function, when it is passed into the class builder, it can become bound to the TestCase. This binding is unbound in the caller.
109 lines
3.2 KiB
Python
109 lines
3.2 KiB
Python
# Copyright 2014, 2015 Red Hat
|
|
#
|
|
# Authors: Chris Dent <chdent@redhat.com>
|
|
#
|
|
# 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.
|
|
|
|
"""Manage fixtures for gabbi at the test suite level."""
|
|
|
|
import sys
|
|
from contextlib import contextmanager
|
|
|
|
import six
|
|
import wsgi_intercept
|
|
from wsgi_intercept import httplib2_intercept
|
|
|
|
|
|
class GabbiFixtureError(Exception):
|
|
"""Generic exception for GabbiFixture."""
|
|
pass
|
|
|
|
|
|
class GabbiFixture(object):
|
|
"""A context manager that operates as a fixture.
|
|
|
|
Subclasses must implement start_fixture and stop_fixture, each of which
|
|
contain the logic for stopping and starting whatever the fixture is.
|
|
What a fixture is is left as an exercise for the implementor.
|
|
|
|
These context managers will be nested so any actually work needs to
|
|
happen in `start_fixture` and `stop_fixture` and not in ``__init__``.
|
|
Otherwise exception handling will not work properly.
|
|
"""
|
|
|
|
def __enter__(self):
|
|
self.start_fixture()
|
|
|
|
def __exit__(self, type, value, traceback):
|
|
self.stop_fixture()
|
|
|
|
def start_fixture(self):
|
|
"""Implement the actual workings of starting the fixture here."""
|
|
pass
|
|
|
|
def stop_fixture(self):
|
|
"""Implement the actual workings of stopping the fixture here."""
|
|
pass
|
|
|
|
|
|
class InterceptFixture(GabbiFixture):
|
|
"""Start up the wsgi intercept. This should not be called directly."""
|
|
|
|
httplib2_intercept.install()
|
|
|
|
def __init__(self, host, port, app):
|
|
self.host = host
|
|
self.port = port
|
|
self.app = app
|
|
|
|
def start_fixture(self):
|
|
wsgi_intercept.add_wsgi_intercept(self.host, self.port,
|
|
lambda: self.app())
|
|
|
|
def stop_fixture(self):
|
|
wsgi_intercept.remove_wsgi_intercept(self.host, self.port)
|
|
|
|
|
|
@contextmanager
|
|
def nest(fixtures):
|
|
"""Nest a series of fixtures.
|
|
|
|
This is duplicated from ``nested`` in the stdlib, which has been
|
|
deprecated because of issues with how exceptions are difficult to
|
|
handle during ``__init__``. Gabbi needs to nest an unknown number
|
|
of fixtures dynamically, so the ``with`` syntax that replaces
|
|
``nested`` will not work.
|
|
"""
|
|
vars = []
|
|
exits = []
|
|
exc = (None, None, None)
|
|
try:
|
|
for fixture in fixtures:
|
|
enter = fixture.__enter__
|
|
exit = fixture.__exit__
|
|
vars.append(enter())
|
|
exits.append(exit)
|
|
yield vars
|
|
except:
|
|
exc = sys.exc_info()
|
|
finally:
|
|
while exits:
|
|
exit = exits.pop()
|
|
try:
|
|
if exit(*exc):
|
|
exc = (None, None, None)
|
|
except:
|
|
exc = sys.exc_info()
|
|
if exc != (None, None, None):
|
|
six.reraise(exc[0], exc[1], exc[2])
|