/usr/lib/python3/dist-packages/plainbox/impl/test_init.py is in python3-plainbox 0.25-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 | # This file is part of Checkbox.
#
# Copyright 2014 Canonical Ltd.
# Written by:
# Zygmunt Krynicki <zygmunt.krynicki@canonical.com>
#
# Checkbox is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License version 3,
# as published by the Free Software Foundation.
#
# Checkbox is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with Checkbox. If not, see <http://www.gnu.org/licenses/>.
"""
plainbox.impl.test_init
=======================
Test definitions for plainbox.impl module
"""
from unittest import TestCase
import warnings
from plainbox.impl import _get_doc_margin
from plainbox.impl import deprecated
class MiscTests(TestCase):
def test_get_doc_margin(self):
self.assertEqual(
_get_doc_margin(
"the first line is ignored\n"
" subsequent lines"
" get counted"
" though"),
2)
self.assertEqual(
_get_doc_margin("what if there is no margin?"), 0)
class DeprecatedDecoratorTests(TestCase):
"""
Tests for the @deprecated function decorator
"""
def assertWarns(self, warning, callable, *args, **kwds):
with warnings.catch_warnings(record=True) as warning_list:
warnings.simplefilter('always')
result = callable(*args, **kwds)
self.assertTrue(any(item.category == warning for item in warning_list))
return result, warning_list
def test_func_deprecation_warning(self):
"""
Ensure that @deprecated decorator makes functions emit deprecation
warnings on call.
"""
@deprecated("0.6")
def func():
return "value"
result, warning_list = self.assertWarns(
DeprecationWarning,
func,
)
self.assertEqual(result, "value")
# NOTE: we need to use str() as warnings API is a bit silly there
self.assertEqual(str(warning_list[0].message),
'func is deprecated since version 0.6')
def test_func_docstring(self):
"""
Ensure that we set or modify the docstring to indicate the fact that
the function is now deprecated. The original docstring should be
preserved.
"""
@deprecated("0.6")
def func1():
pass
@deprecated("0.6")
def func2():
""" blah """
self.assertIn(".. deprecated:: 0.6", func1.__doc__)
self.assertIn(".. deprecated:: 0.6", func2.__doc__)
self.assertIn("blah", func2.__doc__)
def test_common_mistake(self):
"""
Ensure that we provide a helpful message when a common mistake is made
"""
with self.assertRaises(SyntaxError) as boom:
@deprecated
def func():
pass
self.assertEqual(
str(boom.exception),
"@deprecated() must be called with a parameter")
|