# -*- coding: utf-8 -*- # Copyright (c) 2010 Mark Sandstrom # Copyright (c) 2011-2013 Raphaƫl Barrois # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. import datetime import itertools import warnings from factory import declarations from .compat import mock, unittest from . import tools class OrderedDeclarationTestCase(unittest.TestCase): def test_errors(self): decl = declarations.OrderedDeclaration() self.assertRaises(NotImplementedError, decl.evaluate, None, {}) class DigTestCase(unittest.TestCase): class MyObj(object): def __init__(self, n): self.n = n def test_chaining(self): obj = self.MyObj(1) obj.a = self.MyObj(2) obj.a.b = self.MyObj(3) obj.a.b.c = self.MyObj(4) self.assertEqual(2, declarations.deepgetattr(obj, 'a').n) self.assertRaises(AttributeError, declarations.deepgetattr, obj, 'b') self.assertEqual(2, declarations.deepgetattr(obj, 'a.n')) self.assertEqual(3, declarations.deepgetattr(obj, 'a.c', 3)) self.assertRaises(AttributeError, declarations.deepgetattr, obj, 'a.c.n') self.assertRaises(AttributeError, declarations.deepgetattr, obj, 'a.d') self.assertEqual(3, declarations.deepgetattr(obj, 'a.b').n) self.assertEqual(3, declarations.deepgetattr(obj, 'a.b.n')) self.assertEqual(4, declarations.deepgetattr(obj, 'a.b.c').n) self.assertEqual(4, declarations.deepgetattr(obj, 'a.b.c.n')) self.assertEqual(42, declarations.deepgetattr(obj, 'a.b.c.n.x', 42)) class SelfAttributeTestCase(unittest.TestCase): def test_standard(self): a = declarations.SelfAttribute('foo.bar.baz') self.assertEqual(0, a.depth) self.assertEqual('foo.bar.baz', a.attribute_name) self.assertEqual(declarations._UNSPECIFIED, a.default) def test_dot(self): a = declarations.SelfAttribute('.bar.baz') self.assertEqual(1, a.depth) self.assertEqual('bar.baz', a.attribute_name) self.assertEqual(declarations._UNSPECIFIED, a.default) def test_default(self): a = declarations.SelfAttribute('bar.baz', 42) self.assertEqual(0, a.depth) self.assertEqual('bar.baz', a.attribute_name) self.assertEqual(42, a.default) def test_parent(self): a = declarations.SelfAttribute('..bar.baz') self.assertEqual(2, a.depth) self.assertEqual('bar.baz', a.attribute_name) self.assertEqual(declarations._UNSPECIFIED, a.default) def test_grandparent(self): a = declarations.SelfAttribute('...bar.baz') self.assertEqual(3, a.depth) self.assertEqual('bar.baz', a.attribute_name) self.assertEqual(declarations._UNSPECIFIED, a.default) class IteratorTestCase(unittest.TestCase): def test_cycle(self): it = declarations.Iterator([1, 2]) self.assertEqual(1, it.evaluate(0, None)) self.assertEqual(2, it.evaluate(1, None)) self.assertEqual(1, it.evaluate(2, None)) self.assertEqual(2, it.evaluate(3, None)) def test_no_cycling(self): it = declarations.Iterator([1, 2], cycle=False) self.assertEqual(1, it.evaluate(0, None)) self.assertEqual(2, it.evaluate(1, None)) self.assertRaises(StopIteration, it.evaluate, 2, None) def test_getter(self): it = declarations.Iterator([(1, 2), (1, 3)], getter=lambda p: p[1]) self.assertEqual(2, it.evaluate(0, None)) self.assertEqual(3, it.evaluate(1, None)) self.assertEqual(2, it.evaluate(2, None)) self.assertEqual(3, it.evaluate(3, None)) class PostGenerationDeclarationTestCase(unittest.TestCase): def test_extract_no_prefix(self): decl = declarations.PostGenerationDeclaration() extracted, kwargs = decl.extract('foo', {'foo': 13, 'foo__bar': 42}) self.assertEqual(extracted, 13) self.assertEqual(kwargs, {'bar': 42}) @tools.disable_warnings def test_extract_with_prefix(self): decl = declarations.PostGenerationDeclaration(extract_prefix='blah') extracted, kwargs = decl.extract('foo', {'foo': 13, 'foo__bar': 42, 'blah': 42, 'blah__baz': 1}) self.assertEqual(extracted, 42) self.assertEqual(kwargs, {'baz': 1}) def test_extract_prefix_deprecated(self): with warnings.catch_warnings(record=True) as w: __warningregistry__.clear() warnings.simplefilter('always') declarations.PostGenerationDeclaration(extract_prefix='blah') self.assertEqual(1, len(w)) self.assertIn('extract_prefix', str(w[0].message)) self.assertIn('deprecated', str(w[0].message)) def test_decorator_simple(self): call_params = [] @declarations.post_generation def foo(*args, **kwargs): call_params.append(args) call_params.append(kwargs) extracted, kwargs = foo.extract('foo', {'foo': 13, 'foo__bar': 42, 'blah': 42, 'blah__baz': 1}) self.assertEqual(13, extracted) self.assertEqual({'bar': 42}, kwargs) # No value returned. foo.call(None, False, extracted, **kwargs) self.assertEqual(2, len(call_params)) self.assertEqual((None, False, 13), call_params[0]) self.assertEqual({'bar': 42}, call_params[1]) @tools.disable_warnings def test_decorator_call_no_prefix(self): call_params = [] @declarations.post_generation() def foo(*args, **kwargs): call_params.append(args) call_params.append(kwargs) extracted, kwargs = foo.extract('foo', {'foo': 13, 'foo__bar': 42, 'blah': 42, 'blah__baz': 1}) self.assertEqual(13, extracted) self.assertEqual({'bar': 42}, kwargs) # No value returned. foo.call(None, False, extracted, **kwargs) self.assertEqual(2, len(call_params)) self.assertEqual((None, False, 13), call_params[0]) self.assertEqual({'bar': 42}, call_params[1]) @tools.disable_warnings def test_decorator_extract_prefix(self): call_params = [] @declarations.post_generation(extract_prefix='blah') def foo(*args, **kwargs): call_params.append(args) call_params.append(kwargs) extracted, kwargs = foo.extract('foo', {'foo': 13, 'foo__bar': 42, 'blah': 42, 'blah__baz': 1}) self.assertEqual(42, extracted) self.assertEqual({'baz': 1}, kwargs) # No value returned. foo.call(None, False, extracted, **kwargs) self.assertEqual(2, len(call_params)) self.assertEqual((None, False, 42), call_params[0]) self.assertEqual({'baz': 1}, call_params[1]) def test_decorator_call_no_prefix_deprecated(self): with warnings.catch_warnings(record=True) as w: __warningregistry__.clear() warnings.simplefilter('always') @declarations.post_generation() def foo(*args, **kwargs): pass self.assertEqual(1, len(w)) self.assertIn('post_generation', str(w[0].message)) self.assertIn('deprecated', str(w[0].message)) def test_decorator_call_with_prefix_deprecated(self): with warnings.catch_warnings(record=True) as w: __warningregistry__.clear() warnings.simplefilter('always') @declarations.post_generation(extract_prefix='blah') def foo(*args, **kwargs): pass # 2 warnings: decorator with brackets, and extract_prefix. self.assertEqual(2, len(w)) self.assertIn('post_generation', str(w[0].message)) self.assertIn('deprecated', str(w[0].message)) class SubFactoryTestCase(unittest.TestCase): def test_arg(self): self.assertRaises(ValueError, declarations.SubFactory, 'UnqualifiedSymbol') def test_lazyness(self): f = declarations.SubFactory('factory.declarations.Sequence', x=3) self.assertEqual(None, f.factory) self.assertEqual({'x': 3}, f.defaults) factory_class = f.get_factory() self.assertEqual(declarations.Sequence, factory_class) def test_cache(self): orig_date = datetime.date f = declarations.SubFactory('datetime.date') self.assertEqual(None, f.factory) factory_class = f.get_factory() self.assertEqual(orig_date, factory_class) try: # Modify original value datetime.date = None # Repeat import factory_class = f.get_factory() self.assertEqual(orig_date, factory_class) finally: # IMPORTANT: restore attribute. datetime.date = orig_date class RelatedFactoryTestCase(unittest.TestCase): def test_arg(self): self.assertRaises(ValueError, declarations.RelatedFactory, 'UnqualifiedSymbol') def test_lazyness(self): f = declarations.RelatedFactory('factory.declarations.Sequence', x=3) self.assertEqual(None, f.factory) self.assertEqual({'x': 3}, f.defaults) factory_class = f.get_factory() self.assertEqual(declarations.Sequence, factory_class) def test_cache(self): """Ensure that RelatedFactory tries to import only once.""" orig_date = datetime.date f = declarations.RelatedFactory('datetime.date') self.assertEqual(None, f.factory) factory_class = f.get_factory() self.assertEqual(orig_date, factory_class) try: # Modify original value datetime.date = None # Repeat import factory_class = f.get_factory() self.assertEqual(orig_date, factory_class) finally: # IMPORTANT: restore attribute. datetime.date = orig_date class PostGenerationMethodCallTestCase(unittest.TestCase): def setUp(self): self.obj = mock.MagicMock() def test_simplest_setup_and_call(self): decl = declarations.PostGenerationMethodCall('method') decl.call(self.obj, False) self.obj.method.assert_called_once_with() def test_call_with_method_args(self): decl = declarations.PostGenerationMethodCall( 'method', None, 'data') decl.call(self.obj, False) self.obj.method.assert_called_once_with('data') def test_call_with_passed_extracted_string(self): decl = declarations.PostGenerationMethodCall( 'method', None) decl.call(self.obj, False, 'data') self.obj.method.assert_called_once_with('data') def test_call_with_passed_extracted_int(self): decl = declarations.PostGenerationMethodCall('method') decl.call(self.obj, False, 1) self.obj.method.assert_called_once_with(1) def test_call_with_passed_extracted_iterable(self): decl = declarations.PostGenerationMethodCall('method') decl.call(self.obj, False, (1, 2, 3)) self.obj.method.assert_called_once_with(1, 2, 3) def test_call_with_method_kwargs(self): decl = declarations.PostGenerationMethodCall( 'method', None, data='data') decl.call(self.obj, False) self.obj.method.assert_called_once_with(data='data') def test_call_with_passed_kwargs(self): decl = declarations.PostGenerationMethodCall('method') decl.call(self.obj, False, data='other') self.obj.method.assert_called_once_with(data='other') class CircularSubFactoryTestCase(unittest.TestCase): def test_circularsubfactory_deprecated(self): with warnings.catch_warnings(record=True) as w: __warningregistry__.clear() warnings.simplefilter('always') declarations.CircularSubFactory('datetime', 'date') self.assertEqual(1, len(w)) self.assertIn('CircularSubFactory', str(w[0].message)) self.assertIn('deprecated', str(w[0].message)) @tools.disable_warnings def test_lazyness(self): f = declarations.CircularSubFactory('factory.declarations', 'Sequence', x=3) self.assertEqual(None, f.factory) self.assertEqual({'x': 3}, f.defaults) factory_class = f.get_factory() self.assertEqual(declarations.Sequence, factory_class) @tools.disable_warnings def test_cache(self): orig_date = datetime.date f = declarations.CircularSubFactory('datetime', 'date') self.assertEqual(None, f.factory) factory_class = f.get_factory() self.assertEqual(orig_date, factory_class) try: # Modify original value datetime.date = None # Repeat import factory_class = f.get_factory() self.assertEqual(orig_date, factory_class) finally: # IMPORTANT: restore attribute. datetime.date = orig_date if __name__ == '__main__': unittest.main()