2137 lines
83 KiB
Python
2137 lines
83 KiB
Python
"""Unit tests for collections.py."""
|
|
|
|
import collections
|
|
import copy
|
|
import doctest
|
|
import inspect
|
|
import operator
|
|
import pickle
|
|
from random import choice, randrange
|
|
import string
|
|
import sys
|
|
from test import support
|
|
import types
|
|
import unittest
|
|
|
|
from collections import namedtuple, Counter, OrderedDict, _count_elements, _tuplegetter
|
|
from collections import UserDict, UserString, UserList
|
|
from collections import ChainMap
|
|
from collections import deque
|
|
from collections.abc import Awaitable, Coroutine
|
|
from collections.abc import AsyncIterator, AsyncIterable, AsyncGenerator
|
|
from collections.abc import Hashable, Iterable, Iterator, Generator, Reversible
|
|
from collections.abc import Sized, Container, Callable, Collection
|
|
from collections.abc import Set, MutableSet
|
|
from collections.abc import Mapping, MutableMapping, KeysView, ItemsView, ValuesView
|
|
from collections.abc import Sequence, MutableSequence
|
|
from collections.abc import ByteString
|
|
|
|
|
|
class TestUserObjects(unittest.TestCase):
|
|
def _superset_test(self, a, b):
|
|
self.assertGreaterEqual(
|
|
set(dir(a)),
|
|
set(dir(b)),
|
|
'{a} should have all the methods of {b}'.format(
|
|
a=a.__name__,
|
|
b=b.__name__,
|
|
),
|
|
)
|
|
def test_str_protocol(self):
|
|
self._superset_test(UserString, str)
|
|
|
|
def test_list_protocol(self):
|
|
self._superset_test(UserList, list)
|
|
|
|
def test_dict_protocol(self):
|
|
self._superset_test(UserDict, dict)
|
|
|
|
|
|
################################################################################
|
|
### ChainMap (helper class for configparser and the string module)
|
|
################################################################################
|
|
|
|
class TestChainMap(unittest.TestCase):
|
|
|
|
def test_basics(self):
|
|
c = ChainMap()
|
|
c['a'] = 1
|
|
c['b'] = 2
|
|
d = c.new_child()
|
|
d['b'] = 20
|
|
d['c'] = 30
|
|
self.assertEqual(d.maps, [{'b':20, 'c':30}, {'a':1, 'b':2}]) # check internal state
|
|
self.assertEqual(d.items(), dict(a=1, b=20, c=30).items()) # check items/iter/getitem
|
|
self.assertEqual(len(d), 3) # check len
|
|
for key in 'abc': # check contains
|
|
self.assertIn(key, d)
|
|
for k, v in dict(a=1, b=20, c=30, z=100).items(): # check get
|
|
self.assertEqual(d.get(k, 100), v)
|
|
|
|
del d['b'] # unmask a value
|
|
self.assertEqual(d.maps, [{'c':30}, {'a':1, 'b':2}]) # check internal state
|
|
self.assertEqual(d.items(), dict(a=1, b=2, c=30).items()) # check items/iter/getitem
|
|
self.assertEqual(len(d), 3) # check len
|
|
for key in 'abc': # check contains
|
|
self.assertIn(key, d)
|
|
for k, v in dict(a=1, b=2, c=30, z=100).items(): # check get
|
|
self.assertEqual(d.get(k, 100), v)
|
|
self.assertIn(repr(d), [ # check repr
|
|
type(d).__name__ + "({'c': 30}, {'a': 1, 'b': 2})",
|
|
type(d).__name__ + "({'c': 30}, {'b': 2, 'a': 1})"
|
|
])
|
|
|
|
for e in d.copy(), copy.copy(d): # check shallow copies
|
|
self.assertEqual(d, e)
|
|
self.assertEqual(d.maps, e.maps)
|
|
self.assertIsNot(d, e)
|
|
self.assertIsNot(d.maps[0], e.maps[0])
|
|
for m1, m2 in zip(d.maps[1:], e.maps[1:]):
|
|
self.assertIs(m1, m2)
|
|
|
|
# check deep copies
|
|
for proto in range(pickle.HIGHEST_PROTOCOL + 1):
|
|
e = pickle.loads(pickle.dumps(d, proto))
|
|
self.assertEqual(d, e)
|
|
self.assertEqual(d.maps, e.maps)
|
|
self.assertIsNot(d, e)
|
|
for m1, m2 in zip(d.maps, e.maps):
|
|
self.assertIsNot(m1, m2, e)
|
|
for e in [copy.deepcopy(d),
|
|
eval(repr(d))
|
|
]:
|
|
self.assertEqual(d, e)
|
|
self.assertEqual(d.maps, e.maps)
|
|
self.assertIsNot(d, e)
|
|
for m1, m2 in zip(d.maps, e.maps):
|
|
self.assertIsNot(m1, m2, e)
|
|
|
|
f = d.new_child()
|
|
f['b'] = 5
|
|
self.assertEqual(f.maps, [{'b': 5}, {'c':30}, {'a':1, 'b':2}])
|
|
self.assertEqual(f.parents.maps, [{'c':30}, {'a':1, 'b':2}]) # check parents
|
|
self.assertEqual(f['b'], 5) # find first in chain
|
|
self.assertEqual(f.parents['b'], 2) # look beyond maps[0]
|
|
|
|
def test_ordering(self):
|
|
# Combined order matches a series of dict updates from last to first.
|
|
# This test relies on the ordering of the underlying dicts.
|
|
|
|
baseline = {'music': 'bach', 'art': 'rembrandt'}
|
|
adjustments = {'art': 'van gogh', 'opera': 'carmen'}
|
|
|
|
cm = ChainMap(adjustments, baseline)
|
|
|
|
combined = baseline.copy()
|
|
combined.update(adjustments)
|
|
|
|
self.assertEqual(list(combined.items()), list(cm.items()))
|
|
|
|
def test_constructor(self):
|
|
self.assertEqual(ChainMap().maps, [{}]) # no-args --> one new dict
|
|
self.assertEqual(ChainMap({1:2}).maps, [{1:2}]) # 1 arg --> list
|
|
|
|
def test_bool(self):
|
|
self.assertFalse(ChainMap())
|
|
self.assertFalse(ChainMap({}, {}))
|
|
self.assertTrue(ChainMap({1:2}, {}))
|
|
self.assertTrue(ChainMap({}, {1:2}))
|
|
|
|
def test_missing(self):
|
|
class DefaultChainMap(ChainMap):
|
|
def __missing__(self, key):
|
|
return 999
|
|
d = DefaultChainMap(dict(a=1, b=2), dict(b=20, c=30))
|
|
for k, v in dict(a=1, b=2, c=30, d=999).items():
|
|
self.assertEqual(d[k], v) # check __getitem__ w/missing
|
|
for k, v in dict(a=1, b=2, c=30, d=77).items():
|
|
self.assertEqual(d.get(k, 77), v) # check get() w/ missing
|
|
for k, v in dict(a=True, b=True, c=True, d=False).items():
|
|
self.assertEqual(k in d, v) # check __contains__ w/missing
|
|
self.assertEqual(d.pop('a', 1001), 1, d)
|
|
self.assertEqual(d.pop('a', 1002), 1002) # check pop() w/missing
|
|
self.assertEqual(d.popitem(), ('b', 2)) # check popitem() w/missing
|
|
with self.assertRaises(KeyError):
|
|
d.popitem()
|
|
|
|
def test_order_preservation(self):
|
|
d = ChainMap(
|
|
OrderedDict(j=0, h=88888),
|
|
OrderedDict(),
|
|
OrderedDict(i=9999, d=4444, c=3333),
|
|
OrderedDict(f=666, b=222, g=777, c=333, h=888),
|
|
OrderedDict(),
|
|
OrderedDict(e=55, b=22),
|
|
OrderedDict(a=1, b=2, c=3, d=4, e=5),
|
|
OrderedDict(),
|
|
)
|
|
self.assertEqual(''.join(d), 'abcdefghij')
|
|
self.assertEqual(list(d.items()),
|
|
[('a', 1), ('b', 222), ('c', 3333), ('d', 4444),
|
|
('e', 55), ('f', 666), ('g', 777), ('h', 88888),
|
|
('i', 9999), ('j', 0)])
|
|
|
|
def test_dict_coercion(self):
|
|
d = ChainMap(dict(a=1, b=2), dict(b=20, c=30))
|
|
self.assertEqual(dict(d), dict(a=1, b=2, c=30))
|
|
self.assertEqual(dict(d.items()), dict(a=1, b=2, c=30))
|
|
|
|
def test_new_child(self):
|
|
'Tests for changes for issue #16613.'
|
|
c = ChainMap()
|
|
c['a'] = 1
|
|
c['b'] = 2
|
|
m = {'b':20, 'c': 30}
|
|
d = c.new_child(m)
|
|
self.assertEqual(d.maps, [{'b':20, 'c':30}, {'a':1, 'b':2}]) # check internal state
|
|
self.assertIs(m, d.maps[0])
|
|
|
|
# Use a different map than a dict
|
|
class lowerdict(dict):
|
|
def __getitem__(self, key):
|
|
if isinstance(key, str):
|
|
key = key.lower()
|
|
return dict.__getitem__(self, key)
|
|
def __contains__(self, key):
|
|
if isinstance(key, str):
|
|
key = key.lower()
|
|
return dict.__contains__(self, key)
|
|
|
|
c = ChainMap()
|
|
c['a'] = 1
|
|
c['b'] = 2
|
|
m = lowerdict(b=20, c=30)
|
|
d = c.new_child(m)
|
|
self.assertIs(m, d.maps[0])
|
|
for key in 'abc': # check contains
|
|
self.assertIn(key, d)
|
|
for k, v in dict(a=1, B=20, C=30, z=100).items(): # check get
|
|
self.assertEqual(d.get(k, 100), v)
|
|
|
|
|
|
################################################################################
|
|
### Named Tuples
|
|
################################################################################
|
|
|
|
TestNT = namedtuple('TestNT', 'x y z') # type used for pickle tests
|
|
|
|
class TestNamedTuple(unittest.TestCase):
|
|
|
|
def test_factory(self):
|
|
Point = namedtuple('Point', 'x y')
|
|
self.assertEqual(Point.__name__, 'Point')
|
|
self.assertEqual(Point.__slots__, ())
|
|
self.assertEqual(Point.__module__, __name__)
|
|
self.assertEqual(Point.__getitem__, tuple.__getitem__)
|
|
self.assertEqual(Point._fields, ('x', 'y'))
|
|
|
|
self.assertRaises(ValueError, namedtuple, 'abc%', 'efg ghi') # type has non-alpha char
|
|
self.assertRaises(ValueError, namedtuple, 'class', 'efg ghi') # type has keyword
|
|
self.assertRaises(ValueError, namedtuple, '9abc', 'efg ghi') # type starts with digit
|
|
|
|
self.assertRaises(ValueError, namedtuple, 'abc', 'efg g%hi') # field with non-alpha char
|
|
self.assertRaises(ValueError, namedtuple, 'abc', 'abc class') # field has keyword
|
|
self.assertRaises(ValueError, namedtuple, 'abc', '8efg 9ghi') # field starts with digit
|
|
self.assertRaises(ValueError, namedtuple, 'abc', '_efg ghi') # field with leading underscore
|
|
self.assertRaises(ValueError, namedtuple, 'abc', 'efg efg ghi') # duplicate field
|
|
|
|
namedtuple('Point0', 'x1 y2') # Verify that numbers are allowed in names
|
|
namedtuple('_', 'a b c') # Test leading underscores in a typename
|
|
|
|
nt = namedtuple('nt', 'the quick brown fox') # check unicode input
|
|
self.assertNotIn("u'", repr(nt._fields))
|
|
nt = namedtuple('nt', ('the', 'quick')) # check unicode input
|
|
self.assertNotIn("u'", repr(nt._fields))
|
|
|
|
self.assertRaises(TypeError, Point._make, [11]) # catch too few args
|
|
self.assertRaises(TypeError, Point._make, [11, 22, 33]) # catch too many args
|
|
|
|
def test_defaults(self):
|
|
Point = namedtuple('Point', 'x y', defaults=(10, 20)) # 2 defaults
|
|
self.assertEqual(Point._fields_defaults, {'x': 10, 'y': 20})
|
|
self.assertEqual(Point(1, 2), (1, 2))
|
|
self.assertEqual(Point(1), (1, 20))
|
|
self.assertEqual(Point(), (10, 20))
|
|
|
|
Point = namedtuple('Point', 'x y', defaults=(20,)) # 1 default
|
|
self.assertEqual(Point._fields_defaults, {'y': 20})
|
|
self.assertEqual(Point(1, 2), (1, 2))
|
|
self.assertEqual(Point(1), (1, 20))
|
|
|
|
Point = namedtuple('Point', 'x y', defaults=()) # 0 defaults
|
|
self.assertEqual(Point._fields_defaults, {})
|
|
self.assertEqual(Point(1, 2), (1, 2))
|
|
with self.assertRaises(TypeError):
|
|
Point(1)
|
|
|
|
with self.assertRaises(TypeError): # catch too few args
|
|
Point()
|
|
with self.assertRaises(TypeError): # catch too many args
|
|
Point(1, 2, 3)
|
|
with self.assertRaises(TypeError): # too many defaults
|
|
Point = namedtuple('Point', 'x y', defaults=(10, 20, 30))
|
|
with self.assertRaises(TypeError): # non-iterable defaults
|
|
Point = namedtuple('Point', 'x y', defaults=10)
|
|
with self.assertRaises(TypeError): # another non-iterable default
|
|
Point = namedtuple('Point', 'x y', defaults=False)
|
|
|
|
Point = namedtuple('Point', 'x y', defaults=None) # default is None
|
|
self.assertEqual(Point._fields_defaults, {})
|
|
self.assertIsNone(Point.__new__.__defaults__, None)
|
|
self.assertEqual(Point(10, 20), (10, 20))
|
|
with self.assertRaises(TypeError): # catch too few args
|
|
Point(10)
|
|
|
|
Point = namedtuple('Point', 'x y', defaults=[10, 20]) # allow non-tuple iterable
|
|
self.assertEqual(Point._fields_defaults, {'x': 10, 'y': 20})
|
|
self.assertEqual(Point.__new__.__defaults__, (10, 20))
|
|
self.assertEqual(Point(1, 2), (1, 2))
|
|
self.assertEqual(Point(1), (1, 20))
|
|
self.assertEqual(Point(), (10, 20))
|
|
|
|
Point = namedtuple('Point', 'x y', defaults=iter([10, 20])) # allow plain iterator
|
|
self.assertEqual(Point._fields_defaults, {'x': 10, 'y': 20})
|
|
self.assertEqual(Point.__new__.__defaults__, (10, 20))
|
|
self.assertEqual(Point(1, 2), (1, 2))
|
|
self.assertEqual(Point(1), (1, 20))
|
|
self.assertEqual(Point(), (10, 20))
|
|
|
|
def test_readonly(self):
|
|
Point = namedtuple('Point', 'x y')
|
|
p = Point(11, 22)
|
|
with self.assertRaises(AttributeError):
|
|
p.x = 33
|
|
with self.assertRaises(AttributeError):
|
|
del p.x
|
|
with self.assertRaises(TypeError):
|
|
p[0] = 33
|
|
with self.assertRaises(TypeError):
|
|
del p[0]
|
|
self.assertEqual(p.x, 11)
|
|
self.assertEqual(p[0], 11)
|
|
|
|
@unittest.skipIf(sys.flags.optimize >= 2,
|
|
"Docstrings are omitted with -O2 and above")
|
|
def test_factory_doc_attr(self):
|
|
Point = namedtuple('Point', 'x y')
|
|
self.assertEqual(Point.__doc__, 'Point(x, y)')
|
|
Point.__doc__ = '2D point'
|
|
self.assertEqual(Point.__doc__, '2D point')
|
|
|
|
@unittest.skipIf(sys.flags.optimize >= 2,
|
|
"Docstrings are omitted with -O2 and above")
|
|
def test_field_doc(self):
|
|
Point = namedtuple('Point', 'x y')
|
|
self.assertEqual(Point.x.__doc__, 'Alias for field number 0')
|
|
self.assertEqual(Point.y.__doc__, 'Alias for field number 1')
|
|
Point.x.__doc__ = 'docstring for Point.x'
|
|
self.assertEqual(Point.x.__doc__, 'docstring for Point.x')
|
|
# namedtuple can mutate doc of descriptors independently
|
|
Vector = namedtuple('Vector', 'x y')
|
|
self.assertEqual(Vector.x.__doc__, 'Alias for field number 0')
|
|
Vector.x.__doc__ = 'docstring for Vector.x'
|
|
self.assertEqual(Vector.x.__doc__, 'docstring for Vector.x')
|
|
|
|
@support.cpython_only
|
|
@unittest.skipIf(sys.flags.optimize >= 2,
|
|
"Docstrings are omitted with -O2 and above")
|
|
def test_field_doc_reuse(self):
|
|
P = namedtuple('P', ['m', 'n'])
|
|
Q = namedtuple('Q', ['o', 'p'])
|
|
self.assertIs(P.m.__doc__, Q.o.__doc__)
|
|
self.assertIs(P.n.__doc__, Q.p.__doc__)
|
|
|
|
def test_name_fixer(self):
|
|
for spec, renamed in [
|
|
[('efg', 'g%hi'), ('efg', '_1')], # field with non-alpha char
|
|
[('abc', 'class'), ('abc', '_1')], # field has keyword
|
|
[('8efg', '9ghi'), ('_0', '_1')], # field starts with digit
|
|
[('abc', '_efg'), ('abc', '_1')], # field with leading underscore
|
|
[('abc', 'efg', 'efg', 'ghi'), ('abc', 'efg', '_2', 'ghi')], # duplicate field
|
|
[('abc', '', 'x'), ('abc', '_1', 'x')], # fieldname is a space
|
|
]:
|
|
self.assertEqual(namedtuple('NT', spec, rename=True)._fields, renamed)
|
|
|
|
def test_module_parameter(self):
|
|
NT = namedtuple('NT', ['x', 'y'], module=collections)
|
|
self.assertEqual(NT.__module__, collections)
|
|
|
|
def test_instance(self):
|
|
Point = namedtuple('Point', 'x y')
|
|
p = Point(11, 22)
|
|
self.assertEqual(p, Point(x=11, y=22))
|
|
self.assertEqual(p, Point(11, y=22))
|
|
self.assertEqual(p, Point(y=22, x=11))
|
|
self.assertEqual(p, Point(*(11, 22)))
|
|
self.assertEqual(p, Point(**dict(x=11, y=22)))
|
|
self.assertRaises(TypeError, Point, 1) # too few args
|
|
self.assertRaises(TypeError, Point, 1, 2, 3) # too many args
|
|
with self.assertRaises(TypeError): # wrong keyword argument
|
|
Point(XXX=1, y=2)
|
|
with self.assertRaises(TypeError): # missing keyword argument
|
|
Point(x=1)
|
|
self.assertEqual(repr(p), 'Point(x=11, y=22)')
|
|
self.assertNotIn('__weakref__', dir(p))
|
|
self.assertEqual(p, Point._make([11, 22])) # test _make classmethod
|
|
self.assertEqual(p._fields, ('x', 'y')) # test _fields attribute
|
|
self.assertEqual(p._replace(x=1), (1, 22)) # test _replace method
|
|
self.assertEqual(p._asdict(), dict(x=11, y=22)) # test _asdict method
|
|
|
|
try:
|
|
p._replace(x=1, error=2)
|
|
except ValueError:
|
|
pass
|
|
else:
|
|
self._fail('Did not detect an incorrect fieldname')
|
|
|
|
# verify that field string can have commas
|
|
Point = namedtuple('Point', 'x, y')
|
|
p = Point(x=11, y=22)
|
|
self.assertEqual(repr(p), 'Point(x=11, y=22)')
|
|
|
|
# verify that fieldspec can be a non-string sequence
|
|
Point = namedtuple('Point', ('x', 'y'))
|
|
p = Point(x=11, y=22)
|
|
self.assertEqual(repr(p), 'Point(x=11, y=22)')
|
|
|
|
def test_tupleness(self):
|
|
Point = namedtuple('Point', 'x y')
|
|
p = Point(11, 22)
|
|
|
|
self.assertIsInstance(p, tuple)
|
|
self.assertEqual(p, (11, 22)) # matches a real tuple
|
|
self.assertEqual(tuple(p), (11, 22)) # coercable to a real tuple
|
|
self.assertEqual(list(p), [11, 22]) # coercable to a list
|
|
self.assertEqual(max(p), 22) # iterable
|
|
self.assertEqual(max(*p), 22) # star-able
|
|
x, y = p
|
|
self.assertEqual(p, (x, y)) # unpacks like a tuple
|
|
self.assertEqual((p[0], p[1]), (11, 22)) # indexable like a tuple
|
|
with self.assertRaises(IndexError):
|
|
p[3]
|
|
self.assertEqual(p[-1], 22)
|
|
self.assertEqual(hash(p), hash((11, 22)))
|
|
|
|
self.assertEqual(p.x, x)
|
|
self.assertEqual(p.y, y)
|
|
with self.assertRaises(AttributeError):
|
|
p.z
|
|
|
|
def test_odd_sizes(self):
|
|
Zero = namedtuple('Zero', '')
|
|
self.assertEqual(Zero(), ())
|
|
self.assertEqual(Zero._make([]), ())
|
|
self.assertEqual(repr(Zero()), 'Zero()')
|
|
self.assertEqual(Zero()._asdict(), {})
|
|
self.assertEqual(Zero()._fields, ())
|
|
|
|
Dot = namedtuple('Dot', 'd')
|
|
self.assertEqual(Dot(1), (1,))
|
|
self.assertEqual(Dot._make([1]), (1,))
|
|
self.assertEqual(Dot(1).d, 1)
|
|
self.assertEqual(repr(Dot(1)), 'Dot(d=1)')
|
|
self.assertEqual(Dot(1)._asdict(), {'d':1})
|
|
self.assertEqual(Dot(1)._replace(d=999), (999,))
|
|
self.assertEqual(Dot(1)._fields, ('d',))
|
|
|
|
n = 5000
|
|
names = list(set(''.join([choice(string.ascii_letters)
|
|
for j in range(10)]) for i in range(n)))
|
|
n = len(names)
|
|
Big = namedtuple('Big', names)
|
|
b = Big(*range(n))
|
|
self.assertEqual(b, tuple(range(n)))
|
|
self.assertEqual(Big._make(range(n)), tuple(range(n)))
|
|
for pos, name in enumerate(names):
|
|
self.assertEqual(getattr(b, name), pos)
|
|
repr(b) # make sure repr() doesn't blow-up
|
|
d = b._asdict()
|
|
d_expected = dict(zip(names, range(n)))
|
|
self.assertEqual(d, d_expected)
|
|
b2 = b._replace(**dict([(names[1], 999),(names[-5], 42)]))
|
|
b2_expected = list(range(n))
|
|
b2_expected[1] = 999
|
|
b2_expected[-5] = 42
|
|
self.assertEqual(b2, tuple(b2_expected))
|
|
self.assertEqual(b._fields, tuple(names))
|
|
|
|
def test_pickle(self):
|
|
p = TestNT(x=10, y=20, z=30)
|
|
for module in (pickle,):
|
|
loads = getattr(module, 'loads')
|
|
dumps = getattr(module, 'dumps')
|
|
for protocol in range(-1, module.HIGHEST_PROTOCOL + 1):
|
|
q = loads(dumps(p, protocol))
|
|
self.assertEqual(p, q)
|
|
self.assertEqual(p._fields, q._fields)
|
|
self.assertNotIn(b'OrderedDict', dumps(p, protocol))
|
|
|
|
def test_copy(self):
|
|
p = TestNT(x=10, y=20, z=30)
|
|
for copier in copy.copy, copy.deepcopy:
|
|
q = copier(p)
|
|
self.assertEqual(p, q)
|
|
self.assertEqual(p._fields, q._fields)
|
|
|
|
def test_name_conflicts(self):
|
|
# Some names like "self", "cls", "tuple", "itemgetter", and "property"
|
|
# failed when used as field names. Test to make sure these now work.
|
|
T = namedtuple('T', 'itemgetter property self cls tuple')
|
|
t = T(1, 2, 3, 4, 5)
|
|
self.assertEqual(t, (1,2,3,4,5))
|
|
newt = t._replace(itemgetter=10, property=20, self=30, cls=40, tuple=50)
|
|
self.assertEqual(newt, (10,20,30,40,50))
|
|
|
|
# Broader test of all interesting names taken from the code, old
|
|
# template, and an example
|
|
words = {'Alias', 'At', 'AttributeError', 'Build', 'Bypass', 'Create',
|
|
'Encountered', 'Expected', 'Field', 'For', 'Got', 'Helper',
|
|
'IronPython', 'Jython', 'KeyError', 'Make', 'Modify', 'Note',
|
|
'OrderedDict', 'Point', 'Return', 'Returns', 'Type', 'TypeError',
|
|
'Used', 'Validate', 'ValueError', 'Variables', 'a', 'accessible', 'add',
|
|
'added', 'all', 'also', 'an', 'arg_list', 'args', 'arguments',
|
|
'automatically', 'be', 'build', 'builtins', 'but', 'by', 'cannot',
|
|
'class_namespace', 'classmethod', 'cls', 'collections', 'convert',
|
|
'copy', 'created', 'creation', 'd', 'debugging', 'defined', 'dict',
|
|
'dictionary', 'doc', 'docstring', 'docstrings', 'duplicate', 'effect',
|
|
'either', 'enumerate', 'environments', 'error', 'example', 'exec', 'f',
|
|
'f_globals', 'field', 'field_names', 'fields', 'formatted', 'frame',
|
|
'function', 'functions', 'generate', 'get', 'getter', 'got', 'greater',
|
|
'has', 'help', 'identifiers', 'index', 'indexable', 'instance',
|
|
'instantiate', 'interning', 'introspection', 'isidentifier',
|
|
'isinstance', 'itemgetter', 'iterable', 'join', 'keyword', 'keywords',
|
|
'kwds', 'len', 'like', 'list', 'map', 'maps', 'message', 'metadata',
|
|
'method', 'methods', 'module', 'module_name', 'must', 'name', 'named',
|
|
'namedtuple', 'namedtuple_', 'names', 'namespace', 'needs', 'new',
|
|
'nicely', 'num_fields', 'number', 'object', 'of', 'operator', 'option',
|
|
'p', 'particular', 'pickle', 'pickling', 'plain', 'pop', 'positional',
|
|
'property', 'r', 'regular', 'rename', 'replace', 'replacing', 'repr',
|
|
'repr_fmt', 'representation', 'result', 'reuse_itemgetter', 's', 'seen',
|
|
'self', 'sequence', 'set', 'side', 'specified', 'split', 'start',
|
|
'startswith', 'step', 'str', 'string', 'strings', 'subclass', 'sys',
|
|
'targets', 'than', 'the', 'their', 'this', 'to', 'tuple', 'tuple_new',
|
|
'type', 'typename', 'underscore', 'unexpected', 'unpack', 'up', 'use',
|
|
'used', 'user', 'valid', 'values', 'variable', 'verbose', 'where',
|
|
'which', 'work', 'x', 'y', 'z', 'zip'}
|
|
T = namedtuple('T', words)
|
|
# test __new__
|
|
values = tuple(range(len(words)))
|
|
t = T(*values)
|
|
self.assertEqual(t, values)
|
|
t = T(**dict(zip(T._fields, values)))
|
|
self.assertEqual(t, values)
|
|
# test _make
|
|
t = T._make(values)
|
|
self.assertEqual(t, values)
|
|
# exercise __repr__
|
|
repr(t)
|
|
# test _asdict
|
|
self.assertEqual(t._asdict(), dict(zip(T._fields, values)))
|
|
# test _replace
|
|
t = T._make(values)
|
|
newvalues = tuple(v*10 for v in values)
|
|
newt = t._replace(**dict(zip(T._fields, newvalues)))
|
|
self.assertEqual(newt, newvalues)
|
|
# test _fields
|
|
self.assertEqual(T._fields, tuple(words))
|
|
# test __getnewargs__
|
|
self.assertEqual(t.__getnewargs__(), values)
|
|
|
|
def test_repr(self):
|
|
A = namedtuple('A', 'x')
|
|
self.assertEqual(repr(A(1)), 'A(x=1)')
|
|
# repr should show the name of the subclass
|
|
class B(A):
|
|
pass
|
|
self.assertEqual(repr(B(1)), 'B(x=1)')
|
|
|
|
def test_keyword_only_arguments(self):
|
|
# See issue 25628
|
|
with self.assertRaises(TypeError):
|
|
NT = namedtuple('NT', ['x', 'y'], True)
|
|
|
|
NT = namedtuple('NT', ['abc', 'def'], rename=True)
|
|
self.assertEqual(NT._fields, ('abc', '_1'))
|
|
with self.assertRaises(TypeError):
|
|
NT = namedtuple('NT', ['abc', 'def'], False, True)
|
|
|
|
def test_namedtuple_subclass_issue_24931(self):
|
|
class Point(namedtuple('_Point', ['x', 'y'])):
|
|
pass
|
|
|
|
a = Point(3, 4)
|
|
self.assertEqual(a._asdict(), OrderedDict([('x', 3), ('y', 4)]))
|
|
|
|
a.w = 5
|
|
self.assertEqual(a.__dict__, {'w': 5})
|
|
|
|
def test_field_descriptor(self):
|
|
Point = namedtuple('Point', 'x y')
|
|
p = Point(11, 22)
|
|
self.assertTrue(inspect.isdatadescriptor(Point.x))
|
|
self.assertEqual(Point.x.__get__(p), 11)
|
|
self.assertRaises(AttributeError, Point.x.__set__, p, 33)
|
|
self.assertRaises(AttributeError, Point.x.__delete__, p)
|
|
|
|
class NewPoint(tuple):
|
|
x = pickle.loads(pickle.dumps(Point.x))
|
|
y = pickle.loads(pickle.dumps(Point.y))
|
|
|
|
np = NewPoint([1, 2])
|
|
|
|
self.assertEqual(np.x, 1)
|
|
self.assertEqual(np.y, 2)
|
|
|
|
|
|
################################################################################
|
|
### Abstract Base Classes
|
|
################################################################################
|
|
|
|
class ABCTestCase(unittest.TestCase):
|
|
|
|
def validate_abstract_methods(self, abc, *names):
|
|
methodstubs = dict.fromkeys(names, lambda s, *args: 0)
|
|
|
|
# everything should work will all required methods are present
|
|
C = type('C', (abc,), methodstubs)
|
|
C()
|
|
|
|
# instantiation should fail if a required method is missing
|
|
for name in names:
|
|
stubs = methodstubs.copy()
|
|
del stubs[name]
|
|
C = type('C', (abc,), stubs)
|
|
self.assertRaises(TypeError, C, name)
|
|
|
|
def validate_isinstance(self, abc, name):
|
|
stub = lambda s, *args: 0
|
|
|
|
C = type('C', (object,), {'__hash__': None})
|
|
setattr(C, name, stub)
|
|
self.assertIsInstance(C(), abc)
|
|
self.assertTrue(issubclass(C, abc))
|
|
|
|
C = type('C', (object,), {'__hash__': None})
|
|
self.assertNotIsInstance(C(), abc)
|
|
self.assertFalse(issubclass(C, abc))
|
|
|
|
def validate_comparison(self, instance):
|
|
ops = ['lt', 'gt', 'le', 'ge', 'ne', 'or', 'and', 'xor', 'sub']
|
|
operators = {}
|
|
for op in ops:
|
|
name = '__' + op + '__'
|
|
operators[name] = getattr(operator, name)
|
|
|
|
class Other:
|
|
def __init__(self):
|
|
self.right_side = False
|
|
def __eq__(self, other):
|
|
self.right_side = True
|
|
return True
|
|
__lt__ = __eq__
|
|
__gt__ = __eq__
|
|
__le__ = __eq__
|
|
__ge__ = __eq__
|
|
__ne__ = __eq__
|
|
__ror__ = __eq__
|
|
__rand__ = __eq__
|
|
__rxor__ = __eq__
|
|
__rsub__ = __eq__
|
|
|
|
for name, op in operators.items():
|
|
if not hasattr(instance, name):
|
|
continue
|
|
other = Other()
|
|
op(instance, other)
|
|
self.assertTrue(other.right_side,'Right side not called for %s.%s'
|
|
% (type(instance), name))
|
|
|
|
def _test_gen():
|
|
yield
|
|
|
|
class TestOneTrickPonyABCs(ABCTestCase):
|
|
|
|
def test_Awaitable(self):
|
|
def gen():
|
|
yield
|
|
|
|
@types.coroutine
|
|
def coro():
|
|
yield
|
|
|
|
async def new_coro():
|
|
pass
|
|
|
|
class Bar:
|
|
def __await__(self):
|
|
yield
|
|
|
|
class MinimalCoro(Coroutine):
|
|
def send(self, value):
|
|
return value
|
|
def throw(self, typ, val=None, tb=None):
|
|
super().throw(typ, val, tb)
|
|
def __await__(self):
|
|
yield
|
|
|
|
non_samples = [None, int(), gen(), object()]
|
|
for x in non_samples:
|
|
self.assertNotIsInstance(x, Awaitable)
|
|
self.assertFalse(issubclass(type(x), Awaitable), repr(type(x)))
|
|
|
|
samples = [Bar(), MinimalCoro()]
|
|
for x in samples:
|
|
self.assertIsInstance(x, Awaitable)
|
|
self.assertTrue(issubclass(type(x), Awaitable))
|
|
|
|
c = coro()
|
|
# Iterable coroutines (generators with CO_ITERABLE_COROUTINE
|
|
# flag don't have '__await__' method, hence can't be instances
|
|
# of Awaitable. Use inspect.isawaitable to detect them.
|
|
self.assertNotIsInstance(c, Awaitable)
|
|
|
|
c = new_coro()
|
|
self.assertIsInstance(c, Awaitable)
|
|
c.close() # avoid RuntimeWarning that coro() was not awaited
|
|
|
|
class CoroLike: pass
|
|
Coroutine.register(CoroLike)
|
|
self.assertTrue(isinstance(CoroLike(), Awaitable))
|
|
self.assertTrue(issubclass(CoroLike, Awaitable))
|
|
CoroLike = None
|
|
support.gc_collect() # Kill CoroLike to clean-up ABCMeta cache
|
|
|
|
def test_Coroutine(self):
|
|
def gen():
|
|
yield
|
|
|
|
@types.coroutine
|
|
def coro():
|
|
yield
|
|
|
|
async def new_coro():
|
|
pass
|
|
|
|
class Bar:
|
|
def __await__(self):
|
|
yield
|
|
|
|
class MinimalCoro(Coroutine):
|
|
def send(self, value):
|
|
return value
|
|
def throw(self, typ, val=None, tb=None):
|
|
super().throw(typ, val, tb)
|
|
def __await__(self):
|
|
yield
|
|
|
|
non_samples = [None, int(), gen(), object(), Bar()]
|
|
for x in non_samples:
|
|
self.assertNotIsInstance(x, Coroutine)
|
|
self.assertFalse(issubclass(type(x), Coroutine), repr(type(x)))
|
|
|
|
samples = [MinimalCoro()]
|
|
for x in samples:
|
|
self.assertIsInstance(x, Awaitable)
|
|
self.assertTrue(issubclass(type(x), Awaitable))
|
|
|
|
c = coro()
|
|
# Iterable coroutines (generators with CO_ITERABLE_COROUTINE
|
|
# flag don't have '__await__' method, hence can't be instances
|
|
# of Coroutine. Use inspect.isawaitable to detect them.
|
|
self.assertNotIsInstance(c, Coroutine)
|
|
|
|
c = new_coro()
|
|
self.assertIsInstance(c, Coroutine)
|
|
c.close() # avoid RuntimeWarning that coro() was not awaited
|
|
|
|
class CoroLike:
|
|
def send(self, value):
|
|
pass
|
|
def throw(self, typ, val=None, tb=None):
|
|
pass
|
|
def close(self):
|
|
pass
|
|
def __await__(self):
|
|
pass
|
|
self.assertTrue(isinstance(CoroLike(), Coroutine))
|
|
self.assertTrue(issubclass(CoroLike, Coroutine))
|
|
|
|
class CoroLike:
|
|
def send(self, value):
|
|
pass
|
|
def close(self):
|
|
pass
|
|
def __await__(self):
|
|
pass
|
|
self.assertFalse(isinstance(CoroLike(), Coroutine))
|
|
self.assertFalse(issubclass(CoroLike, Coroutine))
|
|
|
|
def test_Hashable(self):
|
|
# Check some non-hashables
|
|
non_samples = [bytearray(), list(), set(), dict()]
|
|
for x in non_samples:
|
|
self.assertNotIsInstance(x, Hashable)
|
|
self.assertFalse(issubclass(type(x), Hashable), repr(type(x)))
|
|
# Check some hashables
|
|
samples = [None,
|
|
int(), float(), complex(),
|
|
str(),
|
|
tuple(), frozenset(),
|
|
int, list, object, type, bytes()
|
|
]
|
|
for x in samples:
|
|
self.assertIsInstance(x, Hashable)
|
|
self.assertTrue(issubclass(type(x), Hashable), repr(type(x)))
|
|
self.assertRaises(TypeError, Hashable)
|
|
# Check direct subclassing
|
|
class H(Hashable):
|
|
def __hash__(self):
|
|
return super().__hash__()
|
|
self.assertEqual(hash(H()), 0)
|
|
self.assertFalse(issubclass(int, H))
|
|
self.validate_abstract_methods(Hashable, '__hash__')
|
|
self.validate_isinstance(Hashable, '__hash__')
|
|
|
|
def test_AsyncIterable(self):
|
|
class AI:
|
|
def __aiter__(self):
|
|
return self
|
|
self.assertTrue(isinstance(AI(), AsyncIterable))
|
|
self.assertTrue(issubclass(AI, AsyncIterable))
|
|
# Check some non-iterables
|
|
non_samples = [None, object, []]
|
|
for x in non_samples:
|
|
self.assertNotIsInstance(x, AsyncIterable)
|
|
self.assertFalse(issubclass(type(x), AsyncIterable), repr(type(x)))
|
|
self.validate_abstract_methods(AsyncIterable, '__aiter__')
|
|
self.validate_isinstance(AsyncIterable, '__aiter__')
|
|
|
|
def test_AsyncIterator(self):
|
|
class AI:
|
|
def __aiter__(self):
|
|
return self
|
|
async def __anext__(self):
|
|
raise StopAsyncIteration
|
|
self.assertTrue(isinstance(AI(), AsyncIterator))
|
|
self.assertTrue(issubclass(AI, AsyncIterator))
|
|
non_samples = [None, object, []]
|
|
# Check some non-iterables
|
|
for x in non_samples:
|
|
self.assertNotIsInstance(x, AsyncIterator)
|
|
self.assertFalse(issubclass(type(x), AsyncIterator), repr(type(x)))
|
|
# Similarly to regular iterators (see issue 10565)
|
|
class AnextOnly:
|
|
async def __anext__(self):
|
|
raise StopAsyncIteration
|
|
self.assertNotIsInstance(AnextOnly(), AsyncIterator)
|
|
self.validate_abstract_methods(AsyncIterator, '__anext__', '__aiter__')
|
|
|
|
def test_Iterable(self):
|
|
# Check some non-iterables
|
|
non_samples = [None, 42, 3.14, 1j]
|
|
for x in non_samples:
|
|
self.assertNotIsInstance(x, Iterable)
|
|
self.assertFalse(issubclass(type(x), Iterable), repr(type(x)))
|
|
# Check some iterables
|
|
samples = [bytes(), str(),
|
|
tuple(), list(), set(), frozenset(), dict(),
|
|
dict().keys(), dict().items(), dict().values(),
|
|
_test_gen(),
|
|
(x for x in []),
|
|
]
|
|
for x in samples:
|
|
self.assertIsInstance(x, Iterable)
|
|
self.assertTrue(issubclass(type(x), Iterable), repr(type(x)))
|
|
# Check direct subclassing
|
|
class I(Iterable):
|
|
def __iter__(self):
|
|
return super().__iter__()
|
|
self.assertEqual(list(I()), [])
|
|
self.assertFalse(issubclass(str, I))
|
|
self.validate_abstract_methods(Iterable, '__iter__')
|
|
self.validate_isinstance(Iterable, '__iter__')
|
|
# Check None blocking
|
|
class It:
|
|
def __iter__(self): return iter([])
|
|
class ItBlocked(It):
|
|
__iter__ = None
|
|
self.assertTrue(issubclass(It, Iterable))
|
|
self.assertTrue(isinstance(It(), Iterable))
|
|
self.assertFalse(issubclass(ItBlocked, Iterable))
|
|
self.assertFalse(isinstance(ItBlocked(), Iterable))
|
|
|
|
def test_Reversible(self):
|
|
# Check some non-reversibles
|
|
non_samples = [None, 42, 3.14, 1j, set(), frozenset()]
|
|
for x in non_samples:
|
|
self.assertNotIsInstance(x, Reversible)
|
|
self.assertFalse(issubclass(type(x), Reversible), repr(type(x)))
|
|
# Check some non-reversible iterables
|
|
non_reversibles = [_test_gen(), (x for x in []), iter([]), reversed([])]
|
|
for x in non_reversibles:
|
|
self.assertNotIsInstance(x, Reversible)
|
|
self.assertFalse(issubclass(type(x), Reversible), repr(type(x)))
|
|
# Check some reversible iterables
|
|
samples = [bytes(), str(), tuple(), list(), OrderedDict(),
|
|
OrderedDict().keys(), OrderedDict().items(),
|
|
OrderedDict().values(), Counter(), Counter().keys(),
|
|
Counter().items(), Counter().values(), dict(),
|
|
dict().keys(), dict().items(), dict().values()]
|
|
for x in samples:
|
|
self.assertIsInstance(x, Reversible)
|
|
self.assertTrue(issubclass(type(x), Reversible), repr(type(x)))
|
|
# Check also Mapping, MutableMapping, and Sequence
|
|
self.assertTrue(issubclass(Sequence, Reversible), repr(Sequence))
|
|
self.assertFalse(issubclass(Mapping, Reversible), repr(Mapping))
|
|
self.assertFalse(issubclass(MutableMapping, Reversible), repr(MutableMapping))
|
|
# Check direct subclassing
|
|
class R(Reversible):
|
|
def __iter__(self):
|
|
return iter(list())
|
|
def __reversed__(self):
|
|
return iter(list())
|
|
self.assertEqual(list(reversed(R())), [])
|
|
self.assertFalse(issubclass(float, R))
|
|
self.validate_abstract_methods(Reversible, '__reversed__', '__iter__')
|
|
# Check reversible non-iterable (which is not Reversible)
|
|
class RevNoIter:
|
|
def __reversed__(self): return reversed([])
|
|
class RevPlusIter(RevNoIter):
|
|
def __iter__(self): return iter([])
|
|
self.assertFalse(issubclass(RevNoIter, Reversible))
|
|
self.assertFalse(isinstance(RevNoIter(), Reversible))
|
|
self.assertTrue(issubclass(RevPlusIter, Reversible))
|
|
self.assertTrue(isinstance(RevPlusIter(), Reversible))
|
|
# Check None blocking
|
|
class Rev:
|
|
def __iter__(self): return iter([])
|
|
def __reversed__(self): return reversed([])
|
|
class RevItBlocked(Rev):
|
|
__iter__ = None
|
|
class RevRevBlocked(Rev):
|
|
__reversed__ = None
|
|
self.assertTrue(issubclass(Rev, Reversible))
|
|
self.assertTrue(isinstance(Rev(), Reversible))
|
|
self.assertFalse(issubclass(RevItBlocked, Reversible))
|
|
self.assertFalse(isinstance(RevItBlocked(), Reversible))
|
|
self.assertFalse(issubclass(RevRevBlocked, Reversible))
|
|
self.assertFalse(isinstance(RevRevBlocked(), Reversible))
|
|
|
|
def test_Collection(self):
|
|
# Check some non-collections
|
|
non_collections = [None, 42, 3.14, 1j, lambda x: 2*x]
|
|
for x in non_collections:
|
|
self.assertNotIsInstance(x, Collection)
|
|
self.assertFalse(issubclass(type(x), Collection), repr(type(x)))
|
|
# Check some non-collection iterables
|
|
non_col_iterables = [_test_gen(), iter(b''), iter(bytearray()),
|
|
(x for x in [])]
|
|
for x in non_col_iterables:
|
|
self.assertNotIsInstance(x, Collection)
|
|
self.assertFalse(issubclass(type(x), Collection), repr(type(x)))
|
|
# Check some collections
|
|
samples = [set(), frozenset(), dict(), bytes(), str(), tuple(),
|
|
list(), dict().keys(), dict().items(), dict().values()]
|
|
for x in samples:
|
|
self.assertIsInstance(x, Collection)
|
|
self.assertTrue(issubclass(type(x), Collection), repr(type(x)))
|
|
# Check also Mapping, MutableMapping, etc.
|
|
self.assertTrue(issubclass(Sequence, Collection), repr(Sequence))
|
|
self.assertTrue(issubclass(Mapping, Collection), repr(Mapping))
|
|
self.assertTrue(issubclass(MutableMapping, Collection),
|
|
repr(MutableMapping))
|
|
self.assertTrue(issubclass(Set, Collection), repr(Set))
|
|
self.assertTrue(issubclass(MutableSet, Collection), repr(MutableSet))
|
|
self.assertTrue(issubclass(Sequence, Collection), repr(MutableSet))
|
|
# Check direct subclassing
|
|
class Col(Collection):
|
|
def __iter__(self):
|
|
return iter(list())
|
|
def __len__(self):
|
|
return 0
|
|
def __contains__(self, item):
|
|
return False
|
|
class DerCol(Col): pass
|
|
self.assertEqual(list(iter(Col())), [])
|
|
self.assertFalse(issubclass(list, Col))
|
|
self.assertFalse(issubclass(set, Col))
|
|
self.assertFalse(issubclass(float, Col))
|
|
self.assertEqual(list(iter(DerCol())), [])
|
|
self.assertFalse(issubclass(list, DerCol))
|
|
self.assertFalse(issubclass(set, DerCol))
|
|
self.assertFalse(issubclass(float, DerCol))
|
|
self.validate_abstract_methods(Collection, '__len__', '__iter__',
|
|
'__contains__')
|
|
# Check sized container non-iterable (which is not Collection) etc.
|
|
class ColNoIter:
|
|
def __len__(self): return 0
|
|
def __contains__(self, item): return False
|
|
class ColNoSize:
|
|
def __iter__(self): return iter([])
|
|
def __contains__(self, item): return False
|
|
class ColNoCont:
|
|
def __iter__(self): return iter([])
|
|
def __len__(self): return 0
|
|
self.assertFalse(issubclass(ColNoIter, Collection))
|
|
self.assertFalse(isinstance(ColNoIter(), Collection))
|
|
self.assertFalse(issubclass(ColNoSize, Collection))
|
|
self.assertFalse(isinstance(ColNoSize(), Collection))
|
|
self.assertFalse(issubclass(ColNoCont, Collection))
|
|
self.assertFalse(isinstance(ColNoCont(), Collection))
|
|
# Check None blocking
|
|
class SizeBlock:
|
|
def __iter__(self): return iter([])
|
|
def __contains__(self): return False
|
|
__len__ = None
|
|
class IterBlock:
|
|
def __len__(self): return 0
|
|
def __contains__(self): return True
|
|
__iter__ = None
|
|
self.assertFalse(issubclass(SizeBlock, Collection))
|
|
self.assertFalse(isinstance(SizeBlock(), Collection))
|
|
self.assertFalse(issubclass(IterBlock, Collection))
|
|
self.assertFalse(isinstance(IterBlock(), Collection))
|
|
# Check None blocking in subclass
|
|
class ColImpl:
|
|
def __iter__(self):
|
|
return iter(list())
|
|
def __len__(self):
|
|
return 0
|
|
def __contains__(self, item):
|
|
return False
|
|
class NonCol(ColImpl):
|
|
__contains__ = None
|
|
self.assertFalse(issubclass(NonCol, Collection))
|
|
self.assertFalse(isinstance(NonCol(), Collection))
|
|
|
|
|
|
def test_Iterator(self):
|
|
non_samples = [None, 42, 3.14, 1j, b"", "", (), [], {}, set()]
|
|
for x in non_samples:
|
|
self.assertNotIsInstance(x, Iterator)
|
|
self.assertFalse(issubclass(type(x), Iterator), repr(type(x)))
|
|
samples = [iter(bytes()), iter(str()),
|
|
iter(tuple()), iter(list()), iter(dict()),
|
|
iter(set()), iter(frozenset()),
|
|
iter(dict().keys()), iter(dict().items()),
|
|
iter(dict().values()),
|
|
_test_gen(),
|
|
(x for x in []),
|
|
]
|
|
for x in samples:
|
|
self.assertIsInstance(x, Iterator)
|
|
self.assertTrue(issubclass(type(x), Iterator), repr(type(x)))
|
|
self.validate_abstract_methods(Iterator, '__next__', '__iter__')
|
|
|
|
# Issue 10565
|
|
class NextOnly:
|
|
def __next__(self):
|
|
yield 1
|
|
return
|
|
self.assertNotIsInstance(NextOnly(), Iterator)
|
|
|
|
def test_Generator(self):
|
|
class NonGen1:
|
|
def __iter__(self): return self
|
|
def __next__(self): return None
|
|
def close(self): pass
|
|
def throw(self, typ, val=None, tb=None): pass
|
|
|
|
class NonGen2:
|
|
def __iter__(self): return self
|
|
def __next__(self): return None
|
|
def close(self): pass
|
|
def send(self, value): return value
|
|
|
|
class NonGen3:
|
|
def close(self): pass
|
|
def send(self, value): return value
|
|
def throw(self, typ, val=None, tb=None): pass
|
|
|
|
non_samples = [
|
|
None, 42, 3.14, 1j, b"", "", (), [], {}, set(),
|
|
iter(()), iter([]), NonGen1(), NonGen2(), NonGen3()]
|
|
for x in non_samples:
|
|
self.assertNotIsInstance(x, Generator)
|
|
self.assertFalse(issubclass(type(x), Generator), repr(type(x)))
|
|
|
|
class Gen:
|
|
def __iter__(self): return self
|
|
def __next__(self): return None
|
|
def close(self): pass
|
|
def send(self, value): return value
|
|
def throw(self, typ, val=None, tb=None): pass
|
|
|
|
class MinimalGen(Generator):
|
|
def send(self, value):
|
|
return value
|
|
def throw(self, typ, val=None, tb=None):
|
|
super().throw(typ, val, tb)
|
|
|
|
def gen():
|
|
yield 1
|
|
|
|
samples = [gen(), (lambda: (yield))(), Gen(), MinimalGen()]
|
|
for x in samples:
|
|
self.assertIsInstance(x, Iterator)
|
|
self.assertIsInstance(x, Generator)
|
|
self.assertTrue(issubclass(type(x), Generator), repr(type(x)))
|
|
self.validate_abstract_methods(Generator, 'send', 'throw')
|
|
|
|
# mixin tests
|
|
mgen = MinimalGen()
|
|
self.assertIs(mgen, iter(mgen))
|
|
self.assertIs(mgen.send(None), next(mgen))
|
|
self.assertEqual(2, mgen.send(2))
|
|
self.assertIsNone(mgen.close())
|
|
self.assertRaises(ValueError, mgen.throw, ValueError)
|
|
self.assertRaisesRegex(ValueError, "^huhu$",
|
|
mgen.throw, ValueError, ValueError("huhu"))
|
|
self.assertRaises(StopIteration, mgen.throw, StopIteration())
|
|
|
|
class FailOnClose(Generator):
|
|
def send(self, value): return value
|
|
def throw(self, *args): raise ValueError
|
|
|
|
self.assertRaises(ValueError, FailOnClose().close)
|
|
|
|
class IgnoreGeneratorExit(Generator):
|
|
def send(self, value): return value
|
|
def throw(self, *args): pass
|
|
|
|
self.assertRaises(RuntimeError, IgnoreGeneratorExit().close)
|
|
|
|
def test_AsyncGenerator(self):
|
|
class NonAGen1:
|
|
def __aiter__(self): return self
|
|
def __anext__(self): return None
|
|
def aclose(self): pass
|
|
def athrow(self, typ, val=None, tb=None): pass
|
|
|
|
class NonAGen2:
|
|
def __aiter__(self): return self
|
|
def __anext__(self): return None
|
|
def aclose(self): pass
|
|
def asend(self, value): return value
|
|
|
|
class NonAGen3:
|
|
def aclose(self): pass
|
|
def asend(self, value): return value
|
|
def athrow(self, typ, val=None, tb=None): pass
|
|
|
|
non_samples = [
|
|
None, 42, 3.14, 1j, b"", "", (), [], {}, set(),
|
|
iter(()), iter([]), NonAGen1(), NonAGen2(), NonAGen3()]
|
|
for x in non_samples:
|
|
self.assertNotIsInstance(x, AsyncGenerator)
|
|
self.assertFalse(issubclass(type(x), AsyncGenerator), repr(type(x)))
|
|
|
|
class Gen:
|
|
def __aiter__(self): return self
|
|
async def __anext__(self): return None
|
|
async def aclose(self): pass
|
|
async def asend(self, value): return value
|
|
async def athrow(self, typ, val=None, tb=None): pass
|
|
|
|
class MinimalAGen(AsyncGenerator):
|
|
async def asend(self, value):
|
|
return value
|
|
async def athrow(self, typ, val=None, tb=None):
|
|
await super().athrow(typ, val, tb)
|
|
|
|
async def gen():
|
|
yield 1
|
|
|
|
samples = [gen(), Gen(), MinimalAGen()]
|
|
for x in samples:
|
|
self.assertIsInstance(x, AsyncIterator)
|
|
self.assertIsInstance(x, AsyncGenerator)
|
|
self.assertTrue(issubclass(type(x), AsyncGenerator), repr(type(x)))
|
|
self.validate_abstract_methods(AsyncGenerator, 'asend', 'athrow')
|
|
|
|
def run_async(coro):
|
|
result = None
|
|
while True:
|
|
try:
|
|
coro.send(None)
|
|
except StopIteration as ex:
|
|
result = ex.args[0] if ex.args else None
|
|
break
|
|
return result
|
|
|
|
# mixin tests
|
|
mgen = MinimalAGen()
|
|
self.assertIs(mgen, mgen.__aiter__())
|
|
self.assertIs(run_async(mgen.asend(None)), run_async(mgen.__anext__()))
|
|
self.assertEqual(2, run_async(mgen.asend(2)))
|
|
self.assertIsNone(run_async(mgen.aclose()))
|
|
with self.assertRaises(ValueError):
|
|
run_async(mgen.athrow(ValueError))
|
|
|
|
class FailOnClose(AsyncGenerator):
|
|
async def asend(self, value): return value
|
|
async def athrow(self, *args): raise ValueError
|
|
|
|
with self.assertRaises(ValueError):
|
|
run_async(FailOnClose().aclose())
|
|
|
|
class IgnoreGeneratorExit(AsyncGenerator):
|
|
async def asend(self, value): return value
|
|
async def athrow(self, *args): pass
|
|
|
|
with self.assertRaises(RuntimeError):
|
|
run_async(IgnoreGeneratorExit().aclose())
|
|
|
|
def test_Sized(self):
|
|
non_samples = [None, 42, 3.14, 1j,
|
|
_test_gen(),
|
|
(x for x in []),
|
|
]
|
|
for x in non_samples:
|
|
self.assertNotIsInstance(x, Sized)
|
|
self.assertFalse(issubclass(type(x), Sized), repr(type(x)))
|
|
samples = [bytes(), str(),
|
|
tuple(), list(), set(), frozenset(), dict(),
|
|
dict().keys(), dict().items(), dict().values(),
|
|
]
|
|
for x in samples:
|
|
self.assertIsInstance(x, Sized)
|
|
self.assertTrue(issubclass(type(x), Sized), repr(type(x)))
|
|
self.validate_abstract_methods(Sized, '__len__')
|
|
self.validate_isinstance(Sized, '__len__')
|
|
|
|
def test_Container(self):
|
|
non_samples = [None, 42, 3.14, 1j,
|
|
_test_gen(),
|
|
(x for x in []),
|
|
]
|
|
for x in non_samples:
|
|
self.assertNotIsInstance(x, Container)
|
|
self.assertFalse(issubclass(type(x), Container), repr(type(x)))
|
|
samples = [bytes(), str(),
|
|
tuple(), list(), set(), frozenset(), dict(),
|
|
dict().keys(), dict().items(),
|
|
]
|
|
for x in samples:
|
|
self.assertIsInstance(x, Container)
|
|
self.assertTrue(issubclass(type(x), Container), repr(type(x)))
|
|
self.validate_abstract_methods(Container, '__contains__')
|
|
self.validate_isinstance(Container, '__contains__')
|
|
|
|
def test_Callable(self):
|
|
non_samples = [None, 42, 3.14, 1j,
|
|
"", b"", (), [], {}, set(),
|
|
_test_gen(),
|
|
(x for x in []),
|
|
]
|
|
for x in non_samples:
|
|
self.assertNotIsInstance(x, Callable)
|
|
self.assertFalse(issubclass(type(x), Callable), repr(type(x)))
|
|
samples = [lambda: None,
|
|
type, int, object,
|
|
len,
|
|
list.append, [].append,
|
|
]
|
|
for x in samples:
|
|
self.assertIsInstance(x, Callable)
|
|
self.assertTrue(issubclass(type(x), Callable), repr(type(x)))
|
|
self.validate_abstract_methods(Callable, '__call__')
|
|
self.validate_isinstance(Callable, '__call__')
|
|
|
|
def test_direct_subclassing(self):
|
|
for B in Hashable, Iterable, Iterator, Reversible, Sized, Container, Callable:
|
|
class C(B):
|
|
pass
|
|
self.assertTrue(issubclass(C, B))
|
|
self.assertFalse(issubclass(int, C))
|
|
|
|
def test_registration(self):
|
|
for B in Hashable, Iterable, Iterator, Reversible, Sized, Container, Callable:
|
|
class C:
|
|
__hash__ = None # Make sure it isn't hashable by default
|
|
self.assertFalse(issubclass(C, B), B.__name__)
|
|
B.register(C)
|
|
self.assertTrue(issubclass(C, B))
|
|
|
|
class WithSet(MutableSet):
|
|
|
|
def __init__(self, it=()):
|
|
self.data = set(it)
|
|
|
|
def __len__(self):
|
|
return len(self.data)
|
|
|
|
def __iter__(self):
|
|
return iter(self.data)
|
|
|
|
def __contains__(self, item):
|
|
return item in self.data
|
|
|
|
def add(self, item):
|
|
self.data.add(item)
|
|
|
|
def discard(self, item):
|
|
self.data.discard(item)
|
|
|
|
class TestCollectionABCs(ABCTestCase):
|
|
|
|
# XXX For now, we only test some virtual inheritance properties.
|
|
# We should also test the proper behavior of the collection ABCs
|
|
# as real base classes or mix-in classes.
|
|
|
|
def test_Set(self):
|
|
for sample in [set, frozenset]:
|
|
self.assertIsInstance(sample(), Set)
|
|
self.assertTrue(issubclass(sample, Set))
|
|
self.validate_abstract_methods(Set, '__contains__', '__iter__', '__len__')
|
|
class MySet(Set):
|
|
def __contains__(self, x):
|
|
return False
|
|
def __len__(self):
|
|
return 0
|
|
def __iter__(self):
|
|
return iter([])
|
|
self.validate_comparison(MySet())
|
|
|
|
def test_hash_Set(self):
|
|
class OneTwoThreeSet(Set):
|
|
def __init__(self):
|
|
self.contents = [1, 2, 3]
|
|
def __contains__(self, x):
|
|
return x in self.contents
|
|
def __len__(self):
|
|
return len(self.contents)
|
|
def __iter__(self):
|
|
return iter(self.contents)
|
|
def __hash__(self):
|
|
return self._hash()
|
|
a, b = OneTwoThreeSet(), OneTwoThreeSet()
|
|
self.assertTrue(hash(a) == hash(b))
|
|
|
|
def test_isdisjoint_Set(self):
|
|
class MySet(Set):
|
|
def __init__(self, itr):
|
|
self.contents = itr
|
|
def __contains__(self, x):
|
|
return x in self.contents
|
|
def __iter__(self):
|
|
return iter(self.contents)
|
|
def __len__(self):
|
|
return len([x for x in self.contents])
|
|
s1 = MySet((1, 2, 3))
|
|
s2 = MySet((4, 5, 6))
|
|
s3 = MySet((1, 5, 6))
|
|
self.assertTrue(s1.isdisjoint(s2))
|
|
self.assertFalse(s1.isdisjoint(s3))
|
|
|
|
def test_equality_Set(self):
|
|
class MySet(Set):
|
|
def __init__(self, itr):
|
|
self.contents = itr
|
|
def __contains__(self, x):
|
|
return x in self.contents
|
|
def __iter__(self):
|
|
return iter(self.contents)
|
|
def __len__(self):
|
|
return len([x for x in self.contents])
|
|
s1 = MySet((1,))
|
|
s2 = MySet((1, 2))
|
|
s3 = MySet((3, 4))
|
|
s4 = MySet((3, 4))
|
|
self.assertTrue(s2 > s1)
|
|
self.assertTrue(s1 < s2)
|
|
self.assertFalse(s2 <= s1)
|
|
self.assertFalse(s2 <= s3)
|
|
self.assertFalse(s1 >= s2)
|
|
self.assertEqual(s3, s4)
|
|
self.assertNotEqual(s2, s3)
|
|
|
|
def test_arithmetic_Set(self):
|
|
class MySet(Set):
|
|
def __init__(self, itr):
|
|
self.contents = itr
|
|
def __contains__(self, x):
|
|
return x in self.contents
|
|
def __iter__(self):
|
|
return iter(self.contents)
|
|
def __len__(self):
|
|
return len([x for x in self.contents])
|
|
s1 = MySet((1, 2, 3))
|
|
s2 = MySet((3, 4, 5))
|
|
s3 = s1 & s2
|
|
self.assertEqual(s3, MySet((3,)))
|
|
|
|
def test_MutableSet(self):
|
|
self.assertIsInstance(set(), MutableSet)
|
|
self.assertTrue(issubclass(set, MutableSet))
|
|
self.assertNotIsInstance(frozenset(), MutableSet)
|
|
self.assertFalse(issubclass(frozenset, MutableSet))
|
|
self.validate_abstract_methods(MutableSet, '__contains__', '__iter__', '__len__',
|
|
'add', 'discard')
|
|
|
|
def test_issue_5647(self):
|
|
# MutableSet.__iand__ mutated the set during iteration
|
|
s = WithSet('abcd')
|
|
s &= WithSet('cdef') # This used to fail
|
|
self.assertEqual(set(s), set('cd'))
|
|
|
|
def test_issue_4920(self):
|
|
# MutableSet.pop() method did not work
|
|
class MySet(MutableSet):
|
|
__slots__=['__s']
|
|
def __init__(self,items=None):
|
|
if items is None:
|
|
items=[]
|
|
self.__s=set(items)
|
|
def __contains__(self,v):
|
|
return v in self.__s
|
|
def __iter__(self):
|
|
return iter(self.__s)
|
|
def __len__(self):
|
|
return len(self.__s)
|
|
def add(self,v):
|
|
result=v not in self.__s
|
|
self.__s.add(v)
|
|
return result
|
|
def discard(self,v):
|
|
result=v in self.__s
|
|
self.__s.discard(v)
|
|
return result
|
|
def __repr__(self):
|
|
return "MySet(%s)" % repr(list(self))
|
|
s = MySet([5,43,2,1])
|
|
self.assertEqual(s.pop(), 1)
|
|
|
|
def test_issue8750(self):
|
|
empty = WithSet()
|
|
full = WithSet(range(10))
|
|
s = WithSet(full)
|
|
s -= s
|
|
self.assertEqual(s, empty)
|
|
s = WithSet(full)
|
|
s ^= s
|
|
self.assertEqual(s, empty)
|
|
s = WithSet(full)
|
|
s &= s
|
|
self.assertEqual(s, full)
|
|
s |= s
|
|
self.assertEqual(s, full)
|
|
|
|
def test_issue16373(self):
|
|
# Recursion error comparing comparable and noncomparable
|
|
# Set instances
|
|
class MyComparableSet(Set):
|
|
def __contains__(self, x):
|
|
return False
|
|
def __len__(self):
|
|
return 0
|
|
def __iter__(self):
|
|
return iter([])
|
|
class MyNonComparableSet(Set):
|
|
def __contains__(self, x):
|
|
return False
|
|
def __len__(self):
|
|
return 0
|
|
def __iter__(self):
|
|
return iter([])
|
|
def __le__(self, x):
|
|
return NotImplemented
|
|
def __lt__(self, x):
|
|
return NotImplemented
|
|
|
|
cs = MyComparableSet()
|
|
ncs = MyNonComparableSet()
|
|
self.assertFalse(ncs < cs)
|
|
self.assertTrue(ncs <= cs)
|
|
self.assertFalse(ncs > cs)
|
|
self.assertTrue(ncs >= cs)
|
|
|
|
def test_issue26915(self):
|
|
# Container membership test should check identity first
|
|
class CustomEqualObject:
|
|
def __eq__(self, other):
|
|
return False
|
|
class CustomSequence(Sequence):
|
|
def __init__(self, seq):
|
|
self._seq = seq
|
|
def __getitem__(self, index):
|
|
return self._seq[index]
|
|
def __len__(self):
|
|
return len(self._seq)
|
|
|
|
nan = float('nan')
|
|
obj = CustomEqualObject()
|
|
seq = CustomSequence([nan, obj, nan])
|
|
containers = [
|
|
seq,
|
|
ItemsView({1: nan, 2: obj}),
|
|
ValuesView({1: nan, 2: obj})
|
|
]
|
|
for container in containers:
|
|
for elem in container:
|
|
self.assertIn(elem, container)
|
|
self.assertEqual(seq.index(nan), 0)
|
|
self.assertEqual(seq.index(obj), 1)
|
|
self.assertEqual(seq.count(nan), 2)
|
|
self.assertEqual(seq.count(obj), 1)
|
|
|
|
def assertSameSet(self, s1, s2):
|
|
# coerce both to a real set then check equality
|
|
self.assertSetEqual(set(s1), set(s2))
|
|
|
|
def test_Set_interoperability_with_real_sets(self):
|
|
# Issue: 8743
|
|
class ListSet(Set):
|
|
def __init__(self, elements=()):
|
|
self.data = []
|
|
for elem in elements:
|
|
if elem not in self.data:
|
|
self.data.append(elem)
|
|
def __contains__(self, elem):
|
|
return elem in self.data
|
|
def __iter__(self):
|
|
return iter(self.data)
|
|
def __len__(self):
|
|
return len(self.data)
|
|
def __repr__(self):
|
|
return 'Set({!r})'.format(self.data)
|
|
|
|
r1 = set('abc')
|
|
r2 = set('bcd')
|
|
r3 = set('abcde')
|
|
f1 = ListSet('abc')
|
|
f2 = ListSet('bcd')
|
|
f3 = ListSet('abcde')
|
|
l1 = list('abccba')
|
|
l2 = list('bcddcb')
|
|
l3 = list('abcdeedcba')
|
|
|
|
target = r1 & r2
|
|
self.assertSameSet(f1 & f2, target)
|
|
self.assertSameSet(f1 & r2, target)
|
|
self.assertSameSet(r2 & f1, target)
|
|
self.assertSameSet(f1 & l2, target)
|
|
|
|
target = r1 | r2
|
|
self.assertSameSet(f1 | f2, target)
|
|
self.assertSameSet(f1 | r2, target)
|
|
self.assertSameSet(r2 | f1, target)
|
|
self.assertSameSet(f1 | l2, target)
|
|
|
|
fwd_target = r1 - r2
|
|
rev_target = r2 - r1
|
|
self.assertSameSet(f1 - f2, fwd_target)
|
|
self.assertSameSet(f2 - f1, rev_target)
|
|
self.assertSameSet(f1 - r2, fwd_target)
|
|
self.assertSameSet(f2 - r1, rev_target)
|
|
self.assertSameSet(r1 - f2, fwd_target)
|
|
self.assertSameSet(r2 - f1, rev_target)
|
|
self.assertSameSet(f1 - l2, fwd_target)
|
|
self.assertSameSet(f2 - l1, rev_target)
|
|
|
|
target = r1 ^ r2
|
|
self.assertSameSet(f1 ^ f2, target)
|
|
self.assertSameSet(f1 ^ r2, target)
|
|
self.assertSameSet(r2 ^ f1, target)
|
|
self.assertSameSet(f1 ^ l2, target)
|
|
|
|
# Don't change the following to use assertLess or other
|
|
# "more specific" unittest assertions. The current
|
|
# assertTrue/assertFalse style makes the pattern of test
|
|
# case combinations clear and allows us to know for sure
|
|
# the exact operator being invoked.
|
|
|
|
# proper subset
|
|
self.assertTrue(f1 < f3)
|
|
self.assertFalse(f1 < f1)
|
|
self.assertFalse(f1 < f2)
|
|
self.assertTrue(r1 < f3)
|
|
self.assertFalse(r1 < f1)
|
|
self.assertFalse(r1 < f2)
|
|
self.assertTrue(r1 < r3)
|
|
self.assertFalse(r1 < r1)
|
|
self.assertFalse(r1 < r2)
|
|
with self.assertRaises(TypeError):
|
|
f1 < l3
|
|
with self.assertRaises(TypeError):
|
|
f1 < l1
|
|
with self.assertRaises(TypeError):
|
|
f1 < l2
|
|
|
|
# any subset
|
|
self.assertTrue(f1 <= f3)
|
|
self.assertTrue(f1 <= f1)
|
|
self.assertFalse(f1 <= f2)
|
|
self.assertTrue(r1 <= f3)
|
|
self.assertTrue(r1 <= f1)
|
|
self.assertFalse(r1 <= f2)
|
|
self.assertTrue(r1 <= r3)
|
|
self.assertTrue(r1 <= r1)
|
|
self.assertFalse(r1 <= r2)
|
|
with self.assertRaises(TypeError):
|
|
f1 <= l3
|
|
with self.assertRaises(TypeError):
|
|
f1 <= l1
|
|
with self.assertRaises(TypeError):
|
|
f1 <= l2
|
|
|
|
# proper superset
|
|
self.assertTrue(f3 > f1)
|
|
self.assertFalse(f1 > f1)
|
|
self.assertFalse(f2 > f1)
|
|
self.assertTrue(r3 > r1)
|
|
self.assertFalse(f1 > r1)
|
|
self.assertFalse(f2 > r1)
|
|
self.assertTrue(r3 > r1)
|
|
self.assertFalse(r1 > r1)
|
|
self.assertFalse(r2 > r1)
|
|
with self.assertRaises(TypeError):
|
|
f1 > l3
|
|
with self.assertRaises(TypeError):
|
|
f1 > l1
|
|
with self.assertRaises(TypeError):
|
|
f1 > l2
|
|
|
|
# any superset
|
|
self.assertTrue(f3 >= f1)
|
|
self.assertTrue(f1 >= f1)
|
|
self.assertFalse(f2 >= f1)
|
|
self.assertTrue(r3 >= r1)
|
|
self.assertTrue(f1 >= r1)
|
|
self.assertFalse(f2 >= r1)
|
|
self.assertTrue(r3 >= r1)
|
|
self.assertTrue(r1 >= r1)
|
|
self.assertFalse(r2 >= r1)
|
|
with self.assertRaises(TypeError):
|
|
f1 >= l3
|
|
with self.assertRaises(TypeError):
|
|
f1 >=l1
|
|
with self.assertRaises(TypeError):
|
|
f1 >= l2
|
|
|
|
# equality
|
|
self.assertTrue(f1 == f1)
|
|
self.assertTrue(r1 == f1)
|
|
self.assertTrue(f1 == r1)
|
|
self.assertFalse(f1 == f3)
|
|
self.assertFalse(r1 == f3)
|
|
self.assertFalse(f1 == r3)
|
|
self.assertFalse(f1 == l3)
|
|
self.assertFalse(f1 == l1)
|
|
self.assertFalse(f1 == l2)
|
|
|
|
# inequality
|
|
self.assertFalse(f1 != f1)
|
|
self.assertFalse(r1 != f1)
|
|
self.assertFalse(f1 != r1)
|
|
self.assertTrue(f1 != f3)
|
|
self.assertTrue(r1 != f3)
|
|
self.assertTrue(f1 != r3)
|
|
self.assertTrue(f1 != l3)
|
|
self.assertTrue(f1 != l1)
|
|
self.assertTrue(f1 != l2)
|
|
|
|
def test_Mapping(self):
|
|
for sample in [dict]:
|
|
self.assertIsInstance(sample(), Mapping)
|
|
self.assertTrue(issubclass(sample, Mapping))
|
|
self.validate_abstract_methods(Mapping, '__contains__', '__iter__', '__len__',
|
|
'__getitem__')
|
|
class MyMapping(Mapping):
|
|
def __len__(self):
|
|
return 0
|
|
def __getitem__(self, i):
|
|
raise IndexError
|
|
def __iter__(self):
|
|
return iter(())
|
|
self.validate_comparison(MyMapping())
|
|
self.assertRaises(TypeError, reversed, MyMapping())
|
|
|
|
def test_MutableMapping(self):
|
|
for sample in [dict]:
|
|
self.assertIsInstance(sample(), MutableMapping)
|
|
self.assertTrue(issubclass(sample, MutableMapping))
|
|
self.validate_abstract_methods(MutableMapping, '__contains__', '__iter__', '__len__',
|
|
'__getitem__', '__setitem__', '__delitem__')
|
|
|
|
def test_MutableMapping_subclass(self):
|
|
# Test issue 9214
|
|
mymap = UserDict()
|
|
mymap['red'] = 5
|
|
self.assertIsInstance(mymap.keys(), Set)
|
|
self.assertIsInstance(mymap.keys(), KeysView)
|
|
self.assertIsInstance(mymap.items(), Set)
|
|
self.assertIsInstance(mymap.items(), ItemsView)
|
|
|
|
mymap = UserDict()
|
|
mymap['red'] = 5
|
|
z = mymap.keys() | {'orange'}
|
|
self.assertIsInstance(z, set)
|
|
list(z)
|
|
mymap['blue'] = 7 # Shouldn't affect 'z'
|
|
self.assertEqual(sorted(z), ['orange', 'red'])
|
|
|
|
mymap = UserDict()
|
|
mymap['red'] = 5
|
|
z = mymap.items() | {('orange', 3)}
|
|
self.assertIsInstance(z, set)
|
|
list(z)
|
|
mymap['blue'] = 7 # Shouldn't affect 'z'
|
|
self.assertEqual(z, {('orange', 3), ('red', 5)})
|
|
|
|
def test_Sequence(self):
|
|
for sample in [tuple, list, bytes, str]:
|
|
self.assertIsInstance(sample(), Sequence)
|
|
self.assertTrue(issubclass(sample, Sequence))
|
|
self.assertIsInstance(range(10), Sequence)
|
|
self.assertTrue(issubclass(range, Sequence))
|
|
self.assertIsInstance(memoryview(b""), Sequence)
|
|
self.assertTrue(issubclass(memoryview, Sequence))
|
|
self.assertTrue(issubclass(str, Sequence))
|
|
self.validate_abstract_methods(Sequence, '__contains__', '__iter__', '__len__',
|
|
'__getitem__')
|
|
|
|
def test_Sequence_mixins(self):
|
|
class SequenceSubclass(Sequence):
|
|
def __init__(self, seq=()):
|
|
self.seq = seq
|
|
|
|
def __getitem__(self, index):
|
|
return self.seq[index]
|
|
|
|
def __len__(self):
|
|
return len(self.seq)
|
|
|
|
# Compare Sequence.index() behavior to (list|str).index() behavior
|
|
def assert_index_same(seq1, seq2, index_args):
|
|
try:
|
|
expected = seq1.index(*index_args)
|
|
except ValueError:
|
|
with self.assertRaises(ValueError):
|
|
seq2.index(*index_args)
|
|
else:
|
|
actual = seq2.index(*index_args)
|
|
self.assertEqual(
|
|
actual, expected, '%r.index%s' % (seq1, index_args))
|
|
|
|
for ty in list, str:
|
|
nativeseq = ty('abracadabra')
|
|
indexes = [-10000, -9999] + list(range(-3, len(nativeseq) + 3))
|
|
seqseq = SequenceSubclass(nativeseq)
|
|
for letter in set(nativeseq) | {'z'}:
|
|
assert_index_same(nativeseq, seqseq, (letter,))
|
|
for start in range(-3, len(nativeseq) + 3):
|
|
assert_index_same(nativeseq, seqseq, (letter, start))
|
|
for stop in range(-3, len(nativeseq) + 3):
|
|
assert_index_same(
|
|
nativeseq, seqseq, (letter, start, stop))
|
|
|
|
def test_ByteString(self):
|
|
for sample in [bytes, bytearray]:
|
|
self.assertIsInstance(sample(), ByteString)
|
|
self.assertTrue(issubclass(sample, ByteString))
|
|
for sample in [str, list, tuple]:
|
|
self.assertNotIsInstance(sample(), ByteString)
|
|
self.assertFalse(issubclass(sample, ByteString))
|
|
self.assertNotIsInstance(memoryview(b""), ByteString)
|
|
self.assertFalse(issubclass(memoryview, ByteString))
|
|
|
|
def test_MutableSequence(self):
|
|
for sample in [tuple, str, bytes]:
|
|
self.assertNotIsInstance(sample(), MutableSequence)
|
|
self.assertFalse(issubclass(sample, MutableSequence))
|
|
for sample in [list, bytearray, deque]:
|
|
self.assertIsInstance(sample(), MutableSequence)
|
|
self.assertTrue(issubclass(sample, MutableSequence))
|
|
self.assertFalse(issubclass(str, MutableSequence))
|
|
self.validate_abstract_methods(MutableSequence, '__contains__', '__iter__',
|
|
'__len__', '__getitem__', '__setitem__', '__delitem__', 'insert')
|
|
|
|
def test_MutableSequence_mixins(self):
|
|
# Test the mixins of MutableSequence by creating a minimal concrete
|
|
# class inherited from it.
|
|
class MutableSequenceSubclass(MutableSequence):
|
|
def __init__(self):
|
|
self.lst = []
|
|
|
|
def __setitem__(self, index, value):
|
|
self.lst[index] = value
|
|
|
|
def __getitem__(self, index):
|
|
return self.lst[index]
|
|
|
|
def __len__(self):
|
|
return len(self.lst)
|
|
|
|
def __delitem__(self, index):
|
|
del self.lst[index]
|
|
|
|
def insert(self, index, value):
|
|
self.lst.insert(index, value)
|
|
|
|
mss = MutableSequenceSubclass()
|
|
mss.append(0)
|
|
mss.extend((1, 2, 3, 4))
|
|
self.assertEqual(len(mss), 5)
|
|
self.assertEqual(mss[3], 3)
|
|
mss.reverse()
|
|
self.assertEqual(mss[3], 1)
|
|
mss.pop()
|
|
self.assertEqual(len(mss), 4)
|
|
mss.remove(3)
|
|
self.assertEqual(len(mss), 3)
|
|
mss += (10, 20, 30)
|
|
self.assertEqual(len(mss), 6)
|
|
self.assertEqual(mss[-1], 30)
|
|
mss.clear()
|
|
self.assertEqual(len(mss), 0)
|
|
|
|
# issue 34427
|
|
# extending self should not cause infinite loop
|
|
items = 'ABCD'
|
|
mss2 = MutableSequenceSubclass()
|
|
mss2.extend(items + items)
|
|
mss.clear()
|
|
mss.extend(items)
|
|
mss.extend(mss)
|
|
self.assertEqual(len(mss), len(mss2))
|
|
self.assertEqual(list(mss), list(mss2))
|
|
|
|
|
|
################################################################################
|
|
### Counter
|
|
################################################################################
|
|
|
|
class CounterSubclassWithSetItem(Counter):
|
|
# Test a counter subclass that overrides __setitem__
|
|
def __init__(self, *args, **kwds):
|
|
self.called = False
|
|
Counter.__init__(self, *args, **kwds)
|
|
def __setitem__(self, key, value):
|
|
self.called = True
|
|
Counter.__setitem__(self, key, value)
|
|
|
|
class CounterSubclassWithGet(Counter):
|
|
# Test a counter subclass that overrides get()
|
|
def __init__(self, *args, **kwds):
|
|
self.called = False
|
|
Counter.__init__(self, *args, **kwds)
|
|
def get(self, key, default):
|
|
self.called = True
|
|
return Counter.get(self, key, default)
|
|
|
|
class TestCounter(unittest.TestCase):
|
|
|
|
def test_basics(self):
|
|
c = Counter('abcaba')
|
|
self.assertEqual(c, Counter({'a':3 , 'b': 2, 'c': 1}))
|
|
self.assertEqual(c, Counter(a=3, b=2, c=1))
|
|
self.assertIsInstance(c, dict)
|
|
self.assertIsInstance(c, Mapping)
|
|
self.assertTrue(issubclass(Counter, dict))
|
|
self.assertTrue(issubclass(Counter, Mapping))
|
|
self.assertEqual(len(c), 3)
|
|
self.assertEqual(sum(c.values()), 6)
|
|
self.assertEqual(list(c.values()), [3, 2, 1])
|
|
self.assertEqual(list(c.keys()), ['a', 'b', 'c'])
|
|
self.assertEqual(list(c), ['a', 'b', 'c'])
|
|
self.assertEqual(list(c.items()),
|
|
[('a', 3), ('b', 2), ('c', 1)])
|
|
self.assertEqual(c['b'], 2)
|
|
self.assertEqual(c['z'], 0)
|
|
self.assertEqual(c.__contains__('c'), True)
|
|
self.assertEqual(c.__contains__('z'), False)
|
|
self.assertEqual(c.get('b', 10), 2)
|
|
self.assertEqual(c.get('z', 10), 10)
|
|
self.assertEqual(c, dict(a=3, b=2, c=1))
|
|
self.assertEqual(repr(c), "Counter({'a': 3, 'b': 2, 'c': 1})")
|
|
self.assertEqual(c.most_common(), [('a', 3), ('b', 2), ('c', 1)])
|
|
for i in range(5):
|
|
self.assertEqual(c.most_common(i),
|
|
[('a', 3), ('b', 2), ('c', 1)][:i])
|
|
self.assertEqual(''.join(c.elements()), 'aaabbc')
|
|
c['a'] += 1 # increment an existing value
|
|
c['b'] -= 2 # sub existing value to zero
|
|
del c['c'] # remove an entry
|
|
del c['c'] # make sure that del doesn't raise KeyError
|
|
c['d'] -= 2 # sub from a missing value
|
|
c['e'] = -5 # directly assign a missing value
|
|
c['f'] += 4 # add to a missing value
|
|
self.assertEqual(c, dict(a=4, b=0, d=-2, e=-5, f=4))
|
|
self.assertEqual(''.join(c.elements()), 'aaaaffff')
|
|
self.assertEqual(c.pop('f'), 4)
|
|
self.assertNotIn('f', c)
|
|
for i in range(3):
|
|
elem, cnt = c.popitem()
|
|
self.assertNotIn(elem, c)
|
|
c.clear()
|
|
self.assertEqual(c, {})
|
|
self.assertEqual(repr(c), 'Counter()')
|
|
self.assertRaises(NotImplementedError, Counter.fromkeys, 'abc')
|
|
self.assertRaises(TypeError, hash, c)
|
|
c.update(dict(a=5, b=3))
|
|
c.update(c=1)
|
|
c.update(Counter('a' * 50 + 'b' * 30))
|
|
c.update() # test case with no args
|
|
c.__init__('a' * 500 + 'b' * 300)
|
|
c.__init__('cdc')
|
|
c.__init__()
|
|
self.assertEqual(c, dict(a=555, b=333, c=3, d=1))
|
|
self.assertEqual(c.setdefault('d', 5), 1)
|
|
self.assertEqual(c['d'], 1)
|
|
self.assertEqual(c.setdefault('e', 5), 5)
|
|
self.assertEqual(c['e'], 5)
|
|
|
|
def test_init(self):
|
|
self.assertEqual(list(Counter(self=42).items()), [('self', 42)])
|
|
self.assertEqual(list(Counter(iterable=42).items()), [('iterable', 42)])
|
|
self.assertEqual(list(Counter(iterable=None).items()), [('iterable', None)])
|
|
self.assertRaises(TypeError, Counter, 42)
|
|
self.assertRaises(TypeError, Counter, (), ())
|
|
self.assertRaises(TypeError, Counter.__init__)
|
|
|
|
def test_order_preservation(self):
|
|
# Input order dictates items() order
|
|
self.assertEqual(list(Counter('abracadabra').items()),
|
|
[('a', 5), ('b', 2), ('r', 2), ('c', 1), ('d', 1)])
|
|
# letters with same count: ^----------^ ^---------^
|
|
|
|
# Verify retention of order even when all counts are equal
|
|
self.assertEqual(list(Counter('xyzpdqqdpzyx').items()),
|
|
[('x', 2), ('y', 2), ('z', 2), ('p', 2), ('d', 2), ('q', 2)])
|
|
|
|
# Input order dictates elements() order
|
|
self.assertEqual(list(Counter('abracadabra simsalabim').elements()),
|
|
['a', 'a', 'a', 'a', 'a', 'a', 'a', 'b', 'b', 'b','r',
|
|
'r', 'c', 'd', ' ', 's', 's', 'i', 'i', 'm', 'm', 'l'])
|
|
|
|
# Math operations order first by the order encountered in the left
|
|
# operand and then by the order encounted in the right operand.
|
|
ps = 'aaabbcdddeefggghhijjjkkl'
|
|
qs = 'abbcccdeefffhkkllllmmnno'
|
|
order = {letter: i for i, letter in enumerate(dict.fromkeys(ps + qs))}
|
|
def correctly_ordered(seq):
|
|
'Return true if the letters occur in the expected order'
|
|
positions = [order[letter] for letter in seq]
|
|
return positions == sorted(positions)
|
|
|
|
p, q = Counter(ps), Counter(qs)
|
|
self.assertTrue(correctly_ordered(+p))
|
|
self.assertTrue(correctly_ordered(-p))
|
|
self.assertTrue(correctly_ordered(p + q))
|
|
self.assertTrue(correctly_ordered(p - q))
|
|
self.assertTrue(correctly_ordered(p | q))
|
|
self.assertTrue(correctly_ordered(p & q))
|
|
|
|
p, q = Counter(ps), Counter(qs)
|
|
p += q
|
|
self.assertTrue(correctly_ordered(p))
|
|
|
|
p, q = Counter(ps), Counter(qs)
|
|
p -= q
|
|
self.assertTrue(correctly_ordered(p))
|
|
|
|
p, q = Counter(ps), Counter(qs)
|
|
p |= q
|
|
self.assertTrue(correctly_ordered(p))
|
|
|
|
p, q = Counter(ps), Counter(qs)
|
|
p &= q
|
|
self.assertTrue(correctly_ordered(p))
|
|
|
|
p, q = Counter(ps), Counter(qs)
|
|
p.update(q)
|
|
self.assertTrue(correctly_ordered(p))
|
|
|
|
p, q = Counter(ps), Counter(qs)
|
|
p.subtract(q)
|
|
self.assertTrue(correctly_ordered(p))
|
|
|
|
def test_update(self):
|
|
c = Counter()
|
|
c.update(self=42)
|
|
self.assertEqual(list(c.items()), [('self', 42)])
|
|
c = Counter()
|
|
c.update(iterable=42)
|
|
self.assertEqual(list(c.items()), [('iterable', 42)])
|
|
c = Counter()
|
|
c.update(iterable=None)
|
|
self.assertEqual(list(c.items()), [('iterable', None)])
|
|
self.assertRaises(TypeError, Counter().update, 42)
|
|
self.assertRaises(TypeError, Counter().update, {}, {})
|
|
self.assertRaises(TypeError, Counter.update)
|
|
|
|
def test_copying(self):
|
|
# Check that counters are copyable, deepcopyable, picklable, and
|
|
#have a repr/eval round-trip
|
|
words = Counter('which witch had which witches wrist watch'.split())
|
|
def check(dup):
|
|
msg = "\ncopy: %s\nwords: %s" % (dup, words)
|
|
self.assertIsNot(dup, words, msg)
|
|
self.assertEqual(dup, words)
|
|
check(words.copy())
|
|
check(copy.copy(words))
|
|
check(copy.deepcopy(words))
|
|
for proto in range(pickle.HIGHEST_PROTOCOL + 1):
|
|
with self.subTest(proto=proto):
|
|
check(pickle.loads(pickle.dumps(words, proto)))
|
|
check(eval(repr(words)))
|
|
update_test = Counter()
|
|
update_test.update(words)
|
|
check(update_test)
|
|
check(Counter(words))
|
|
|
|
def test_copy_subclass(self):
|
|
class MyCounter(Counter):
|
|
pass
|
|
c = MyCounter('slartibartfast')
|
|
d = c.copy()
|
|
self.assertEqual(d, c)
|
|
self.assertEqual(len(d), len(c))
|
|
self.assertEqual(type(d), type(c))
|
|
|
|
def test_conversions(self):
|
|
# Convert to: set, list, dict
|
|
s = 'she sells sea shells by the sea shore'
|
|
self.assertEqual(sorted(Counter(s).elements()), sorted(s))
|
|
self.assertEqual(sorted(Counter(s)), sorted(set(s)))
|
|
self.assertEqual(dict(Counter(s)), dict(Counter(s).items()))
|
|
self.assertEqual(set(Counter(s)), set(s))
|
|
|
|
def test_invariant_for_the_in_operator(self):
|
|
c = Counter(a=10, b=-2, c=0)
|
|
for elem in c:
|
|
self.assertTrue(elem in c)
|
|
self.assertIn(elem, c)
|
|
|
|
def test_multiset_operations(self):
|
|
# Verify that adding a zero counter will strip zeros and negatives
|
|
c = Counter(a=10, b=-2, c=0) + Counter()
|
|
self.assertEqual(dict(c), dict(a=10))
|
|
|
|
elements = 'abcd'
|
|
for i in range(1000):
|
|
# test random pairs of multisets
|
|
p = Counter(dict((elem, randrange(-2,4)) for elem in elements))
|
|
p.update(e=1, f=-1, g=0)
|
|
q = Counter(dict((elem, randrange(-2,4)) for elem in elements))
|
|
q.update(h=1, i=-1, j=0)
|
|
for counterop, numberop in [
|
|
(Counter.__add__, lambda x, y: max(0, x+y)),
|
|
(Counter.__sub__, lambda x, y: max(0, x-y)),
|
|
(Counter.__or__, lambda x, y: max(0,x,y)),
|
|
(Counter.__and__, lambda x, y: max(0, min(x,y))),
|
|
]:
|
|
result = counterop(p, q)
|
|
for x in elements:
|
|
self.assertEqual(numberop(p[x], q[x]), result[x],
|
|
(counterop, x, p, q))
|
|
# verify that results exclude non-positive counts
|
|
self.assertTrue(x>0 for x in result.values())
|
|
|
|
elements = 'abcdef'
|
|
for i in range(100):
|
|
# verify that random multisets with no repeats are exactly like sets
|
|
p = Counter(dict((elem, randrange(0, 2)) for elem in elements))
|
|
q = Counter(dict((elem, randrange(0, 2)) for elem in elements))
|
|
for counterop, setop in [
|
|
(Counter.__sub__, set.__sub__),
|
|
(Counter.__or__, set.__or__),
|
|
(Counter.__and__, set.__and__),
|
|
]:
|
|
counter_result = counterop(p, q)
|
|
set_result = setop(set(p.elements()), set(q.elements()))
|
|
self.assertEqual(counter_result, dict.fromkeys(set_result, 1))
|
|
|
|
def test_inplace_operations(self):
|
|
elements = 'abcd'
|
|
for i in range(1000):
|
|
# test random pairs of multisets
|
|
p = Counter(dict((elem, randrange(-2,4)) for elem in elements))
|
|
p.update(e=1, f=-1, g=0)
|
|
q = Counter(dict((elem, randrange(-2,4)) for elem in elements))
|
|
q.update(h=1, i=-1, j=0)
|
|
for inplace_op, regular_op in [
|
|
(Counter.__iadd__, Counter.__add__),
|
|
(Counter.__isub__, Counter.__sub__),
|
|
(Counter.__ior__, Counter.__or__),
|
|
(Counter.__iand__, Counter.__and__),
|
|
]:
|
|
c = p.copy()
|
|
c_id = id(c)
|
|
regular_result = regular_op(c, q)
|
|
inplace_result = inplace_op(c, q)
|
|
self.assertEqual(inplace_result, regular_result)
|
|
self.assertEqual(id(inplace_result), c_id)
|
|
|
|
def test_subtract(self):
|
|
c = Counter(a=-5, b=0, c=5, d=10, e=15,g=40)
|
|
c.subtract(a=1, b=2, c=-3, d=10, e=20, f=30, h=-50)
|
|
self.assertEqual(c, Counter(a=-6, b=-2, c=8, d=0, e=-5, f=-30, g=40, h=50))
|
|
c = Counter(a=-5, b=0, c=5, d=10, e=15,g=40)
|
|
c.subtract(Counter(a=1, b=2, c=-3, d=10, e=20, f=30, h=-50))
|
|
self.assertEqual(c, Counter(a=-6, b=-2, c=8, d=0, e=-5, f=-30, g=40, h=50))
|
|
c = Counter('aaabbcd')
|
|
c.subtract('aaaabbcce')
|
|
self.assertEqual(c, Counter(a=-1, b=0, c=-1, d=1, e=-1))
|
|
|
|
c = Counter()
|
|
c.subtract(self=42)
|
|
self.assertEqual(list(c.items()), [('self', -42)])
|
|
c = Counter()
|
|
c.subtract(iterable=42)
|
|
self.assertEqual(list(c.items()), [('iterable', -42)])
|
|
self.assertRaises(TypeError, Counter().subtract, 42)
|
|
self.assertRaises(TypeError, Counter().subtract, {}, {})
|
|
self.assertRaises(TypeError, Counter.subtract)
|
|
|
|
def test_unary(self):
|
|
c = Counter(a=-5, b=0, c=5, d=10, e=15,g=40)
|
|
self.assertEqual(dict(+c), dict(c=5, d=10, e=15, g=40))
|
|
self.assertEqual(dict(-c), dict(a=5))
|
|
|
|
def test_repr_nonsortable(self):
|
|
c = Counter(a=2, b=None)
|
|
r = repr(c)
|
|
self.assertIn("'a': 2", r)
|
|
self.assertIn("'b': None", r)
|
|
|
|
def test_helper_function(self):
|
|
# two paths, one for real dicts and one for other mappings
|
|
elems = list('abracadabra')
|
|
|
|
d = dict()
|
|
_count_elements(d, elems)
|
|
self.assertEqual(d, {'a': 5, 'r': 2, 'b': 2, 'c': 1, 'd': 1})
|
|
|
|
m = OrderedDict()
|
|
_count_elements(m, elems)
|
|
self.assertEqual(m,
|
|
OrderedDict([('a', 5), ('b', 2), ('r', 2), ('c', 1), ('d', 1)]))
|
|
|
|
# test fidelity to the pure python version
|
|
c = CounterSubclassWithSetItem('abracadabra')
|
|
self.assertTrue(c.called)
|
|
self.assertEqual(dict(c), {'a': 5, 'b': 2, 'c': 1, 'd': 1, 'r':2 })
|
|
c = CounterSubclassWithGet('abracadabra')
|
|
self.assertTrue(c.called)
|
|
self.assertEqual(dict(c), {'a': 5, 'b': 2, 'c': 1, 'd': 1, 'r':2 })
|
|
|
|
|
|
################################################################################
|
|
### Run tests
|
|
################################################################################
|
|
|
|
def test_main(verbose=None):
|
|
NamedTupleDocs = doctest.DocTestSuite(module=collections)
|
|
test_classes = [TestNamedTuple, NamedTupleDocs, TestOneTrickPonyABCs,
|
|
TestCollectionABCs, TestCounter, TestChainMap,
|
|
TestUserObjects,
|
|
]
|
|
support.run_unittest(*test_classes)
|
|
support.run_doctest(collections, verbose)
|
|
|
|
|
|
if __name__ == "__main__":
|
|
test_main(verbose=True)
|