From c4b33749d245dd9d650836194e60a106249a8856 Mon Sep 17 00:00:00 2001
From: Roman Mogylatov <rmogilatov@gmail.com>
Date: Tue, 1 Sep 2020 21:39:23 -0400
Subject: [PATCH] Providers docs update (#289)

* Update callable provider docs

* Update coroutine provider docs

* Edit object docs

* Edit list provider docs

* Edit configuration provider docs

* Edit selector provider docs

* Fix mypy stub of the ``DeclarativeContainer`` to specify the ``__init__`` interface

* Edit Dependency provider docs
---
 docs/images/providers/callable.png          | Bin 32436 -> 0 bytes
 docs/images/providers/dependency.png        | Bin 42660 -> 0 bytes
 docs/main/changelog.rst                     |   5 +-
 docs/providers/callable.rst                 |  73 +++-----------
 docs/providers/configuration.rst            |  87 ++++++++++-------
 docs/providers/coroutine.rst                |  77 ++++-----------
 docs/providers/dependency.rst               |  44 +++------
 docs/providers/list.rst                     |  33 +++----
 docs/providers/object.rst                   |  15 +--
 docs/providers/selector.rst                 |  38 ++++----
 examples/providers/callable.py              |  18 ++++
 examples/providers/callable_args.py         |  16 ----
 examples/providers/callable_kwargs.py       |  16 ----
 examples/providers/coroutine.py             |  19 ++--
 examples/providers/coroutine_async_await.py |  25 -----
 examples/providers/dependency.py            | 101 ++++++++------------
 examples/providers/list.py                  |  20 ++--
 examples/providers/object.py                |  10 +-
 examples/providers/selector.py              |  13 +--
 src/dependency_injector/containers.pyi      |   1 +
 20 files changed, 217 insertions(+), 394 deletions(-)
 delete mode 100644 docs/images/providers/callable.png
 delete mode 100644 docs/images/providers/dependency.png
 create mode 100644 examples/providers/callable.py
 delete mode 100644 examples/providers/callable_args.py
 delete mode 100644 examples/providers/callable_kwargs.py
 delete mode 100644 examples/providers/coroutine_async_await.py

diff --git a/docs/images/providers/callable.png b/docs/images/providers/callable.png
deleted file mode 100644
index f34b2a6ad1ee8f2875ada583e3d502c3522a73d0..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 32436
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

diff --git a/docs/images/providers/dependency.png b/docs/images/providers/dependency.png
deleted file mode 100644
index dfd2f149874d8c5d3e391c4b6f52c6f7f8efa494..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 42660
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
P?+>Moxk9~kE9k!frZ*Ty

diff --git a/docs/main/changelog.rst b/docs/main/changelog.rst
index ba3196e7..83459780 100644
--- a/docs/main/changelog.rst
+++ b/docs/main/changelog.rst
@@ -9,8 +9,9 @@ follows `Semantic versioning`_
 
 Development version
 -------------------
-- Update ``Singleton`` provider documentation.
-- Rework ``Singleton`` provider examples.
+- Update documentation and rework examples for: ``Singleton``, ``Callable``, ``Coroutine``,
+  ``Object``, ``List``, ``Configuration``, ``Selector``, and ``Dependency`` providers.
+- Fix mypy stub of the ``DeclarativeContainer`` to specify the ``__init__`` interface.
 
 3.34.0
 ------
diff --git a/docs/providers/callable.rst b/docs/providers/callable.rst
index 9c82c87f..e0cb5089 100644
--- a/docs/providers/callable.rst
+++ b/docs/providers/callable.rst
@@ -1,69 +1,20 @@
-Callable providers
-------------------
+Callable provider
+-----------------
+
+.. meta::
+   :keywords: Python,DI,Dependency injection,IoC,Inversion of Control,Function,Method,Example
+   :description: Callable provider helps to make dependencies injection into functions. This page
+                 demonstrates how to use a Callable provider.
 
 .. currentmodule:: dependency_injector.providers
 
-:py:class:`Callable` provider calls wrapped callable on every call.
+:py:class:`Callable` provider calls a function, a method or another callable.
 
-Callable providers and injections
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-:py:class:`Callable` provider takes a various number of positional and keyword 
-arguments that are used as wrapped callable injections. Every time, when 
-:py:class:`Callable` provider is called, positional and keyword argument 
-injections would be passed as callable arguments.
-
-Injections are done according to the next rules:
-
-+ All providers (instances of :py:class:`Provider`) are called every time 
-  when injection needs to be done.
-+ Providers could be injected "as is" (delegated), if it is defined obviously.
-  Check out :ref:`callable_providers_delegation`.
-+ All other injectable values are provided *"as is"*.
-+ Positional context arguments will be appended after :py:class:`Callable` 
-  positional injections.
-+ Keyword context arguments have priority on :py:class:`Callable` keyword 
-  injections and will be merged over them.
-
-Example that shows usage of :py:class:`Callable` with positional argument 
-injections:
-
-.. literalinclude:: ../../examples/providers/callable_args.py
+.. literalinclude:: ../../examples/providers/callable.py
    :language: python
+   :lines: 3-
 
-Next one example shows usage of :py:class:`Callable` with keyword argument 
-injections:
-
-.. image:: /images/providers/callable.png
-    :width: 100%
-    :align: center
-
-.. literalinclude:: ../../examples/providers/callable_kwargs.py
-   :language: python
-
-.. _callable_providers_delegation:
-
-Callable providers delegation
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-:py:class:`Callable` provider could be delegated to any other provider via 
-any kind of injection. 
-
-Delegation of :py:class:`Callable` providers is the same as 
-:py:class:`Factory` providers delegation, please follow 
-:ref:`factory_providers_delegation` section for examples (with exception 
-of using :py:class:`DelegatedCallable` instead of
-:py:class:`DelegatedFactory`).
-
-Abstract callable providers
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-:py:class:`AbstractCallable` provider is a :py:class:`Callable` provider that
-must be explicitly overridden before calling.
-
-Behaviour of :py:class:`AbstractCallable` providers is the same as of
-:py:class:`AbstractFactory`, please follow :ref:`abstract_factory_providers`
-section for examples (with exception of using :py:class:`AbstractCallable`
-provider instead of :py:class:`AbstractFactory`).
+``Callable`` provider handles an injection of the dependencies the same way like a
+:ref:`factory-provider`.
 
 .. disqus::
diff --git a/docs/providers/configuration.rst b/docs/providers/configuration.rst
index dfa20539..43fd3ee3 100644
--- a/docs/providers/configuration.rst
+++ b/docs/providers/configuration.rst
@@ -1,5 +1,12 @@
-Configuration providers
------------------------
+Configuration provider
+----------------------
+
+.. meta::
+   :keywords: Python,DI,Dependency injection,IoC,Inversion of Control,Configuration,Injection,
+              Option,Ini,Json,Yaml,Dict,Environment Variable,Load,Read,Get
+   :description: Configuration provides configuration options to the other providers. This page
+                 demonstrates how to use Configuration provider to inject the dependencies, load
+                 a configuration from an ini or yaml file, dictionary or an environment variable.
 
 .. currentmodule:: dependency_injector.providers
 
@@ -10,13 +17,13 @@ Configuration providers
    :emphasize-lines: 4,9-10
    :lines: 4-14
 
-It implements "use first, define later" principle.
+It implements the principle "use first, define later".
 
-Loading from ``ini`` file
-~~~~~~~~~~~~~~~~~~~~~~~~~
+Loading from an INI file
+~~~~~~~~~~~~~~~~~~~~~~~~
 
-:py:class:`Configuration` provider can load configuration from ``ini`` file using
-:py:meth:`Configuration.from_ini`:
+``Configuration`` provider can load configuration from an ``ini`` file using the
+:py:meth:`Configuration.from_ini` method:
 
 .. literalinclude:: ../../examples/providers/configuration/configuration_ini.py
    :language: python
@@ -28,15 +35,15 @@ where ``examples/providers/configuration/config.ini`` is:
 .. literalinclude:: ../../examples/providers/configuration/config.ini
    :language: ini
 
-:py:meth:`Configuration.from_ini` supports environment variables interpolation. Use
-``${ENV_NAME}`` format in the configuration file to substitute value of environment
+:py:meth:`Configuration.from_ini` method supports environment variables interpolation. Use
+``${ENV_NAME}`` format in the configuration file to substitute value of the environment
 variable ``ENV_NAME``.
 
-Loading from ``yaml`` file
-~~~~~~~~~~~~~~~~~~~~~~~~~~
+Loading from a YAML file
+~~~~~~~~~~~~~~~~~~~~~~~~
 
-:py:class:`Configuration` provider can load configuration from ``yaml`` file using
-:py:meth:`Configuration.from_yaml`:
+``Configuration`` provider can load configuration from a ``yaml`` file using the
+:py:meth:`Configuration.from_yaml` method:
 
 .. literalinclude:: ../../examples/providers/configuration/configuration_yaml.py
    :language: python
@@ -48,43 +55,51 @@ where ``examples/providers/configuration/config.yml`` is:
 .. literalinclude:: ../../examples/providers/configuration/config.yml
    :language: ini
 
-:py:meth:`Configuration.from_yaml` supports environment variables interpolation. Use
-``${ENV_NAME}`` format in the configuration file to substitute value of environment
+:py:meth:`Configuration.from_yaml` method supports environment variables interpolation. Use
+``${ENV_NAME}`` format in the configuration file to substitute value of the environment
 variable ``ENV_NAME``.
 
 .. note::
 
-    Loading configuration from yaml requires ``PyYAML`` package. You can install
-    `Dependency Injector` with extras ``pip install dependency-injector[yaml]`` or install
-    ``PyYAML`` separately  ``pip install pyyaml``.
+   Loading of a yaml configuration requires ``PyYAML`` package.
 
-Loading from ``dict``
-~~~~~~~~~~~~~~~~~~~~~
+   You can install the ``Dependency Injector`` with an extra dependency::
 
-:py:class:`Configuration` provider can load configuration from Python ``dict`` using
-:py:meth:`Configuration.from_dict`:
+      pip install dependency-injector[yaml]
+
+   or install ``PyYAML`` directly::
+
+      pip install pyyaml
+
+   *Don't forget to mirror the changes in the requirements file.*
+
+Loading from a dictionary
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``Configuration`` provider can load configuration from a Python ``dict`` using the
+:py:meth:`Configuration.from_dict` method:
 
 .. literalinclude:: ../../examples/providers/configuration/configuration_dict.py
    :language: python
    :lines: 3-5,6-
    :emphasize-lines: 6-13
 
-Loading from environment variable
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Loading from an environment variable
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-:py:class:`Configuration` provider can load configuration from environment variable using
-:py:meth:`Configuration.from_env`:
+``Configuration`` provider can load configuration from an environment variable using the
+:py:meth:`Configuration.from_env` method:
 
 .. literalinclude:: ../../examples/providers/configuration/configuration_env.py
    :language: python
    :lines: 5-7,13-21
    :emphasize-lines: 6-8
 
-Loading from multiple sources
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Loading from the multiple sources
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-:py:class:`Configuration` provider can load configuration from multiple sources. Loaded
-configuration is merged recursively over existing configuration.
+``Configuration`` provider can load configuration from the multiple sources. Loaded
+configuration is merged recursively over the existing configuration.
 
 .. literalinclude:: ../../examples/providers/configuration/configuration_multiple.py
    :language: python
@@ -96,12 +111,12 @@ where ``examples/providers/configuration/config.local.yml`` is:
 .. literalinclude:: ../../examples/providers/configuration/config.local.yml
    :language: ini
 
-Specifying value type
-~~~~~~~~~~~~~~~~~~~~~
+Specifying the value type
+~~~~~~~~~~~~~~~~~~~~~~~~~
 
 You can specify the type of the injected configuration value explicitly.
 
-This helps when you read the value from the ini file or the environment variable and need to
+This helps when you read the value from an ini file or an environment variable and need to
 convert it into an ``int`` or a ``float``.
 
 .. literalinclude:: ../../examples/providers/configuration/configuration_type.py
@@ -109,20 +124,20 @@ convert it into an ``int`` or a ``float``.
    :lines: 3-
    :emphasize-lines: 17
 
-:py:class:`Configuration` provider has next helper methods:
+``Configuration`` provider has next helper methods:
 
 - ``.as_int()``
 - ``.as_float()``
 - ``.as_(callback, *args, **kwargs)``
 
-The last method ``.as_(callback, *args, **kwargs)`` helps to implement a other conversions.
+The last method ``.as_(callback, *args, **kwargs)`` helps to implement other conversions.
 
 .. literalinclude:: ../../examples/providers/configuration/configuration_type_custom.py
    :language: python
    :lines: 3-
    :emphasize-lines: 16
 
-With the ``.as_(callback, *args, **kwargs)`` you can specify the function that will be called
+With the ``.as_(callback, *args, **kwargs)`` you can specify a function that will be called
 before the injection. The value from the config will be passed as a first argument. The returned
 value will be injected. Parameters ``*args`` and ``**kwargs`` are handled as any other injections.
 
diff --git a/docs/providers/coroutine.rst b/docs/providers/coroutine.rst
index 303e420e..3db7846a 100644
--- a/docs/providers/coroutine.rst
+++ b/docs/providers/coroutine.rst
@@ -1,72 +1,27 @@
-Coroutine providers
--------------------
+Coroutine provider
+------------------
+
+.. meta::
+   :keywords: Python,DI,Dependency injection,IoC,Inversion of Control,Coroutine,Asynchronous,
+              Asyncio,Example
+   :description: Coroutine provider creates a coroutine. This page demonstrates how to use a
+                 Coroutine provider.
 
 .. currentmodule:: dependency_injector.providers
 
-:py:class:`Coroutine` provider create wrapped coroutine on every call.
+:py:class:`Coroutine` provider creates a coroutine.
 
-:py:class:`Coroutine` provider is designed for making better integration with
-``asyncio`` coroutines. In particular, :py:class:`Coroutine` provider returns
-``True`` for ``asyncio.iscoroutinefunction()`` checks.
-
-.. note::
-
-    :py:class:`Coroutine` provider works only for Python 3.4+.
-
-Example of usage :py:class:`Coroutine` provider with ``async / await``-based
-coroutine:
-
-.. literalinclude:: ../../examples/providers/coroutine_async_await.py
+.. literalinclude:: ../../examples/providers/coroutine.py
    :language: python
-
-Coroutine providers and injections
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-:py:class:`Coroutine` provider takes a various number of positional and keyword
-arguments that are used as wrapped coroutine injections. Every time, when
-:py:class:`Coroutine` provider is called, positional and keyword argument
-injections would be passed as coroutine arguments.
-
-Injections are done according to the next rules:
-
-+ All providers (instances of :py:class:`Provider`) are called every time 
-  when injection needs to be done.
-+ Providers could be injected "as is" (delegated), if it is defined obviously.
-  Check out :ref:`coroutine_providers_delegation`.
-+ All other injectable values are provided *"as is"*.
-+ Positional context arguments will be appended after :py:class:`Coroutine`
-  positional injections.
-+ Keyword context arguments have priority on :py:class:`Coroutine` keyword
-  injections and will be merged over them.
+   :lines: 3-
 
 .. note::
+   The example works on Python 3.7+. For earlier versions use ``loop.run_until_complete()``.
 
-    Examples of making injections could be found in API docs -
-    :py:class:`Coroutine`.
+``Coroutine`` provider handles an injection of the dependencies the same way like a
+:ref:`factory-provider`.
 
-.. _coroutine_providers_delegation:
-
-Coroutine providers delegation
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-:py:class:`Coroutine` provider could be delegated to any other provider via
-any kind of injection. 
-
-Delegation of :py:class:`Coroutine` providers is the same as
-:py:class:`Factory` providers delegation, please follow 
-:ref:`factory_providers_delegation` section for examples (with exception 
-of using :py:class:`DelegatedCoroutine` instead of
-:py:class:`DelegatedFactory`).
-
-Abstract coroutine providers
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-:py:class:`AbstractCoroutine` provider is a :py:class:`Coroutine` provider that
-must be explicitly overridden before calling.
-
-Behaviour of :py:class:`AbstractCoroutine` providers is the same as of
-:py:class:`AbstractFactory`, please follow :ref:`abstract_factory_providers`
-section for examples (with exception of using :py:class:`AbstractCoroutine`
-provider instead of :py:class:`AbstractFactory`).
+.. note::
+   ``Coroutine`` provider returns ``True`` for ``asyncio.iscoroutinefunction()`` check.
 
 .. disqus::
diff --git a/docs/providers/dependency.rst b/docs/providers/dependency.rst
index 4bd9bf2f..9ce3977b 100644
--- a/docs/providers/dependency.rst
+++ b/docs/providers/dependency.rst
@@ -1,43 +1,21 @@
-Dependency providers
---------------------
+Dependency provider
+-------------------
 
 .. currentmodule:: dependency_injector.providers
 
-:py:class:`Dependency` provider can be useful for development of
-self-sufficient libraries / modules / applications that have required external
-dependencies.
+:py:class:`Dependency` provider is a placeholder for the dependency of the specified type.
 
-For example, you have created self-sufficient library / module / application,
-that has dependency on *database connection*.
+The first argument of the ``Dependency`` provider specifies a type of the dependency. It is
+called ``instance_of``. ``Dependency`` provider controls the type of the returned object to be an
+instance of the ``instance_of`` type.
 
-Second step you want to do is to make this software component to be easy
-reusable by wide amount of developers and to be easily integrated into many
-applications.
-
-It may be good idea, to move all external dependencies (like
-*database connection*) to the top level and make them to be injected on your
-software component's initialization. It will make third party developers feel
-themselves free about integration of your component in their applications,
-because they would be able to find right place / right way for doing this
-in their application's architectures.
-
-At the same time, you can be sure, that your external dependency will be
-satisfied with appropriate instance.
-
-Example:
-
-.. note::
-
-    Class ``UsersService`` is a part of some library. ``UsersService`` has
-    dependency on database connection, which can be satisfied with any
-    DBAPI 2.0 database connection. Being a self-sufficient library,
-    ``UsersService`` doesn't hardcode any kind of database management logic.
-    Instead of this, ``UsersService`` has external dependency, that has to
-    be satisfied by client's code, out of library's scope.
-
-.. image:: /images/providers/dependency.png
+The ``Dependency`` provider must be overridden before usage. It can be overridden by any type of
+the provider. The only rule is that overriding provider must return an instance of ``instance_of``
+dependency type.
 
 .. literalinclude:: ../../examples/providers/dependency.py
    :language: python
+   :lines: 3-
+   :emphasize-lines: 26
 
 .. disqus::
diff --git a/docs/providers/list.rst b/docs/providers/list.rst
index 4b92eeca..9ad4ece4 100644
--- a/docs/providers/list.rst
+++ b/docs/providers/list.rst
@@ -1,5 +1,10 @@
-List providers
---------------
+List provider
+-------------
+
+.. meta::
+   :keywords: Python,DI,Dependency injection,IoC,Inversion of Control,List,Injection
+   :description: List provider helps to inject a list of the dependencies. This page demonstrates
+                 how to use a List provider.
 
 .. currentmodule:: dependency_injector.providers
 
@@ -7,28 +12,12 @@ List providers
 
 .. literalinclude:: ../../examples/providers/list.py
    :language: python
-   :emphasize-lines: 6-9
-   :lines: 6-8, 23-29
-
-:py:class:`List` provider is needed for injecting a list of dependencies. It handles
-positional argument injections the same way as :py:class:`Factory` provider:
-
-+ All providers (instances of :py:class:`Provider`) are called every time
-  when injection needs to be done.
-+ Providers could be injected "as is" (delegated), if it is defined explicitly. Check out
-  :ref:`factory_providers_delegation`.
-+ All other values are injected *"as is"*.
-+ Positional context arguments will be appended after :py:class:`List` positional injections.
-
-Full example:
-
-.. literalinclude:: ../../examples/providers/list.py
-   :language: python
-   :emphasize-lines: 23-26
    :lines: 3-
+   :emphasize-lines: 19-22
+
+``List`` provider handles positional arguments the same way as a :ref:`factory-provider`.
 
 .. note::
-
-    Keyword argument injections are not supported.
+    Keyword argument are not supported.
 
 .. disqus::
diff --git a/docs/providers/object.rst b/docs/providers/object.rst
index 6599dd92..800b8116 100644
--- a/docs/providers/object.rst
+++ b/docs/providers/object.rst
@@ -1,14 +1,17 @@
-Object providers
-----------------
+Object provider
+---------------
+
+.. meta::
+   :keywords: Python,DI,Dependency injection,IoC,Inversion of Control,Object
+   :description: Object provider provides an object "as is". This page demonstrates how to use an
+                 Object provider.
 
 .. currentmodule:: dependency_injector.providers
 
-:py:class:`Object` provider returns provided instance "as is".
-
-Example:
+:py:class:`Object` provider returns an object "as is".
 
 .. literalinclude:: ../../examples/providers/object.py
    :language: python
-
+   :lines: 3-
 
 .. disqus::
diff --git a/docs/providers/selector.rst b/docs/providers/selector.rst
index 29867217..f7b0a9e7 100644
--- a/docs/providers/selector.rst
+++ b/docs/providers/selector.rst
@@ -3,29 +3,31 @@
 Selector providers
 ------------------
 
+.. meta::
+   :keywords: Python,DI,Dependency injection,IoC,Inversion of Control,Configuration,Injection,
+              Selector,Polymorphism,Environment Variable,Flexibility
+   :description: Selector selects provider based on a configuration value or another callable.
+                 This page demonstrates how to implement the polymorphism and increase the
+                 flexibility of your application using the Selector provider.
+
 .. currentmodule:: dependency_injector.providers
 
-:py:class:`Selector` provider selects provider based on the configuration value or other callable.
+:py:class:`Selector` provider selects provider based on a configuration value or another callable.
 
 .. literalinclude:: ../../examples/providers/selector.py
    :language: python
-   :emphasize-lines: 6-10
-   :lines: 3-5,14-20
-
-:py:class:`Selector` provider has a callable called ``selector`` and a dictionary of providers.
-
-The ``selector`` callable is provided as a first positional argument. It can be
-:py:class:`Configuration` provider or any other callable. It has to return a string value.
-This value is used as a key for selecting the provider from the dictionary of providers.
-
-The providers are provided as keyword arguments. Argument name is used as a key for
-selecting the provider.
-
-Full example:
-
-.. literalinclude:: ../../examples/providers/selector.py
-   :language: python
-   :emphasize-lines: 14-18
    :lines: 3-
+   :emphasize-lines: 14-18
+
+The first argument of the ``Selector`` provider is called ``selector``. It can be an option of
+a ``Configuration`` provider or any other callable. The ``selector`` callable has to return a
+string value. This value is used as a key for selecting the provider.
+
+The providers are provided as keyword arguments. Argument name is used as a key for selecting the
+provider.
+
+When a ``Selector`` provider is called, it gets a ``selector`` value and delegates the work to
+the provider with a matching name. The ``selector`` callable works as a switch: when the returned
+value is changed the ``Selector`` provider will delegate the work to another provider.
 
 .. disqus::
diff --git a/examples/providers/callable.py b/examples/providers/callable.py
new file mode 100644
index 00000000..40e0d363
--- /dev/null
+++ b/examples/providers/callable.py
@@ -0,0 +1,18 @@
+"""`Callable` provider example."""
+
+import passlib.hash
+
+from dependency_injector import providers
+
+
+password_hasher = providers.Callable(
+    passlib.hash.sha256_crypt.hash,
+    salt_size=16,
+    rounds=10000,
+)
+password_verifier = providers.Callable(passlib.hash.sha256_crypt.verify)
+
+
+if __name__ == '__main__':
+    hashed_password = password_hasher('super secret')
+    assert password_verifier('super secret', hashed_password)
diff --git a/examples/providers/callable_args.py b/examples/providers/callable_args.py
deleted file mode 100644
index a4292de4..00000000
--- a/examples/providers/callable_args.py
+++ /dev/null
@@ -1,16 +0,0 @@
-"""`Callable` providers with positional arguments example."""
-
-import dependency_injector.providers as providers
-
-
-# Creating even and odd filter providers:
-even_filter = providers.Callable(filter, lambda x: x % 2 == 0)
-odd_filter = providers.Callable(filter, lambda x: x % 2 != 0)
-
-# Creating even and odd ranges using range() and filter providers:
-even_range = even_filter(range(1, 10))
-odd_range = odd_filter(range(1, 10))
-
-# Making some asserts:
-assert even_range == [2, 4, 6, 8]
-assert odd_range == [1, 3, 5, 7, 9]
diff --git a/examples/providers/callable_kwargs.py b/examples/providers/callable_kwargs.py
deleted file mode 100644
index a6b89990..00000000
--- a/examples/providers/callable_kwargs.py
+++ /dev/null
@@ -1,16 +0,0 @@
-"""`Callable` providers with keyword arguments example."""
-
-import passlib.hash
-
-import dependency_injector.providers as providers
-
-
-# Password hasher and verifier providers:
-password_hasher = providers.Callable(passlib.hash.sha256_crypt.encrypt,
-                                     salt_size=16,
-                                     rounds=10000)
-password_verifier = providers.Callable(passlib.hash.sha256_crypt.verify)
-
-# Making some asserts:
-hashed_password = password_hasher('super secret')
-assert password_verifier('super secret', hashed_password)
diff --git a/examples/providers/coroutine.py b/examples/providers/coroutine.py
index 054173ca..98767295 100644
--- a/examples/providers/coroutine.py
+++ b/examples/providers/coroutine.py
@@ -1,26 +1,19 @@
-"""`Coroutine` providers example with @asyncio.coroutine decorator.
-
-Current example works only fot Python 3.4+.
-"""
+"""`Coroutine` providers example with async / await syntax."""
 
 import asyncio
 
-import dependency_injector.providers as providers
+from dependency_injector import providers
 
 
-@asyncio.coroutine
-def coroutine_function(arg1, arg2):
-    """Sample coroutine function."""
-    yield from asyncio.sleep(0.1)
+async def coroutine(arg1, arg2):
+    await asyncio.sleep(0.1)
     return arg1, arg2
 
 
-coroutine_provider = providers.Coroutine(coroutine_function, arg1=1, arg2=2)
+coroutine_provider = providers.Coroutine(coroutine, arg1=1, arg2=2)
 
 
 if __name__ == '__main__':
-    loop = asyncio.get_event_loop()
-    arg1, arg2 = loop.run_until_complete(coroutine_provider())
-
+    arg1, arg2 = asyncio.run(coroutine_provider())
     assert (arg1, arg2) == (1, 2)
     assert asyncio.iscoroutinefunction(coroutine_provider)
diff --git a/examples/providers/coroutine_async_await.py b/examples/providers/coroutine_async_await.py
deleted file mode 100644
index cca13c26..00000000
--- a/examples/providers/coroutine_async_await.py
+++ /dev/null
@@ -1,25 +0,0 @@
-"""`Coroutine` providers example with async / await syntax.
-
-Current example works only fot Python 3.5+.
-"""
-
-import asyncio
-
-import dependency_injector.providers as providers
-
-
-async def coroutine_function(arg1, arg2):
-    """Sample coroutine function."""
-    await asyncio.sleep(0.1)
-    return arg1, arg2
-
-
-coroutine_provider = providers.Coroutine(coroutine_function, arg1=1, arg2=2)
-
-
-if __name__ == '__main__':
-    loop = asyncio.get_event_loop()
-    arg1, arg2 = loop.run_until_complete(coroutine_provider())
-
-    assert (arg1, arg2) == (1, 2)
-    assert asyncio.iscoroutinefunction(coroutine_provider)
diff --git a/examples/providers/dependency.py b/examples/providers/dependency.py
index a96aa58d..a1114cba 100644
--- a/examples/providers/dependency.py
+++ b/examples/providers/dependency.py
@@ -1,73 +1,50 @@
-"""`Dependency` providers example."""
+"""`Dependency` provider example."""
 
-import sqlite3
-import contextlib
+import abc
+import dataclasses
 
-import dependency_injector.providers as providers
+from dependency_injector import containers, providers, errors
 
 
-class UsersService:
-    """Example class UsersService.
-
-    UsersService has dependency on DBAPI 2.0 database connection.
-    """
-
-    def __init__(self, database):
-        """Initialize instance.
-
-        :param database: Database connection.
-        :type database: sqlite3.dbapi2.Connection
-        """
-        self.database = database
-        self.database.row_factory = sqlite3.dbapi2.Row
-
-    def init_database(self):
-        """Initialize database, if it has not been initialized yet."""
-        with contextlib.closing(self.database.cursor()) as cursor:
-            cursor.execute("""
-              CREATE TABLE IF NOT EXISTS users(
-                id INTEGER PRIMARY KEY AUTOINCREMENT,
-                name VARCHAR(32)
-              )
-            """)
-
-    def create(self, name):
-        """Create user with provided name and return his id."""
-        with contextlib.closing(self.database.cursor()) as cursor:
-            cursor.execute('INSERT INTO users(name) VALUES (?)', (name,))
-            return cursor.lastrowid
-
-    def get_by_id(self, id):
-        """Return user info by user id."""
-        with contextlib.closing(self.database.cursor()) as cursor:
-            cursor.execute('SELECT id, name FROM users WHERE id=?', (id,))
-            return cursor.fetchone()
+class DbAdapter(metaclass=abc.ABCMeta):
+    ...
 
 
-# Database and UsersService providers:
-database = providers.Dependency(instance_of=sqlite3.dbapi2.Connection)
-users_service_factory = providers.Factory(UsersService,
-                                          database=database)
+class SqliteDbAdapter(DbAdapter):
+    ...
 
-# Out of library's scope.
-#
-# Setting database provider:
-database.provided_by(providers.Singleton(sqlite3.dbapi2.Connection,
-                                         database=':memory:',
-                                         timeout=30,
-                                         detect_types=True,
-                                         isolation_level='EXCLUSIVE'))
 
-# Creating UsersService instance:
-users_service = users_service_factory()
+class PostgresDbAdapter(DbAdapter):
+    ...
 
-# Initializing UsersService database:
-users_service.init_database()
 
-# Creating test user and retrieving full information about him:
-test_user_id = users_service.create(name='test_user')
-test_user = users_service.get_by_id(test_user_id)
+@dataclasses.dataclass
+class UserService:
+    database: DbAdapter
 
-# Making some asserts:
-assert test_user['id'] == 1
-assert test_user['name'] == 'test_user'
+
+class Container(containers.DeclarativeContainer):
+
+    database = providers.Dependency(instance_of=DbAdapter)
+
+    user_service = providers.Factory(
+        UserService,
+        database=database,
+    )
+
+
+if __name__ == '__main__':
+    container1 = Container(database=providers.Singleton(SqliteDbAdapter))
+    container2 = Container(database=providers.Singleton(PostgresDbAdapter))
+
+    assert isinstance(container1.user_service().database, SqliteDbAdapter)
+    assert isinstance(container2.user_service().database, PostgresDbAdapter)
+
+    container3 = Container(database=providers.Singleton(object))
+    try:
+        container3.user_service()
+    except errors.Error as exception:
+        print(exception)
+        # The output is:
+        # <object object at 0x107ce5c40> is not an
+        # instance of <class '__main__.DbAdapter'>
diff --git a/examples/providers/list.py b/examples/providers/list.py
index cbf33bd6..1d2eb474 100644
--- a/examples/providers/list.py
+++ b/examples/providers/list.py
@@ -8,15 +8,11 @@ from dependency_injector import providers
 
 @dataclasses.dataclass
 class Module:
-    """Example module."""
-
     name: str
 
 
 @dataclasses.dataclass
 class Dispatcher:
-    """Example dispatcher."""
-
     modules: List[Module]
 
 
@@ -28,6 +24,7 @@ dispatcher_factory = providers.Factory(
     ),
 )
 
+
 if __name__ == '__main__':
     dispatcher = dispatcher_factory()
 
@@ -35,11 +32,10 @@ if __name__ == '__main__':
     assert dispatcher.modules[0].name == 'm1'
     assert dispatcher.modules[1].name == 'm2'
 
-    # Call of dispatcher_factory() is equivalent to:
-
-    dispatcher = Dispatcher(
-        modules=[
-            Module(name='m1'),
-            Module(name='m2'),
-        ],
-    )
+    # Call "dispatcher = dispatcher_factory()" is an equivalent for:
+    # dispatcher = Dispatcher(
+    #     modules=[
+    #         Module(name='m1'),
+    #         Module(name='m2'),
+    #     ],
+    # )
diff --git a/examples/providers/object.py b/examples/providers/object.py
index f3fa6693..7da9cb26 100644
--- a/examples/providers/object.py
+++ b/examples/providers/object.py
@@ -1,10 +1,10 @@
-"""Object providers example."""
+"""`Object` provider example."""
 
-import dependency_injector.providers as providers
+from dependency_injector import providers
 
 
-# Creating object provider:
 object_provider = providers.Object(1)
 
-# Making some asserts:
-assert object_provider() == 1
+
+if __name__ == '__main__':
+    assert object_provider() == 1
diff --git a/examples/providers/selector.py b/examples/providers/selector.py
index 9c3036bc..7c7c17cd 100644
--- a/examples/providers/selector.py
+++ b/examples/providers/selector.py
@@ -19,10 +19,11 @@ selector = providers.Selector(
     another=providers.Factory(SomeOtherClass),
 )
 
-config.override({'one_or_another': 'one'})
-instance_1 = selector()
-assert isinstance(instance_1, SomeClass)
+if __name__ == '__main__':
+    config.override({'one_or_another': 'one'})
+    instance_1 = selector()
+    assert isinstance(instance_1, SomeClass)
 
-config.override({'one_or_another': 'another'})
-instance_2 = selector()
-assert isinstance(instance_2, SomeOtherClass)
+    config.override({'one_or_another': 'another'})
+    instance_2 = selector()
+    assert isinstance(instance_2, SomeOtherClass)
diff --git a/src/dependency_injector/containers.pyi b/src/dependency_injector/containers.pyi
index 9c2798fb..62117b43 100644
--- a/src/dependency_injector/containers.pyi
+++ b/src/dependency_injector/containers.pyi
@@ -24,6 +24,7 @@ class DynamicContainer(Container): ...
 class DeclarativeContainer(Container):
     cls_providers: ClassVar[Dict[str, Provider]]
     inherited_providers: ClassVar[Dict[str, Provider]]
+    def __init__(self, **overriding_providers: Provider) -> None: ...
 
 
 def override(container: Container) -> _Callable[[Container], Container]: ...