Merge branch 'release/3.9.0' into master

Author: rmk135

docs/examples/bundles_miniapp.rst

@@ -0,0 +1,77 @@
+Bundles mini application example
+--------------------------------
+
+.. currentmodule:: dependency_injector.containers
+
+"Bundles" is an example mini application that is intented to demonstrate the 
+power of dependency injection for creation of re-usable application components
+("bundles") with 100% transparency of their dependencies.
+
+Example application
+~~~~~~~~~~~~~~~~~~~
+
+"Bundles" mini application has next structure:
+
+.. code-block:: bash
+
+    bundles/
+        bundles/               <-- Bundles package
+            photos/            <-- Photos bundle
+                __init__.py    <-- Photos bundle dependency injection container
+                entities.py
+                repositories.py
+            users/             <-- Users bundle
+                __init__.py    <-- Users bundle dependency injection container
+                entities.py
+                repositories.py
+        run.py                 <-- Entrypoint
+
+
+IoC containers
+~~~~~~~~~~~~~~
+
+Next two listings show :py:class:`DeclarativeContainer`'s for "users" and 
+"photos" bundles.
+
+Listing of ``bundeles/users/__init__.py``:
+
+.. literalinclude:: ../../examples/miniapps/bundles/bundles/users/__init__.py
+   :language: python
+   :linenos:
+
+.. note::
+
+    - ``Users`` container has dependency on database.
+
+Listing of ``bundeles/photos/__init__.py``:
+
+.. literalinclude:: ../../examples/miniapps/bundles/bundles/photos/__init__.py
+   :language: python
+   :linenos:
+
+.. note::
+
+    - ``Photos`` container has dependencies on database and file storage.
+
+Run application
+~~~~~~~~~~~~~~~
+
+Finally, both "bundles" are initialized by providing needed dependencies.
+Initialization of dependencies happens right in the runtime, not earlier.
+Generally, it means, that any part of any bundle could be overridden on the
+fly.
+
+Listing of ``run.py``:
+
+.. literalinclude:: ../../examples/miniapps/bundles/run.py
+   :language: python
+   :linenos:
+
+Links
+~~~~~
+
++ `Dependency Injector <https://github.com/ets-labs/python-dependency-injector/>`_
++ `Full example sources <https://github.com/ets-labs/python-dependency-injector/tree/master/examples/miniapps/bundles>`_
+
+
+.. disqus::

docs/examples/index.rst

@@ -17,3 +17,4 @@ and powered by *Dependency Injector* framework.
 
     movie_lister
     services_miniapp
+    bundles_miniapp

docs/images/providers/dependency.png

@@ -7,6 +7,23 @@ that were made in every particular version.
 From version 0.7.6 *Dependency Injector* framework strictly 
 follows `Semantic versioning`_
 
+3.9.0
+-----
+- Change initialization of declarative container, so it accepts overriding 
+  providers as keyword arguments - 
+  ``DeclarativeContainer(**overriding_providers)``.
+- Add method to dynamic catalog for setting groups of providers -  
+  ``DynamicContainer.set_providers(**providers)``.
+- Add method to dynamic catalog for overriding groups of providers -  
+  ``DynamicContainer.set_providers(**overriding_providers)``.
+- Rename ``ExternalDependency`` provider to ``Dependency``.
+- Add default value for ``instance_of`` argument of ``Dependency`` provider -
+  ``Dependency(instance_of=object)``.
+- Fix bug when copying ``Configuration`` provider.
+- Regenerate C sources using Cython 0.27.3.
+- Add "bundles" example miniapp.
+
+
 3.8.2
 -----
 - Fix padding problem in code samples in docs (part 2).

docs/images/providers/external_dependency.png

@@ -1,9 +1,9 @@
-External dependency providers
------------------------------
+Dependency providers
+--------------------
 
 .. currentmodule:: dependency_injector.providers
 
-:py:class:`ExternalDependency` provider can be useful for development of
+:py:class:`Dependency` provider can be useful for development of
 self-sufficient libraries / modules / applications that have required external
 dependencies.
 
@@ -35,11 +35,10 @@ Example:
     Instead of this, ``UsersService`` has external dependency, that has to
     be satisfied by cleint's code, out of library's scope.
 
-.. image:: /images/providers/external_dependency.png
+.. image:: /images/providers/dependency.png
 
-.. literalinclude:: ../../examples/providers/external_dependency.py
+.. literalinclude:: ../../examples/providers/dependency.py
    :language: python
    :linenos:
 
-
 .. disqus::

docs/main/changelog.rst

@@ -21,6 +21,6 @@ Providers package API docs - :py:mod:`dependency_injector.providers`
     singleton
     callable
     object
-    external_dependency
+    dependency
     overriding
     custom

docs/providers/external_dependency.rst renamed to docs/providers/dependency.rst

@@ -0,0 +1,8 @@
+Dependency Injector Bundles example
+===================================
+
+Instructions for running
+
+.. code-block:: bash
+
+    python run.py

docs/providers/index.rst

@@ -0,0 +1 @@
+"""Bundles package."""

examples/miniapps/bundles/README.rst

@@ -0,0 +1,20 @@
+"""Photos bundle."""
+
+from dependency_injector import containers
+from dependency_injector import providers
+
+from . import entities
+from . import repositories
+
+
+class Photos(containers.DeclarativeContainer):
+    """Photos bundle container."""
+
+    database = providers.Dependency()
+    file_storage = providers.Dependency()
+
+    photo = providers.Factory(entities.Photo)
+    photo_repository = providers.Singleton(repositories.PhotoRepository,
+                                           object_factory=photo.provider,
+                                           fs=file_storage,
+                                           db=database)