mirror of
https://github.com/ets-labs/python-dependency-injector.git
synced 2024-11-24 10:34:01 +03:00
136 lines
3.6 KiB
Python
136 lines
3.6 KiB
Python
"""Utils module."""
|
|
|
|
import sys
|
|
import copy
|
|
import types
|
|
import threading
|
|
|
|
import six
|
|
|
|
from dependency_injector import errors
|
|
|
|
|
|
GLOBAL_LOCK = threading.RLock()
|
|
"""Dependency injector global reentrant lock.
|
|
|
|
:type: :py:class:`threading.RLock`
|
|
"""
|
|
|
|
_IS_PYPY = '__pypy__' in sys.builtin_module_names
|
|
if _IS_PYPY or six.PY3: # pragma: no cover
|
|
_OBJECT_INIT = six.get_unbound_function(object.__init__)
|
|
else: # pragma: no cover
|
|
_OBJECT_INIT = None
|
|
|
|
if six.PY2: # pragma: no cover
|
|
copy._deepcopy_dispatch[types.MethodType] = \
|
|
lambda obj, memo: type(obj)(obj.im_func,
|
|
copy.deepcopy(obj.im_self, memo),
|
|
obj.im_class)
|
|
|
|
|
|
def is_provider(instance):
|
|
"""Check if instance is provider instance.
|
|
|
|
:param instance: Instance to be checked.
|
|
:type instance: object
|
|
|
|
:rtype: bool
|
|
"""
|
|
return (not isinstance(instance, six.class_types) and
|
|
hasattr(instance, '__IS_PROVIDER__') and
|
|
getattr(instance, '__IS_PROVIDER__') is True)
|
|
|
|
|
|
def ensure_is_provider(instance):
|
|
"""Check if instance is provider instance and return it.
|
|
|
|
:param instance: Instance to be checked.
|
|
:type instance: object
|
|
|
|
:raise: :py:exc:`dependency_injector.errors.Error` if provided instance is
|
|
not provider.
|
|
|
|
:rtype: :py:class:`dependency_injector.providers.Provider`
|
|
"""
|
|
if not is_provider(instance):
|
|
raise errors.Error('Expected provider instance, '
|
|
'got {0}'.format(str(instance)))
|
|
return instance
|
|
|
|
|
|
def is_catalog(instance):
|
|
"""Check if instance is catalog instance.
|
|
|
|
:param instance: Instance to be checked.
|
|
:type instance: object
|
|
|
|
:rtype: bool
|
|
"""
|
|
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.
|
|
|
|
:param instance: Instance to be checked.
|
|
:type instance: object
|
|
|
|
:rtype: bool
|
|
"""
|
|
return (not isinstance(instance, six.class_types) and is_catalog(instance))
|
|
|
|
|
|
def is_declarative_catalog(instance):
|
|
"""Check if instance is declarative catalog instance.
|
|
|
|
:param instance: Instance to be checked.
|
|
:type instance: object
|
|
|
|
:rtype: bool
|
|
"""
|
|
return (isinstance(instance, six.class_types) and is_catalog(instance))
|
|
|
|
|
|
def represent_provider(provider, provides):
|
|
"""Return string representation of provider.
|
|
|
|
:param provider: Provider object
|
|
:type provider: :py:class:`dependency_injector.providers.Provider`
|
|
|
|
:param provides: Object that provider provides
|
|
:type provider: object
|
|
|
|
:return: String representation of provider
|
|
:rtype: str
|
|
"""
|
|
return '<{provider}({provides}) at {address}>'.format(
|
|
provider='.'.join((provider.__class__.__module__,
|
|
provider.__class__.__name__)),
|
|
provides=repr(provides) if provides is not None else '',
|
|
address=hex(id(provider)))
|
|
|
|
|
|
def fetch_cls_init(cls):
|
|
"""Return reference to the class.__init__() method if it is defined.
|
|
|
|
:param cls: Class instance
|
|
:type cls: type
|
|
|
|
:return: Reference to the class.__init__() if any, or None otherwise.
|
|
:rtype: unbound method | None
|
|
"""
|
|
try:
|
|
cls_init = six.get_unbound_function(cls.__init__)
|
|
assert cls_init is not _OBJECT_INIT
|
|
except (AttributeError, AssertionError):
|
|
return None
|
|
else:
|
|
return cls_init
|
|
|
|
|
|
def _copy_providers(providers, memo=None):
|
|
"""Make full copy of providers dictionary."""
|
|
return copy.deepcopy(providers, memo)
|