157 lines
5.2 KiB
Python
157 lines
5.2 KiB
Python
# Copyright 2018 Red Hat
|
|
#
|
|
# 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.
|
|
from __future__ import absolute_import
|
|
|
|
import functools
|
|
import inspect
|
|
import typing
|
|
|
|
import fixtures
|
|
import testtools
|
|
|
|
|
|
SkipException: typing.Type[Exception] = (
|
|
testtools.TestCase.skipException)
|
|
|
|
SkipTarget = typing.Union[typing.Callable,
|
|
typing.Type[testtools.TestCase],
|
|
typing.Type[fixtures.Fixture]]
|
|
SkipDecorator = typing.Callable[[SkipTarget], SkipTarget]
|
|
|
|
|
|
SkipOnErrorType = typing.Union[typing.Type[Exception],
|
|
typing.Tuple[typing.Type[Exception], ...]]
|
|
|
|
|
|
def skip_test(reason: str,
|
|
cause: Exception = None,
|
|
bugzilla: int = None) -> typing.NoReturn:
|
|
"""Interrupt test case execution marking it as skipped for given reason"""
|
|
if bugzilla is not None:
|
|
reason += f'\nhttps://bugzilla.redhat.com/show_bug.cgi?id={bugzilla}\n'
|
|
if cause is not None:
|
|
reason += f"\n{cause}\n"
|
|
raise SkipException(reason) from cause
|
|
|
|
|
|
def skip(reason: str,
|
|
bugzilla: int = None) -> SkipDecorator:
|
|
"""Mark test case for being skipped for a given reason"""
|
|
return _skip_decorator(reason=reason, bugzilla=bugzilla)
|
|
|
|
|
|
def skip_if(reason: str,
|
|
predicate: typing.Callable,
|
|
*args,
|
|
bugzilla: int = None,
|
|
**kwargs) -> \
|
|
SkipDecorator:
|
|
"""Mark test case for being skipped for a given reason if it matches"""
|
|
predicate = _get_skip_predicate(predicate, *args, **kwargs)
|
|
return _skip_decorator(reason=reason,
|
|
unless=False,
|
|
bugzilla=bugzilla,
|
|
predicate=predicate)
|
|
|
|
|
|
def skip_unless(reason: str,
|
|
predicate: typing.Callable,
|
|
*args,
|
|
bugzilla: int = None,
|
|
**kwargs) -> \
|
|
SkipDecorator:
|
|
"""Mark test case for being skipped for a given reason unless it matches"""
|
|
predicate = _get_skip_predicate(predicate, *args, **kwargs)
|
|
return _skip_decorator(reason=reason,
|
|
unless=True,
|
|
bugzilla=bugzilla,
|
|
predicate=predicate)
|
|
|
|
|
|
def skip_on_error(reason: str,
|
|
predicate: typing.Callable,
|
|
*args,
|
|
error_type: SkipOnErrorType = None,
|
|
bugzilla: int = None,
|
|
**kwargs) -> \
|
|
SkipDecorator:
|
|
predicate = _get_skip_predicate(predicate, *args, **kwargs)
|
|
return _skip_decorator(reason=reason,
|
|
error_type=error_type,
|
|
bugzilla=bugzilla,
|
|
predicate=predicate)
|
|
|
|
|
|
def _skip_decorator(reason: str,
|
|
unless: bool = None,
|
|
error_type: SkipOnErrorType = None,
|
|
bugzilla: int = None,
|
|
predicate: typing.Callable = None) \
|
|
-> SkipDecorator:
|
|
"""Mark test case for being skipped for a given reason unless it matches"""
|
|
|
|
if error_type is None:
|
|
error_type = tuple()
|
|
|
|
def decorator(obj: SkipTarget) -> SkipTarget:
|
|
method = _get_skip_method(obj)
|
|
|
|
@functools.wraps(method)
|
|
def wrapper(*args, **kwargs):
|
|
_reason = reason
|
|
cause: typing.Optional[Exception] = None
|
|
if predicate is not None:
|
|
return_value: typing.Any = None
|
|
try:
|
|
return_value = predicate()
|
|
except error_type as ex:
|
|
cause = ex
|
|
else:
|
|
if unless in [None, bool(return_value)]:
|
|
return method(*args, **kwargs)
|
|
if '{return_value' in reason:
|
|
_reason = reason.format(return_value=return_value)
|
|
if '{cause' in reason:
|
|
_reason = reason.format(cause=cause)
|
|
skip_test(reason=_reason, cause=cause, bugzilla=bugzilla)
|
|
|
|
if obj is method:
|
|
return wrapper
|
|
else:
|
|
setattr(obj, method.__name__, wrapper)
|
|
return obj
|
|
|
|
return decorator
|
|
|
|
|
|
def _get_skip_method(obj: SkipTarget) -> typing.Callable:
|
|
if inspect.isclass(obj):
|
|
setup_method = getattr(obj, 'setUp', None)
|
|
if callable(setup_method):
|
|
return setup_method
|
|
else:
|
|
raise TypeError(f"Class {obj} does not implement setUp method")
|
|
elif callable(obj):
|
|
return obj
|
|
else:
|
|
raise TypeError(f"Object {obj} is not a class or a function")
|
|
|
|
|
|
def _get_skip_predicate(func: typing.Callable, *args, **kwargs) \
|
|
-> typing.Callable:
|
|
if args or kwargs:
|
|
return functools.partial(func, *args, **kwargs)
|
|
else:
|
|
return func
|