"Non-standard functions for the 'nose' testing framework."

try:
    from nose import DeprecatedTest, SkipTest
    from nose.tools import make_decorator


    def skip(f):
        """ Decorator to indicate a test should be skipped.
        """
        def g(*args, **kw):
            raise SkipTest()
        return make_decorator(f)(g)

    def deprecated(f):
        """ Decorator to indicate a test is deprecated.
        """
        def g(*args, **kw):
            raise DeprecatedTest()
        return make_decorator(f)(g)

except ImportError:
    # Define stubs in case nose isn't installed.

    import warnings


    def skip(f):
        """ Stub replacement for marking a unit test to be skipped in the
        absence of 'nose'.
        """

        warnings.warn("skipping unit tests requires the package 'nose'")
        return f

    def deprecated(f):
        """ Stub replacement for marking a unit test deprecated in the absence
        of 'nose'.
        """

        warnings.warn("skipping deprecated unit tests requires the package 'nose'")
        return f

def performance(f):
    """ Decorator to add an attribute to the test to mark it as
    a performance-measuring test.
    """
    f.performance = True
    return f

#### EOF #######################################################################