def test_function_name_carrying_with_decorator(self):
function_docstring = 'foo'
@decorators.restful_pagination()
def _function_to_decorate():
raise NotImplementedError
_function_to_decorate.__doc__ = function_docstring
self.assertNotEqual(
decorators.restful_pagination().__name__,
_function_to_decorate.__name__
)
self.assertEqual(function_docstring, _function_to_decorate.__doc__)
def test_function_name_preservation(self):
"""
Result of a bug that occurred with the decorator, in that the wrapped
function was not passing the name and docstring of ``f``. This resulted
in Sphinx being unable to write the docstring of the wrapped function
"""
def _function_to_decorate():
raise NotImplementedError
function_name = _function_to_decorate.__name__
function_doc = _function_to_decorate.__doc__
decorated_function = \
decorators.restful_pagination()(_function_to_decorate)
self.assertEqual(decorated_function.__name__, function_name)
self.assertEqual(decorated_function.__doc__, function_doc)