mirrors/cpython
0
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2024-11-27 20:04:41 +08:00
Code Issues Packages Projects Releases Wiki Activity

issue9859: Document test.support.detect_api_mismatch() and simplify its test.

Browse Source
This commit is contained in:
Gregory P. Smith 2015-04-14 13:26:06 -07:00
parent 1bef9075b8
commit 4e72cceb62
3 changed files with 30 additions and 31 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
Doc/library/test.rst
View File

@ -568,6 +568,15 @@ The :mod:`test.support` module defines the following functions:
def load_tests(*args):
return load_package_tests(os.path.dirname(__file__), *args)
.. function:: detect_api_mismatch(ref_api, other_api, *, ignore=()):
Returns the set of attributes, functions or methods of `ref_api` not
found on `other_api`, except for a defined list of items to be
ignored in this check specified in `ignore`.
By default this skips private attributes beginning with '_' but
includes all magic methods, i.e. those starting and ending in '__'.
The :mod:`test.support` module defines the following classes:

2
Lib/test/support/__init__.py
View File

@ -2184,7 +2184,7 @@ def fs_is_case_insensitive(directory):
return False
def detect_api_mismatch(ref_api, other_api, *, ignore=None):
def detect_api_mismatch(ref_api, other_api, *, ignore=()):
"""Returns the set of items in ref_api not in other_api, except for a
defined list of items to be ignored in this check.

50
Lib/test/test_support.py
View File

@ -280,46 +280,36 @@ class TestSupport(unittest.TestCase):
self.assertEqual(D["item"], 5)
self.assertEqual(D["item"], 1)
class RefClass:
attribute1 = None
attribute2 = None
_hidden_attribute1 = None
__magic_1__ = None
class OtherClass:
attribute2 = None
attribute3 = None
__magic_1__ = None
__magic_2__ = None
def test_detect_api_mismatch(self):
class RefClass:
attribute1 = None
attribute2 = None
_hidden_attribute1 = None
__magic_1__ = None
class OtherClass:
attribute2 = None
attribute3 = None
__magic_1__ = None
__magic_2__ = None
missing_items = support.detect_api_mismatch(RefClass, OtherClass)
missing_items = support.detect_api_mismatch(self.RefClass,
self.OtherClass)
self.assertEqual({'attribute1'}, missing_items)
missing_items = support.detect_api_mismatch(OtherClass, RefClass)
missing_items = support.detect_api_mismatch(self.OtherClass,
self.RefClass)
self.assertEqual({'attribute3', '__magic_2__'}, missing_items)
def test_detect_api_mismatch__ignore(self):
class RefClass:
attribute1 = None
attribute2 = None
_hidden_attribute1 = None
__magic_1__ = None
class OtherClass:
attribute2 = None
attribute3 = None
__magic_1__ = None
__magic_2__ = None
ignore = ['attribute1', 'attribute3', '__magic_2__', 'not_in_either']
missing_items = support.detect_api_mismatch(RefClass, OtherClass,
ignore=ignore)
missing_items = support.detect_api_mismatch(
self.RefClass, self.OtherClass, ignore=ignore)
self.assertEqual(set(), missing_items)
missing_items = support.detect_api_mismatch(OtherClass, RefClass,
ignore=ignore)
missing_items = support.detect_api_mismatch(
self.OtherClass, self.RefClass, ignore=ignore)
self.assertEqual(set(), missing_items)
# XXX -follows a list of untested API