diff options
Diffstat (limited to 'lib/python2.7/test/test_funcattrs.py')
-rw-r--r-- | lib/python2.7/test/test_funcattrs.py | 353 |
1 files changed, 353 insertions, 0 deletions
diff --git a/lib/python2.7/test/test_funcattrs.py b/lib/python2.7/test/test_funcattrs.py new file mode 100644 index 0000000..b639ca2 --- /dev/null +++ b/lib/python2.7/test/test_funcattrs.py @@ -0,0 +1,353 @@ +from test import test_support +import types +import unittest + +class FuncAttrsTest(unittest.TestCase): + def setUp(self): + class F: + def a(self): + pass + def b(): + return 3 + self.f = F + self.fi = F() + self.b = b + + def cannot_set_attr(self, obj, name, value, exceptions): + # Helper method for other tests. + try: + setattr(obj, name, value) + except exceptions: + pass + else: + self.fail("shouldn't be able to set %s to %r" % (name, value)) + try: + delattr(obj, name) + except exceptions: + pass + else: + self.fail("shouldn't be able to del %s" % name) + + +class FunctionPropertiesTest(FuncAttrsTest): + # Include the external setUp method that is common to all tests + def test_module(self): + self.assertEqual(self.b.__module__, __name__) + + def test_dir_includes_correct_attrs(self): + self.b.known_attr = 7 + self.assertIn('known_attr', dir(self.b), + "set attributes not in dir listing of method") + # Test on underlying function object of method + self.f.a.im_func.known_attr = 7 + self.assertIn('known_attr', dir(self.f.a), + "set attribute on unbound method implementation in " + "class not in dir") + self.assertIn('known_attr', dir(self.fi.a), + "set attribute on unbound method implementations, " + "should show up in next dir") + + def test_duplicate_function_equality(self): + # Body of `duplicate' is the exact same as self.b + def duplicate(): + 'my docstring' + return 3 + self.assertNotEqual(self.b, duplicate) + + def test_copying_func_code(self): + def test(): pass + self.assertEqual(test(), None) + test.func_code = self.b.func_code + self.assertEqual(test(), 3) # self.b always returns 3, arbitrarily + + def test_func_globals(self): + self.assertIs(self.b.func_globals, globals()) + self.cannot_set_attr(self.b, 'func_globals', 2, TypeError) + + def test_func_closure(self): + a = 12 + def f(): print a + c = f.func_closure + self.assertIsInstance(c, tuple) + self.assertEqual(len(c), 1) + # don't have a type object handy + self.assertEqual(c[0].__class__.__name__, "cell") + self.cannot_set_attr(f, "func_closure", c, TypeError) + + def test_empty_cell(self): + def f(): print a + try: + f.func_closure[0].cell_contents + except ValueError: + pass + else: + self.fail("shouldn't be able to read an empty cell") + a = 12 + + def test_func_name(self): + self.assertEqual(self.b.__name__, 'b') + self.assertEqual(self.b.func_name, 'b') + self.b.__name__ = 'c' + self.assertEqual(self.b.__name__, 'c') + self.assertEqual(self.b.func_name, 'c') + self.b.func_name = 'd' + self.assertEqual(self.b.__name__, 'd') + self.assertEqual(self.b.func_name, 'd') + # __name__ and func_name must be a string + self.cannot_set_attr(self.b, '__name__', 7, TypeError) + self.cannot_set_attr(self.b, 'func_name', 7, TypeError) + # __name__ must be available when in restricted mode. Exec will raise + # AttributeError if __name__ is not available on f. + s = """def f(): pass\nf.__name__""" + exec s in {'__builtins__': {}} + # Test on methods, too + self.assertEqual(self.f.a.__name__, 'a') + self.assertEqual(self.fi.a.__name__, 'a') + self.cannot_set_attr(self.f.a, "__name__", 'a', AttributeError) + self.cannot_set_attr(self.fi.a, "__name__", 'a', AttributeError) + + def test_func_code(self): + num_one, num_two = 7, 8 + def a(): pass + def b(): return 12 + def c(): return num_one + def d(): return num_two + def e(): return num_one, num_two + for func in [a, b, c, d, e]: + self.assertEqual(type(func.func_code), types.CodeType) + self.assertEqual(c(), 7) + self.assertEqual(d(), 8) + d.func_code = c.func_code + self.assertEqual(c.func_code, d.func_code) + self.assertEqual(c(), 7) + # self.assertEqual(d(), 7) + try: + b.func_code = c.func_code + except ValueError: + pass + else: + self.fail("func_code with different numbers of free vars should " + "not be possible") + try: + e.func_code = d.func_code + except ValueError: + pass + else: + self.fail("func_code with different numbers of free vars should " + "not be possible") + + def test_blank_func_defaults(self): + self.assertEqual(self.b.func_defaults, None) + del self.b.func_defaults + self.assertEqual(self.b.func_defaults, None) + + def test_func_default_args(self): + def first_func(a, b): + return a+b + def second_func(a=1, b=2): + return a+b + self.assertEqual(first_func.func_defaults, None) + self.assertEqual(second_func.func_defaults, (1, 2)) + first_func.func_defaults = (1, 2) + self.assertEqual(first_func.func_defaults, (1, 2)) + self.assertEqual(first_func(), 3) + self.assertEqual(first_func(3), 5) + self.assertEqual(first_func(3, 5), 8) + del second_func.func_defaults + self.assertEqual(second_func.func_defaults, None) + try: + second_func() + except TypeError: + pass + else: + self.fail("func_defaults does not update; deleting it does not " + "remove requirement") + + +class InstancemethodAttrTest(FuncAttrsTest): + def test_im_class(self): + self.assertEqual(self.f.a.im_class, self.f) + self.assertEqual(self.fi.a.im_class, self.f) + self.cannot_set_attr(self.f.a, "im_class", self.f, TypeError) + self.cannot_set_attr(self.fi.a, "im_class", self.f, TypeError) + + def test_im_func(self): + self.f.b = self.b + self.assertEqual(self.f.b.im_func, self.b) + self.assertEqual(self.fi.b.im_func, self.b) + self.cannot_set_attr(self.f.b, "im_func", self.b, TypeError) + self.cannot_set_attr(self.fi.b, "im_func", self.b, TypeError) + + def test_im_self(self): + self.assertEqual(self.f.a.im_self, None) + self.assertEqual(self.fi.a.im_self, self.fi) + self.cannot_set_attr(self.f.a, "im_self", None, TypeError) + self.cannot_set_attr(self.fi.a, "im_self", self.fi, TypeError) + + def test_im_func_non_method(self): + # Behavior should be the same when a method is added via an attr + # assignment + self.f.id = types.MethodType(id, None, self.f) + self.assertEqual(self.fi.id(), id(self.fi)) + self.assertNotEqual(self.fi.id(), id(self.f)) + # Test usage + try: + self.f.id.unknown_attr + except AttributeError: + pass + else: + self.fail("using unknown attributes should raise AttributeError") + # Test assignment and deletion + self.cannot_set_attr(self.f.id, 'unknown_attr', 2, AttributeError) + self.cannot_set_attr(self.fi.id, 'unknown_attr', 2, AttributeError) + + def test_implicit_method_properties(self): + self.f.a.im_func.known_attr = 7 + self.assertEqual(self.f.a.known_attr, 7) + self.assertEqual(self.fi.a.known_attr, 7) + + +class ArbitraryFunctionAttrTest(FuncAttrsTest): + def test_set_attr(self): + # setting attributes only works on function objects + self.b.known_attr = 7 + self.assertEqual(self.b.known_attr, 7) + for func in [self.f.a, self.fi.a]: + try: + func.known_attr = 7 + except AttributeError: + pass + else: + self.fail("setting attributes on methods should raise error") + + def test_delete_unknown_attr(self): + try: + del self.b.unknown_attr + except AttributeError: + pass + else: + self.fail("deleting unknown attribute should raise TypeError") + + def test_setting_attrs_duplicates(self): + try: + self.f.a.klass = self.f + except AttributeError: + pass + else: + self.fail("setting arbitrary attribute in unbound function " + " should raise AttributeError") + self.f.a.im_func.klass = self.f + for method in [self.f.a, self.fi.a, self.fi.a.im_func]: + self.assertEqual(method.klass, self.f) + + def test_unset_attr(self): + for func in [self.b, self.f.a, self.fi.a]: + try: + func.non_existent_attr + except AttributeError: + pass + else: + self.fail("using unknown attributes should raise " + "AttributeError") + + +class FunctionDictsTest(FuncAttrsTest): + def test_setting_dict_to_invalid(self): + self.cannot_set_attr(self.b, '__dict__', None, TypeError) + self.cannot_set_attr(self.b, 'func_dict', None, TypeError) + from UserDict import UserDict + d = UserDict({'known_attr': 7}) + self.cannot_set_attr(self.f.a.im_func, '__dict__', d, TypeError) + self.cannot_set_attr(self.fi.a.im_func, '__dict__', d, TypeError) + + def test_setting_dict_to_valid(self): + d = {'known_attr': 7} + self.b.__dict__ = d + # Setting dict is only possible on the underlying function objects + self.f.a.im_func.__dict__ = d + # Test assignment + self.assertIs(d, self.b.__dict__) + self.assertIs(d, self.b.func_dict) + # ... and on all the different ways of referencing the method's func + self.assertIs(d, self.f.a.im_func.__dict__) + self.assertIs(d, self.f.a.__dict__) + self.assertIs(d, self.fi.a.im_func.__dict__) + self.assertIs(d, self.fi.a.__dict__) + # Test value + self.assertEqual(self.b.known_attr, 7) + self.assertEqual(self.b.__dict__['known_attr'], 7) + self.assertEqual(self.b.func_dict['known_attr'], 7) + # ... and again, on all the different method's names + self.assertEqual(self.f.a.im_func.known_attr, 7) + self.assertEqual(self.f.a.known_attr, 7) + self.assertEqual(self.fi.a.im_func.known_attr, 7) + self.assertEqual(self.fi.a.known_attr, 7) + + def test_delete_func_dict(self): + try: + del self.b.__dict__ + except TypeError: + pass + else: + self.fail("deleting function dictionary should raise TypeError") + try: + del self.b.func_dict + except TypeError: + pass + else: + self.fail("deleting function dictionary should raise TypeError") + + def test_unassigned_dict(self): + self.assertEqual(self.b.__dict__, {}) + + def test_func_as_dict_key(self): + value = "Some string" + d = {} + d[self.b] = value + self.assertEqual(d[self.b], value) + + +class FunctionDocstringTest(FuncAttrsTest): + def test_set_docstring_attr(self): + self.assertEqual(self.b.__doc__, None) + self.assertEqual(self.b.func_doc, None) + docstr = "A test method that does nothing" + self.b.__doc__ = self.f.a.im_func.__doc__ = docstr + self.assertEqual(self.b.__doc__, docstr) + self.assertEqual(self.b.func_doc, docstr) + self.assertEqual(self.f.a.__doc__, docstr) + self.assertEqual(self.fi.a.__doc__, docstr) + self.cannot_set_attr(self.f.a, "__doc__", docstr, AttributeError) + self.cannot_set_attr(self.fi.a, "__doc__", docstr, AttributeError) + + def test_delete_docstring(self): + self.b.__doc__ = "The docstring" + del self.b.__doc__ + self.assertEqual(self.b.__doc__, None) + self.assertEqual(self.b.func_doc, None) + self.b.func_doc = "The docstring" + del self.b.func_doc + self.assertEqual(self.b.__doc__, None) + self.assertEqual(self.b.func_doc, None) + + +class StaticMethodAttrsTest(unittest.TestCase): + def test_func_attribute(self): + def f(): + pass + + c = classmethod(f) + self.assertTrue(c.__func__ is f) + + s = staticmethod(f) + self.assertTrue(s.__func__ is f) + + +def test_main(): + test_support.run_unittest(FunctionPropertiesTest, InstancemethodAttrTest, + ArbitraryFunctionAttrTest, FunctionDictsTest, + FunctionDocstringTest, + StaticMethodAttrsTest) + +if __name__ == "__main__": + test_main() |