Make some refactoring after DynamicCatalog implementation

dependency_injector/__init__.py

@@ -1,10 +1,10 @@
 """Dependency injector."""
 
-from .catalog import DeclarativeCatalog
-from .catalog import AbstractCatalog
-from .catalog import DynamicCatalog
-from .catalog import CatalogBundle
-from .catalog import override
+from .catalogs import DeclarativeCatalog
+from .catalogs import AbstractCatalog
+from .catalogs import DynamicCatalog
+from .catalogs import CatalogBundle
+from .catalogs import override
 
 from .providers import Provider
 from .providers import Delegate
@@ -35,11 +35,16 @@ from .utils import is_kwarg_injection
 from .utils import is_attribute_injection
 from .utils import is_method_injection
 from .utils import is_catalog
+from .utils import is_dynamic_catalog
+from .utils import is_declarative_catalog
 from .utils import is_catalog_bundle
 from .utils import ensure_is_catalog_bundle
 
 from .errors import Error
 
+# Backward compatimility fix for versions < 0.11.*
+from . import catalogs
+catalog = catalogs
 
 VERSION = '0.10.5'
 
@@ -84,6 +89,8 @@ __all__ = (
     'is_attribute_injection',
     'is_method_injection',
     'is_catalog',
+    'is_dynamic_catalog',
+    'is_declarative_catalog',
     'is_catalog_bundle',
     'ensure_is_catalog_bundle',
 

dependency_injector/catalogs.py

@@ -1,4 +1,4 @@
-"""Catalog module."""
+"""Catalogs module."""
 
 import six
 
@@ -10,6 +10,60 @@ from .utils import ensure_is_provider
 from .utils import ensure_is_catalog_bundle
 
 
+@six.python_2_unicode_compatible
+class CatalogBundle(object):
+    """Bundle of catalog providers."""
+
+    catalog = None
+    """:type: DeclarativeCatalog"""
+
+    __IS_CATALOG_BUNDLE__ = True
+    __slots__ = ('providers', '__dict__')
+
+    def __init__(self, *providers):
+        """Initializer."""
+        self.providers = dict((self.catalog.get_provider_bind_name(provider),
+                               provider)
+                              for provider in providers)
+        self.__dict__.update(self.providers)
+        super(CatalogBundle, self).__init__()
+
+    @classmethod
+    def sub_cls_factory(cls, catalog):
+        """Create bundle class for catalog.
+
+        :rtype: CatalogBundle
+        :return: Subclass of CatalogBundle
+        """
+        return type('{0}Bundle'.format(catalog.name), (cls,),
+                    dict(catalog=catalog))
+
+    def get(self, name):
+        """Return provider with specified name or raise an error."""
+        try:
+            return self.providers[name]
+        except KeyError:
+            raise Error('Provider "{0}" is not a part of {1}'.format(name,
+                                                                     self))
+
+    def has(self, name):
+        """Check if there is provider with certain name."""
+        return name in self.providers
+
+    def __getattr__(self, item):
+        """Raise an error on every attempt to get undefined provider."""
+        if item.startswith('__') and item.endswith('__'):
+            return super(CatalogBundle, self).__getattr__(item)
+        raise Error('Provider "{0}" is not a part of {1}'.format(item, self))
+
+    def __repr__(self):
+        """Return string representation of catalog bundle."""
+        return '<{0}.Bundle({1})>'.format(
+            self.catalog.name, ', '.join(six.iterkeys(self.providers)))
+
+    __str__ = __repr__
+
+
 @six.python_2_unicode_compatible
 class DynamicCatalog(object):
     """Catalog of providers."""
@@ -117,56 +171,6 @@ class DynamicCatalog(object):
     __str__ = __repr__
 
 
-@six.python_2_unicode_compatible
-class CatalogBundle(object):
-    """Bundle of catalog providers."""
-
-    catalog = None
-    """:type: DeclarativeCatalog"""
-
-    __IS_CATALOG_BUNDLE__ = True
-    __slots__ = ('providers', '__dict__')
-
-    def __init__(self, *providers):
-        """Initializer."""
-        self.providers = dict((self.catalog.get_provider_bind_name(provider),
-                               provider)
-                              for provider in providers)
-        self.__dict__.update(self.providers)
-        super(CatalogBundle, self).__init__()
-
-    @classmethod
-    def sub_cls_factory(cls, catalog):
-        """Create bundle class for catalog."""
-        return type('{0}Bundle'.format(catalog.name), (cls,),
-                    dict(catalog=catalog))
-
-    def get(self, name):
-        """Return provider with specified name or raise an error."""
-        try:
-            return self.providers[name]
-        except KeyError:
-            raise Error('Provider "{0}" is not a part of {1}'.format(name,
-                                                                     self))
-
-    def has(self, name):
-        """Check if there is provider with certain name."""
-        return name in self.providers
-
-    def __getattr__(self, item):
-        """Raise an error on every attempt to get undefined provider."""
-        if item.startswith('__') and item.endswith('__'):
-            return super(CatalogBundle, self).__getattr__(item)
-        raise Error('Provider "{0}" is not a part of {1}'.format(item, self))
-
-    def __repr__(self):
-        """Return string representation of catalog bundle."""
-        return '<{0}.Bundle({1})>'.format(
-            self.catalog.name, ', '.join(six.iterkeys(self.providers)))
-
-    __str__ = __repr__
-
-
 @six.python_2_unicode_compatible
 class DeclarativeCatalogMetaClass(type):
     """Declarative catalog meta class."""

dependency_injector/utils.py

@@ -73,11 +73,20 @@ def is_method_injection(instance):
 
 def is_catalog(instance):
     """Check if instance is catalog instance."""
-    return (isinstance(instance, six.class_types) and
-            hasattr(instance, '__IS_CATALOG__') and
+    return (hasattr(instance, '__IS_CATALOG__') and
             getattr(instance, '__IS_CATALOG__', False) is True)
 
 
+def is_dynamic_catalog(instance):
+    """Check if instance is dynamic catalog instance."""
+    return (not isinstance(instance, six.class_types) and is_catalog(instance))
+
+
+def is_declarative_catalog(instance):
+    """Check if instance is declarative catalog instance."""
+    return (isinstance(instance, six.class_types) and is_catalog(instance))
+
+
 def is_catalog_bundle(instance):
     """Check if instance is catalog bundle instance."""
     return (not isinstance(instance, six.class_types) and

tests/test_catalogs.py

@@ -1,4 +1,4 @@
-"""Dependency injector catalog unittests."""
+"""Dependency injector catalogs unittests."""
 
 import unittest2 as unittest
 import dependency_injector as di

tests/test_utils.py

@@ -211,13 +211,13 @@ class IsMethodInjectionTests(unittest.TestCase):
 class IsCatalogTests(unittest.TestCase):
     """`is_catalog()` test cases."""
 
-    def test_with_cls(self):
+    def test_with_declarative_catalog(self):
         """Test with class."""
-        self.assertTrue(di.is_catalog(di.AbstractCatalog))
+        self.assertTrue(di.is_catalog(di.DeclarativeCatalog))
 
-    def test_with_instance(self):
+    def test_with_dynamic_catalog(self):
         """Test with class."""
-        self.assertFalse(di.is_catalog(di.AbstractCatalog()))
+        self.assertTrue(di.is_catalog(di.DynamicCatalog('TestCatalog')))
 
     def test_with_child_class(self):
         """Test with parent class."""
@@ -235,6 +235,32 @@ class IsCatalogTests(unittest.TestCase):
         self.assertFalse(di.is_catalog(object()))
 
 
+class IsDynamicCatalogTests(unittest.TestCase):
+    """`is_dynamic_catalog()` test cases."""
+
+    def test_with_declarative_catalog(self):
+        """Test with declarative catalog."""
+        self.assertFalse(di.is_dynamic_catalog(di.DeclarativeCatalog))
+
+    def test_with_dynamic_catalog(self):
+        """Test with dynamic catalog."""
+        self.assertTrue(di.is_dynamic_catalog(di.DynamicCatalog(
+            'TestCatalog')))
+
+
+class IsDeclarativeCatalogTests(unittest.TestCase):
+    """`is_declarative_catalog()` test cases."""
+
+    def test_with_declarative_catalog(self):
+        """Test with declarative catalog."""
+        self.assertTrue(di.is_declarative_catalog(di.DeclarativeCatalog))
+
+    def test_with_dynamic_catalog(self):
+        """Test with dynamic catalog."""
+        self.assertFalse(di.is_declarative_catalog(di.DynamicCatalog(
+            'TestCatalog')))
+
+
 class IsCatalogBundleTests(unittest.TestCase):
     """`is_catalog_bundle()` test cases."""