ets-labs · rmk135 · Jun 14, 2020 · Jun 13, 2020 · Jun 13, 2020 · Jun 13, 2020
diff --git a/docs/main/changelog.rst b/docs/main/changelog.rst
@@ -10,6 +10,9 @@ follows `Semantic versioning`_
 Development version
 -------------------
 
+- Add ``List`` provider
+  `issue #243 <https://github.com/ets-labs/python-dependency-injector/issues/243>`_,
+  `PR #251 <https://github.com/ets-labs/python-dependency-injector/pull/251>`_.
 - Fix a few typos in docs (thanks to `Bruno P. Kinoshita <https://github.com/kinow>`_,
   `issue #249 <https://github.com/ets-labs/python-dependency-injector/issues/249>`_,
   `PR #250 <https://github.com/ets-labs/python-dependency-injector/pull/250>`_).

diff --git a/docs/providers/index.rst b/docs/providers/index.rst
@@ -22,6 +22,7 @@ Providers package API docs - :py:mod:`dependency_injector.providers`
     callable
     coroutine
     object
+    list
     dependency
     overriding
     custom
diff --git a/docs/providers/list.rst b/docs/providers/list.rst
@@ -0,0 +1,34 @@
+List providers
+--------------
+
+.. currentmodule:: dependency_injector.providers
+
+:py:class:`List` provider provides a list of values.
+
+.. literalinclude:: ../../examples/providers/list.py
+   :language: python
+   :lines: 23-29
+   :linenos:
+
+: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-29
+   :linenos:
+
+.. note::
+
+    Keyword argument injections are not supported.
+
+.. disqus::
diff --git a/examples/providers/list.py b/examples/providers/list.py
@@ -0,0 +1,45 @@
+"""`List` provider example."""
+
+import dataclasses
+from typing import List
+
+from dependency_injector import providers
+
+
+@dataclasses.dataclass
+class Module:
+    """Example module."""
+
+    name: str
+
+
+@dataclasses.dataclass
+class Dispatcher:
+    """Example dispatcher."""
+
+    modules: List[Module]
+
+
+dispatcher_factory = providers.Factory(
+    Dispatcher,
+    modules=providers.List(
+        providers.Factory(Module, name='m1'),
+        providers.Factory(Module, name='m2'),
+    ),
+)
+
+if __name__ == '__main__':
+    dispatcher = dispatcher_factory()
+
+    assert isinstance(dispatcher.modules, list)
+    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'),
+        ],
+    )