From ed9391cc6eb0aa538952ed4564ce0c6fdb6a7b5f Mon Sep 17 00:00:00 2001
From: Roman Mogilatov <rmogilatov@gmail.com>
Date: Wed, 19 Oct 2016 20:20:36 +0300
Subject: [PATCH] Create engines & cars example miniapp

---
 docs/images/miniapps/engines_cars/diagram.png | Bin 0 -> 13461 bytes
 docs/introduction/di_in_python.rst            |  39 +++++++++---------
 docs/main/changelog.rst                       |   1 +
 examples/miniapps/engines_cars/README.rst     |   9 ++++
 .../miniapps/engines_cars/example/__init__.py |   1 +
 .../miniapps/engines_cars/example/cars.py     |   9 ++++
 .../miniapps/engines_cars/example/engines.py  |  21 ++++++++++
 examples/miniapps/engines_cars/example_di.py  |  10 +++++
 .../engines_cars/example_ioc_containers.py    |  36 ++++++++++++++++
 9 files changed, 107 insertions(+), 19 deletions(-)
 create mode 100644 docs/images/miniapps/engines_cars/diagram.png
 create mode 100644 examples/miniapps/engines_cars/README.rst
 create mode 100644 examples/miniapps/engines_cars/example/__init__.py
 create mode 100644 examples/miniapps/engines_cars/example/cars.py
 create mode 100644 examples/miniapps/engines_cars/example/engines.py
 create mode 100644 examples/miniapps/engines_cars/example_di.py
 create mode 100644 examples/miniapps/engines_cars/example_ioc_containers.py

diff --git a/docs/images/miniapps/engines_cars/diagram.png b/docs/images/miniapps/engines_cars/diagram.png
new file mode 100644
index 0000000000000000000000000000000000000000..6320bfddb27ce143fad51ab0d6c36a65e05e31e9
GIT binary patch
literal 13461
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
ABme*a

literal 0
HcmV?d00001

diff --git a/docs/introduction/di_in_python.rst b/docs/introduction/di_in_python.rst
index 8411403f..c7cf6b91 100644
--- a/docs/introduction/di_in_python.rst
+++ b/docs/introduction/di_in_python.rst
@@ -93,35 +93,36 @@ Example
 
 Let's go through next example:
 
-.. literalinclude:: ../../examples/ioc_di_demos/car_engine.py
+.. image:: /images/miniapps/engines_cars/diagram.png
+    :width: 100%
+    :align: center
+
+Listing of ``example.engines`` module:
+
+.. literalinclude:: ../../examples/miniapps/engines_cars/example/engines.py
    :language: python
    :linenos:
 
-``Car`` **creates** an ``Engine`` during its creation. Really? Does it make 
-more sense than creating an ``Engine`` separately and then 
-**inject (put) it into** ``Car`` when ``Car`` is being created?
+Listing of ``example.cars`` module:
 
-.. literalinclude:: ../../examples/ioc_di_demos/car_engine_ioc.py
+.. literalinclude:: ../../examples/miniapps/engines_cars/example/cars.py
    :language: python
    :linenos:
 
-Previous example may look more obvious and gives a chance to start getting 
-other benefits of dependency injection and inversion of control, but creation 
-of ``Car`` instances became a bit harder cause now ``Engine`` injections 
-should be done manually every time when ``Car`` instances are being created.
+Next example demonstrates creation of several cars with different engines:
 
-Let's automate ``Engine`` into ``Car`` injections using *Dependency Injector*:
-
-
-.. literalinclude:: ../../examples/ioc_di_demos/car_engine_ioc_container.py
+.. literalinclude:: ../../examples/miniapps/engines_cars/example_di.py
    :language: python
    :linenos:
 
-.. note::
+While previous example demonstrates advantage of dependency injection, there 
+is a disadvantage demonstration as well - creation of car requires additional 
+code for specification of dependencies. Nevertheless, this disadvantage could 
+be easily avoided by creating inversion of control container (IoC container).
 
-    ``Container`` from previous example is an inversion of control container. 
-    It contains a collection of component providers that could be injected 
-    into each other. 
+Example of creation of several inversion of control containers (IoC containers)
+using *Dependency Injector*:
 
-    Assuming this, ``Container`` could be one and the only place, where 
-    application's structure is being managed on the high level.
+.. literalinclude:: ../../examples/miniapps/engines_cars/example_ioc_containers.py
+   :language: python
+   :linenos:
diff --git a/docs/main/changelog.rst b/docs/main/changelog.rst
index 3a9e6304..fea54aa1 100644
--- a/docs/main/changelog.rst
+++ b/docs/main/changelog.rst
@@ -12,6 +12,7 @@ Development version
 .. - No features.
 - Add github badges to readme and docs index pages.
 - Update service names in services example miniapp.
+- Create engines & cars example miniapp.
 
 2.2.8
 -----
diff --git a/examples/miniapps/engines_cars/README.rst b/examples/miniapps/engines_cars/README.rst
new file mode 100644
index 00000000..b36b02b6
--- /dev/null
+++ b/examples/miniapps/engines_cars/README.rst
@@ -0,0 +1,9 @@
+Engines & Cars Dependency Injection Example
+===========================================
+
+Instructions for running:
+
+.. code-block:: bash
+
+    python example_di.py
+    python example_ioc_containers.py
diff --git a/examples/miniapps/engines_cars/example/__init__.py b/examples/miniapps/engines_cars/example/__init__.py
new file mode 100644
index 00000000..bfa99aa2
--- /dev/null
+++ b/examples/miniapps/engines_cars/example/__init__.py
@@ -0,0 +1 @@
+"""Example top-level package."""
diff --git a/examples/miniapps/engines_cars/example/cars.py b/examples/miniapps/engines_cars/example/cars.py
new file mode 100644
index 00000000..a1ddc027
--- /dev/null
+++ b/examples/miniapps/engines_cars/example/cars.py
@@ -0,0 +1,9 @@
+"""Dependency injection example, cars module."""
+
+
+class Car(object):
+    """Example car."""
+
+    def __init__(self, engine):
+        """Initializer."""
+        self._engine = engine  # Engine is injected
diff --git a/examples/miniapps/engines_cars/example/engines.py b/examples/miniapps/engines_cars/example/engines.py
new file mode 100644
index 00000000..8e42ec1d
--- /dev/null
+++ b/examples/miniapps/engines_cars/example/engines.py
@@ -0,0 +1,21 @@
+"""Dependency injection example, engines module."""
+
+
+class Engine(object):
+    """Example engine base class.
+
+    Engine is a heart of every car. Engine is a very common term and could be
+    implemented in very different ways.
+    """
+
+
+class GasolineEngine(Engine):
+    """Gasoline engine."""
+
+
+class DieselEngine(Engine):
+    """Diesel engine."""
+
+
+class ElectroEngine(Engine):
+    """Electro engine."""
diff --git a/examples/miniapps/engines_cars/example_di.py b/examples/miniapps/engines_cars/example_di.py
new file mode 100644
index 00000000..317d7d8f
--- /dev/null
+++ b/examples/miniapps/engines_cars/example_di.py
@@ -0,0 +1,10 @@
+"""Dependency injection example, Cars & Engines."""
+
+import example.cars
+import example.engines
+
+
+if __name__ == '__main__':
+    gasoline_car = example.cars.Car(example.engines.GasolineEngine())
+    diesel_car = example.cars.Car(example.engines.DieselEngine())
+    electro_car = example.cars.Car(example.engines.ElectroEngine())
diff --git a/examples/miniapps/engines_cars/example_ioc_containers.py b/examples/miniapps/engines_cars/example_ioc_containers.py
new file mode 100644
index 00000000..b97ab121
--- /dev/null
+++ b/examples/miniapps/engines_cars/example_ioc_containers.py
@@ -0,0 +1,36 @@
+"""Dependency injection example, Cars & Engines IoC containers."""
+
+import example.cars
+import example.engines
+
+import dependency_injector.containers as containers
+import dependency_injector.providers as providers
+
+
+class Engines(containers.DeclarativeContainer):
+    """IoC container of engine providers."""
+
+    gasoline = providers.Factory(example.engines.GasolineEngine)
+
+    diesel = providers.Factory(example.engines.DieselEngine)
+
+    electro = providers.Factory(example.engines.ElectroEngine)
+
+
+class Cars(containers.DeclarativeContainer):
+    """IoC container of car providers."""
+
+    gasoline = providers.Factory(example.cars.Car,
+                                 engine=Engines.gasoline)
+
+    diesel = providers.Factory(example.cars.Car,
+                               engine=Engines.diesel)
+
+    electro = providers.Factory(example.cars.Car,
+                                engine=Engines.electro)
+
+
+if __name__ == '__main__':
+    gasoline_car = Cars.gasoline()
+    diesel_car = Cars.diesel()
+    electro_car = Cars.electro()