Guido van Rossum | cd16bf6 | 2007-06-13 18:07:49 +0000 | [diff] [blame] | 1 | # Copyright 2007 Google, Inc. All Rights Reserved. |
| 2 | # Licensed to PSF under a Contributor Agreement. |
| 3 | |
| 4 | """Unit tests for abc.py.""" |
| 5 | |
Guido van Rossum | cd16bf6 | 2007-06-13 18:07:49 +0000 | [diff] [blame] | 6 | import unittest |
Benjamin Peterson | ee8712c | 2008-05-20 21:35:26 +0000 | [diff] [blame] | 7 | from test import support |
Guido van Rossum | cd16bf6 | 2007-06-13 18:07:49 +0000 | [diff] [blame] | 8 | |
| 9 | import abc |
Christian Heimes | be5b30b | 2008-03-03 19:18:51 +0000 | [diff] [blame] | 10 | from inspect import isabstract |
Guido van Rossum | cd16bf6 | 2007-06-13 18:07:49 +0000 | [diff] [blame] | 11 | |
| 12 | |
| 13 | class TestABC(unittest.TestCase): |
| 14 | |
| 15 | def test_abstractmethod_basics(self): |
| 16 | @abc.abstractmethod |
| 17 | def foo(self): pass |
| 18 | self.assertEqual(foo.__isabstractmethod__, True) |
| 19 | def bar(self): pass |
| 20 | self.assertEqual(hasattr(bar, "__isabstractmethod__"), False) |
| 21 | |
Guido van Rossum | 70d2b89 | 2007-08-01 17:52:23 +0000 | [diff] [blame] | 22 | def test_abstractproperty_basics(self): |
| 23 | @abc.abstractproperty |
| 24 | def foo(self): pass |
| 25 | self.assertEqual(foo.__isabstractmethod__, True) |
| 26 | def bar(self): pass |
| 27 | self.assertEqual(hasattr(bar, "__isabstractmethod__"), False) |
| 28 | |
Guido van Rossum | cd16bf6 | 2007-06-13 18:07:49 +0000 | [diff] [blame] | 29 | class C(metaclass=abc.ABCMeta): |
Guido van Rossum | 70d2b89 | 2007-08-01 17:52:23 +0000 | [diff] [blame] | 30 | @abc.abstractproperty |
| 31 | def foo(self): return 3 |
Guido van Rossum | cd16bf6 | 2007-06-13 18:07:49 +0000 | [diff] [blame] | 32 | class D(C): |
Guido van Rossum | 70d2b89 | 2007-08-01 17:52:23 +0000 | [diff] [blame] | 33 | @property |
| 34 | def foo(self): return super().foo |
| 35 | self.assertEqual(D().foo, 3) |
| 36 | |
Benjamin Peterson | 45c257f | 2010-08-17 00:52:52 +0000 | [diff] [blame^] | 37 | def test_abstractclassmethod_basics(self): |
| 38 | @abc.abstractclassmethod |
| 39 | def foo(cls): pass |
| 40 | self.assertEqual(foo.__isabstractmethod__, True) |
| 41 | @classmethod |
| 42 | def bar(cls): pass |
| 43 | self.assertEqual(hasattr(bar, "__isabstractmethod__"), False) |
| 44 | |
| 45 | class C(metaclass=abc.ABCMeta): |
| 46 | @abc.abstractclassmethod |
| 47 | def foo(cls): return cls.__name__ |
| 48 | self.assertRaises(TypeError, C) |
| 49 | class D(C): |
| 50 | @classmethod |
| 51 | def foo(cls): return super().foo() |
| 52 | self.assertEqual(D.foo(), 'D') |
| 53 | self.assertEqual(D().foo(), 'D') |
| 54 | |
| 55 | def test_abstractstaticmethod_basics(self): |
| 56 | @abc.abstractstaticmethod |
| 57 | def foo(): pass |
| 58 | self.assertEqual(foo.__isabstractmethod__, True) |
| 59 | @staticmethod |
| 60 | def bar(): pass |
| 61 | self.assertEqual(hasattr(bar, "__isabstractmethod__"), False) |
| 62 | |
| 63 | class C(metaclass=abc.ABCMeta): |
| 64 | @abc.abstractstaticmethod |
| 65 | def foo(): return 3 |
| 66 | self.assertRaises(TypeError, C) |
| 67 | class D(C): |
| 68 | @staticmethod |
| 69 | def foo(): return 4 |
| 70 | self.assertEqual(D.foo(), 4) |
| 71 | self.assertEqual(D().foo(), 4) |
| 72 | |
Guido van Rossum | 70d2b89 | 2007-08-01 17:52:23 +0000 | [diff] [blame] | 73 | def test_abstractmethod_integration(self): |
Benjamin Peterson | 45c257f | 2010-08-17 00:52:52 +0000 | [diff] [blame^] | 74 | for abstractthing in [abc.abstractmethod, abc.abstractproperty, |
| 75 | abc.abstractclassmethod, |
| 76 | abc.abstractstaticmethod]: |
Guido van Rossum | 70d2b89 | 2007-08-01 17:52:23 +0000 | [diff] [blame] | 77 | class C(metaclass=abc.ABCMeta): |
| 78 | @abstractthing |
| 79 | def foo(self): pass # abstract |
| 80 | def bar(self): pass # concrete |
| 81 | self.assertEqual(C.__abstractmethods__, {"foo"}) |
| 82 | self.assertRaises(TypeError, C) # because foo is abstract |
Benjamin Peterson | c9c0f20 | 2009-06-30 23:06:06 +0000 | [diff] [blame] | 83 | self.assertTrue(isabstract(C)) |
Guido van Rossum | 70d2b89 | 2007-08-01 17:52:23 +0000 | [diff] [blame] | 84 | class D(C): |
| 85 | def bar(self): pass # concrete override of concrete |
| 86 | self.assertEqual(D.__abstractmethods__, {"foo"}) |
| 87 | self.assertRaises(TypeError, D) # because foo is still abstract |
Benjamin Peterson | c9c0f20 | 2009-06-30 23:06:06 +0000 | [diff] [blame] | 88 | self.assertTrue(isabstract(D)) |
Guido van Rossum | 70d2b89 | 2007-08-01 17:52:23 +0000 | [diff] [blame] | 89 | class E(D): |
| 90 | def foo(self): pass |
| 91 | self.assertEqual(E.__abstractmethods__, set()) |
| 92 | E() # now foo is concrete, too |
Benjamin Peterson | c9c0f20 | 2009-06-30 23:06:06 +0000 | [diff] [blame] | 93 | self.assertFalse(isabstract(E)) |
Guido van Rossum | 70d2b89 | 2007-08-01 17:52:23 +0000 | [diff] [blame] | 94 | class F(E): |
| 95 | @abstractthing |
| 96 | def bar(self): pass # abstract override of concrete |
| 97 | self.assertEqual(F.__abstractmethods__, {"bar"}) |
| 98 | self.assertRaises(TypeError, F) # because bar is abstract now |
Benjamin Peterson | c9c0f20 | 2009-06-30 23:06:06 +0000 | [diff] [blame] | 99 | self.assertTrue(isabstract(F)) |
Guido van Rossum | cd16bf6 | 2007-06-13 18:07:49 +0000 | [diff] [blame] | 100 | |
Christian Heimes | 043d6f6 | 2008-01-07 17:19:16 +0000 | [diff] [blame] | 101 | def test_subclass_oldstyle_class(self): |
| 102 | class A: |
| 103 | __metaclass__ = abc.ABCMeta |
| 104 | class OldstyleClass: |
| 105 | pass |
| 106 | self.assertFalse(issubclass(OldstyleClass, A)) |
| 107 | self.assertFalse(issubclass(A, OldstyleClass)) |
| 108 | |
Guido van Rossum | cd16bf6 | 2007-06-13 18:07:49 +0000 | [diff] [blame] | 109 | def test_registration_basics(self): |
| 110 | class A(metaclass=abc.ABCMeta): |
| 111 | pass |
Christian Heimes | 043d6f6 | 2008-01-07 17:19:16 +0000 | [diff] [blame] | 112 | class B(object): |
Guido van Rossum | cd16bf6 | 2007-06-13 18:07:49 +0000 | [diff] [blame] | 113 | pass |
| 114 | b = B() |
| 115 | self.assertEqual(issubclass(B, A), False) |
Antoine Pitrou | ec569b7 | 2008-08-26 22:40:48 +0000 | [diff] [blame] | 116 | self.assertEqual(issubclass(B, (A,)), False) |
Ezio Melotti | e961593 | 2010-01-24 19:26:24 +0000 | [diff] [blame] | 117 | self.assertNotIsInstance(b, A) |
| 118 | self.assertNotIsInstance(b, (A,)) |
Guido van Rossum | cd16bf6 | 2007-06-13 18:07:49 +0000 | [diff] [blame] | 119 | A.register(B) |
| 120 | self.assertEqual(issubclass(B, A), True) |
Antoine Pitrou | ec569b7 | 2008-08-26 22:40:48 +0000 | [diff] [blame] | 121 | self.assertEqual(issubclass(B, (A,)), True) |
Ezio Melotti | e961593 | 2010-01-24 19:26:24 +0000 | [diff] [blame] | 122 | self.assertIsInstance(b, A) |
| 123 | self.assertIsInstance(b, (A,)) |
Guido van Rossum | cd16bf6 | 2007-06-13 18:07:49 +0000 | [diff] [blame] | 124 | class C(B): |
| 125 | pass |
| 126 | c = C() |
| 127 | self.assertEqual(issubclass(C, A), True) |
Antoine Pitrou | ec569b7 | 2008-08-26 22:40:48 +0000 | [diff] [blame] | 128 | self.assertEqual(issubclass(C, (A,)), True) |
Ezio Melotti | e961593 | 2010-01-24 19:26:24 +0000 | [diff] [blame] | 129 | self.assertIsInstance(c, A) |
| 130 | self.assertIsInstance(c, (A,)) |
Guido van Rossum | cd16bf6 | 2007-06-13 18:07:49 +0000 | [diff] [blame] | 131 | |
Christian Heimes | 68f5fbe | 2008-02-14 08:27:37 +0000 | [diff] [blame] | 132 | def test_isinstance_invalidation(self): |
| 133 | class A(metaclass=abc.ABCMeta): |
| 134 | pass |
| 135 | class B: |
| 136 | pass |
| 137 | b = B() |
| 138 | self.assertEqual(isinstance(b, A), False) |
Antoine Pitrou | ec569b7 | 2008-08-26 22:40:48 +0000 | [diff] [blame] | 139 | self.assertEqual(isinstance(b, (A,)), False) |
Christian Heimes | 68f5fbe | 2008-02-14 08:27:37 +0000 | [diff] [blame] | 140 | A.register(B) |
| 141 | self.assertEqual(isinstance(b, A), True) |
Antoine Pitrou | ec569b7 | 2008-08-26 22:40:48 +0000 | [diff] [blame] | 142 | self.assertEqual(isinstance(b, (A,)), True) |
Christian Heimes | 68f5fbe | 2008-02-14 08:27:37 +0000 | [diff] [blame] | 143 | |
Guido van Rossum | cd16bf6 | 2007-06-13 18:07:49 +0000 | [diff] [blame] | 144 | def test_registration_builtins(self): |
| 145 | class A(metaclass=abc.ABCMeta): |
| 146 | pass |
| 147 | A.register(int) |
Ezio Melotti | e961593 | 2010-01-24 19:26:24 +0000 | [diff] [blame] | 148 | self.assertIsInstance(42, A) |
| 149 | self.assertIsInstance(42, (A,)) |
Guido van Rossum | cd16bf6 | 2007-06-13 18:07:49 +0000 | [diff] [blame] | 150 | self.assertEqual(issubclass(int, A), True) |
Antoine Pitrou | ec569b7 | 2008-08-26 22:40:48 +0000 | [diff] [blame] | 151 | self.assertEqual(issubclass(int, (A,)), True) |
Guido van Rossum | cd16bf6 | 2007-06-13 18:07:49 +0000 | [diff] [blame] | 152 | class B(A): |
| 153 | pass |
Guido van Rossum | 3172c5d | 2007-10-16 18:12:55 +0000 | [diff] [blame] | 154 | B.register(str) |
| 155 | class C(str): pass |
Ezio Melotti | e961593 | 2010-01-24 19:26:24 +0000 | [diff] [blame] | 156 | self.assertIsInstance("", A) |
| 157 | self.assertIsInstance("", (A,)) |
Guido van Rossum | cd16bf6 | 2007-06-13 18:07:49 +0000 | [diff] [blame] | 158 | self.assertEqual(issubclass(str, A), True) |
Antoine Pitrou | ec569b7 | 2008-08-26 22:40:48 +0000 | [diff] [blame] | 159 | self.assertEqual(issubclass(str, (A,)), True) |
Guido van Rossum | 3172c5d | 2007-10-16 18:12:55 +0000 | [diff] [blame] | 160 | self.assertEqual(issubclass(C, A), True) |
Antoine Pitrou | ec569b7 | 2008-08-26 22:40:48 +0000 | [diff] [blame] | 161 | self.assertEqual(issubclass(C, (A,)), True) |
Guido van Rossum | cd16bf6 | 2007-06-13 18:07:49 +0000 | [diff] [blame] | 162 | |
| 163 | def test_registration_edge_cases(self): |
| 164 | class A(metaclass=abc.ABCMeta): |
| 165 | pass |
| 166 | A.register(A) # should pass silently |
| 167 | class A1(A): |
| 168 | pass |
| 169 | self.assertRaises(RuntimeError, A1.register, A) # cycles not allowed |
Christian Heimes | 043d6f6 | 2008-01-07 17:19:16 +0000 | [diff] [blame] | 170 | class B(object): |
Guido van Rossum | cd16bf6 | 2007-06-13 18:07:49 +0000 | [diff] [blame] | 171 | pass |
| 172 | A1.register(B) # ok |
| 173 | A1.register(B) # should pass silently |
| 174 | class C(A): |
| 175 | pass |
| 176 | A.register(C) # should pass silently |
| 177 | self.assertRaises(RuntimeError, C.register, A) # cycles not allowed |
| 178 | C.register(B) # ok |
| 179 | |
Benjamin Peterson | d632664 | 2010-01-27 02:25:58 +0000 | [diff] [blame] | 180 | def test_register_non_class(self): |
| 181 | class A(metaclass=abc.ABCMeta): |
| 182 | pass |
| 183 | self.assertRaisesRegexp(TypeError, "Can only register classes", |
| 184 | A.register, 4) |
| 185 | |
Guido van Rossum | cd16bf6 | 2007-06-13 18:07:49 +0000 | [diff] [blame] | 186 | def test_registration_transitiveness(self): |
| 187 | class A(metaclass=abc.ABCMeta): |
| 188 | pass |
Benjamin Peterson | c9c0f20 | 2009-06-30 23:06:06 +0000 | [diff] [blame] | 189 | self.assertTrue(issubclass(A, A)) |
| 190 | self.assertTrue(issubclass(A, (A,))) |
Guido van Rossum | cd16bf6 | 2007-06-13 18:07:49 +0000 | [diff] [blame] | 191 | class B(metaclass=abc.ABCMeta): |
| 192 | pass |
Benjamin Peterson | c9c0f20 | 2009-06-30 23:06:06 +0000 | [diff] [blame] | 193 | self.assertFalse(issubclass(A, B)) |
| 194 | self.assertFalse(issubclass(A, (B,))) |
| 195 | self.assertFalse(issubclass(B, A)) |
| 196 | self.assertFalse(issubclass(B, (A,))) |
Guido van Rossum | cd16bf6 | 2007-06-13 18:07:49 +0000 | [diff] [blame] | 197 | class C(metaclass=abc.ABCMeta): |
| 198 | pass |
| 199 | A.register(B) |
| 200 | class B1(B): |
| 201 | pass |
Benjamin Peterson | c9c0f20 | 2009-06-30 23:06:06 +0000 | [diff] [blame] | 202 | self.assertTrue(issubclass(B1, A)) |
| 203 | self.assertTrue(issubclass(B1, (A,))) |
Guido van Rossum | cd16bf6 | 2007-06-13 18:07:49 +0000 | [diff] [blame] | 204 | class C1(C): |
| 205 | pass |
| 206 | B1.register(C1) |
Benjamin Peterson | c9c0f20 | 2009-06-30 23:06:06 +0000 | [diff] [blame] | 207 | self.assertFalse(issubclass(C, B)) |
| 208 | self.assertFalse(issubclass(C, (B,))) |
| 209 | self.assertFalse(issubclass(C, B1)) |
| 210 | self.assertFalse(issubclass(C, (B1,))) |
| 211 | self.assertTrue(issubclass(C1, A)) |
| 212 | self.assertTrue(issubclass(C1, (A,))) |
| 213 | self.assertTrue(issubclass(C1, B)) |
| 214 | self.assertTrue(issubclass(C1, (B,))) |
| 215 | self.assertTrue(issubclass(C1, B1)) |
| 216 | self.assertTrue(issubclass(C1, (B1,))) |
Guido van Rossum | cd16bf6 | 2007-06-13 18:07:49 +0000 | [diff] [blame] | 217 | C1.register(int) |
| 218 | class MyInt(int): |
| 219 | pass |
Benjamin Peterson | c9c0f20 | 2009-06-30 23:06:06 +0000 | [diff] [blame] | 220 | self.assertTrue(issubclass(MyInt, A)) |
| 221 | self.assertTrue(issubclass(MyInt, (A,))) |
Ezio Melotti | e961593 | 2010-01-24 19:26:24 +0000 | [diff] [blame] | 222 | self.assertIsInstance(42, A) |
| 223 | self.assertIsInstance(42, (A,)) |
Guido van Rossum | cd16bf6 | 2007-06-13 18:07:49 +0000 | [diff] [blame] | 224 | |
Guido van Rossum | 894d35e | 2007-09-11 20:42:30 +0000 | [diff] [blame] | 225 | def test_all_new_methods_are_called(self): |
| 226 | class A(metaclass=abc.ABCMeta): |
| 227 | pass |
Christian Heimes | 043d6f6 | 2008-01-07 17:19:16 +0000 | [diff] [blame] | 228 | class B(object): |
Guido van Rossum | 894d35e | 2007-09-11 20:42:30 +0000 | [diff] [blame] | 229 | counter = 0 |
| 230 | def __new__(cls): |
| 231 | B.counter += 1 |
| 232 | return super().__new__(cls) |
| 233 | class C(A, B): |
| 234 | pass |
| 235 | self.assertEqual(B.counter, 0) |
| 236 | C() |
| 237 | self.assertEqual(B.counter, 1) |
| 238 | |
Guido van Rossum | cd16bf6 | 2007-06-13 18:07:49 +0000 | [diff] [blame] | 239 | |
| 240 | def test_main(): |
Benjamin Peterson | ee8712c | 2008-05-20 21:35:26 +0000 | [diff] [blame] | 241 | support.run_unittest(TestABC) |
Guido van Rossum | cd16bf6 | 2007-06-13 18:07:49 +0000 | [diff] [blame] | 242 | |
| 243 | |
| 244 | if __name__ == "__main__": |
| 245 | unittest.main() |