Merge branch 'release/4.24.0' into master

Author: rmk135

docs/containers/copying.rst

@@ -0,0 +1,14 @@
+Container copying
+-----------------
+
+You can create declarative container copies using ``@containers.copy()`` decorator.
+
+.. literalinclude:: ../../examples/containers/declarative_copy_decorator.py
+   :language: python
+   :lines: 3-
+   :emphasize-lines: 18-22
+
+Decorator ``@containers.copy()`` copies providers from source container to destination container.
+Destination container provider will replace source provider, if names match.
+
+.. disqus::

docs/containers/index.rst

@@ -23,6 +23,7 @@ Containers module API docs - :py:mod:`dependency_injector.containers`.
     dynamic
     specialization
     overriding
+    copying
     reset_singletons
     check_dependencies
     traversal

docs/main/changelog.rst

@@ -7,6 +7,12 @@ that were made in every particular version.
 From version 0.7.6 *Dependency Injector* framework strictly 
 follows `Semantic versioning`_
 
+4.24.0
+------
+- Add docs on ``@containers.copy()`` decorator.
+- Refactor ``@containers.copy()`` decorator.
+- Refactor async mode support in containers module.
+
 4.23.5
 ------
 - Fix docs publishing.

examples/containers/declarative_copy_decorator.py

@@ -0,0 +1,31 @@
+"""Declarative container provider copying with ``@copy()`` decorator."""
+
+import sqlite3
+from unittest import mock
+
+from dependency_injector import containers, providers
+
+
+class Service:
+    def __init__(self, db):
+        self.db = db
+
+
+class SourceContainer(containers.DeclarativeContainer):
+
+    database = providers.Singleton(sqlite3.connect, ':memory:')
+    service = providers.Factory(Service, db=database)
+
+
+# Copy ``SourceContainer`` providers into ``DestinationContainer``:
+@containers.copy(SourceContainer)
+class DestinationContainer(SourceContainer):
+
+    database = providers.Singleton(mock.Mock)
+
+
+if __name__ == '__main__':
+    container = DestinationContainer()
+
+    service = container.service()
+    assert isinstance(service.db, mock.Mock)

examples/containers/declarative_override_decorator.py

@@ -1,4 +1,4 @@
-"""Declarative container provider overriding with `@override()` decorator."""
+"""Declarative container provider overriding with ``@override()`` decorator."""
 
 import sqlite3
 from unittest import mock
@@ -11,7 +11,7 @@ class Container(containers.DeclarativeContainer):
     database = providers.Singleton(sqlite3.connect, ':memory:')
 
 
-# Overriding `Container` with `OverridingContainer`:
+# Overriding ``Container`` with ``OverridingContainer``:
 @containers.override(Container)
 class OverridingContainer(containers.DeclarativeContainer):
 

src/dependency_injector/__init__.py

@@ -1,6 +1,6 @@
 """Top-level package."""
 
-__version__ = '4.23.5'
+__version__ = '4.24.0'
 """Version number.
 
 :type: str