From f8648adaf7bf482ff84e02a2c6817bfcf6c335e6 Mon Sep 17 00:00:00 2001 From: Roman Mogylatov Date: Wed, 2 Sep 2020 16:59:25 -0400 Subject: [PATCH 01/11] Update providers overriding documentation and rework examples --- docs/images/providers/provider_override.png | Bin 10550 -> 0 bytes docs/main/changelog.rst | 4 + docs/providers/images/overriding.png | Bin 0 -> 13239 bytes docs/providers/overriding.rst | 56 +++++------ examples/providers/overriding.py | 42 ++++++++ examples/providers/overriding_simple.py | 36 ------- examples/providers/overriding_users_model.py | 95 ------------------- 7 files changed, 71 insertions(+), 162 deletions(-) delete mode 100644 docs/images/providers/provider_override.png create mode 100644 docs/providers/images/overriding.png create mode 100644 examples/providers/overriding.py delete mode 100644 examples/providers/overriding_simple.py delete mode 100644 examples/providers/overriding_users_model.py diff --git a/docs/images/providers/provider_override.png b/docs/images/providers/provider_override.png deleted file mode 100644 index 00549da87f7d3de36f85eed4a855931dbf55cfda..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 10550 zcmcI}1yEewwk8BZupbBzXo3U_60C8D;Ly+zoW?u2y9TF$K#)KqjVEYucS{-z&_K}O zB)A3-Y4r6!b8BYa)O%I;PTe_mPVKYzT5H?c-;%RpUumlRMfj8u3k&NnHC06&EUX7W z%tMEdgK1fnvnIn7xOQ@2IV`NYB%&MWLrfjpOGiZ>t9p!X7gJ%hQq=)tVFj{bVTHl4 zu&yvoVLMn@KA2wiEU~a85Lj5$?m6w+QW(PAD-AuR`}_OV)z$Fua7=@uq9Pm)-`m^c z<>iGyAiTT`O-=r*tErQd@o@NSFc^G&eSLplPE3rCxn^f)&(8}UJa}Mdr$|Odq^QVK zROG_P_pG78ucE@^`nnVVAd`{dgg_)28K2bF`t0rH6c@Yp^+mY4s)dIe93SWR_4O4O z7oVS>0{{S5SJ%nO$)=_z6beO2Nr{7l!^=V0l=o`2_w{6p+5M`=^`cu}g+cLqH3*m; z9wv7_ED8Iyx{4y!+lTb3 zm^UQ;SbHSovNWB$QWc*QE$pfQZ8z5U@)^z176?egl;D}-RX z*ts9BNzv%cr0l^rK*5MYs7fvP?cHfohfwq6GmK2ya3- z@FKtCsr)Nh?NF$9nkAs;}X|OT?v0 z(%ZWiJgYs6cV-Xp&qxAxp4!}@`9hhlXz_6jex9zZbgo==IpLql?3$XbKECA%jsjZR zEbtV#Tz-lG9%T_-5ko)knNG1|xVPi*kzq6Z2?!pGILx?NW3yV7OsH!-WLQ%e(2|Fd z*oX)pXZFE=uD-TFdUt%Mb=_5HSzH~Lj}B?Mu01#tY5V0%U)W*QaB-*(DDV-jn#vyE zqtbRe%snfQaxJEIa+=>Bcp8|U{>hAaaOc;YbMQ5J$&B$O{vjVnvmtb$%D`@Znx3Suy_!-a%NcNxTerE9Q(UCGq^&Vl(dR>dDkxUd)8*KMTxIi zr9QR%Mc){=5E+M`_`&)jE^*!j|BRt8aQ{V~L99VJ>JQs^~<_(IThUDft{w7~OI zv+<0t-u`-xPSp{#Sq5!>csH|jMZy@br)InDd3iQ6+l8J>kM&c$>>_cyqxa+grDlH= z(XJP~aTv-RcrY>;!*1UE+~!e|`LSVIY?8!DobJZ&6#m5O8taegki5JForZJpj&x6Q zk=LkGtH5&_k3Sbn@7@;?3Ph^YR_Ra96oR*#dpTDuhHwB<>dj%l7`&hOK07`wGI45F zN@-0IJ6nDxJmBnX;#CzYcNt8RX2v90tWIs);3`=!$h*g!^_}PX$TvjU@cSUGea19T z$zXHkPP!y&+0XlV*PHg%$%zrkm8AOaUlcV*@+m&lWpAhk4hYWfrH`7_Z&9mgwbT8( zx~ySM#O|ejWSZ!`{LSvyH8!oezsy=g7rVcseVJ97HBGO{0az=Q#JN_c$a|F046k z;2z|fT3&5&I#3(Cuo<@)mT&eHEKH)$TUgUrE6b3o-lqoh1!xEyPq@NpguSf8D;zm_ zsa$KS-!!NDZwNN?9+gS9yPd=v@SqBdR;treef;A8B6XS1{qAdGJ<&{u-8luO>E}-g zD-%Vlwssv{EV#)5<`bl;U`5;$NAm&S_EZQpCnvqwP{q?!h9XD#fzsx! K{C4*Wo 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 E2N{cq3;+NC diff --git a/docs/main/changelog.rst b/docs/main/changelog.rst index 2d5c5780..2170edba 100644 --- a/docs/main/changelog.rst +++ b/docs/main/changelog.rst @@ -7,6 +7,10 @@ that were made in every particular version. From version 0.7.6 *Dependency Injector* framework strictly follows `Semantic versioning`_ +Development version +------------------- +- Update providers overriding documentation and rework examples. + 3.35.1 ------ - Fix minor issues in the providers documentation and examples. diff --git a/docs/providers/images/overriding.png b/docs/providers/images/overriding.png new file mode 100644 index 0000000000000000000000000000000000000000..6400c70982e9115879c669d9d9777960a7693247 GIT binary patch literal 13239 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 e>ktrh?S^;MUw61qe#T!N)AF> Date: Wed, 2 Sep 2020 17:25:20 -0400 Subject: [PATCH 02/11] Add reference to provider overriding page --- docs/providers/index.rst | 2 +- docs/providers/overriding.rst | 2 ++ 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/providers/index.rst b/docs/providers/index.rst index bd5a4745..6e26779a 100644 --- a/docs/providers/index.rst +++ b/docs/providers/index.rst @@ -26,7 +26,7 @@ It causes the cascade effect that helps to assemble object graphs. Another providers feature is an overriding. Any of the providers can be overridden by another provider. When provider is overridden it calls to the overriding provider instead of providing the object by its own. This helps in testing. This also helps in overriding API clients with -stubs for the development or staging environment. +stubs for the development or staging environment. See the example at :ref:`provider-overriding`. Providers module API docs - :py:mod:`dependency_injector.providers` diff --git a/docs/providers/overriding.rst b/docs/providers/overriding.rst index f8a9d7ab..a8c4b006 100644 --- a/docs/providers/overriding.rst +++ b/docs/providers/overriding.rst @@ -1,3 +1,5 @@ +.. _provider-overriding: + Provider overriding =================== From e4ca1261888d678548c9195e02d976a443bab53f Mon Sep 17 00:00:00 2001 From: Roman Mogylatov Date: Wed, 2 Sep 2020 17:33:02 -0400 Subject: [PATCH 03/11] Update provider doc page headers --- docs/providers/callable.rst | 2 +- docs/providers/configuration.rst | 14 +++++++------- docs/providers/coroutine.rst | 2 +- docs/providers/dependency.rst | 2 +- docs/providers/factory.rst | 10 +++++----- docs/providers/list.rst | 2 +- docs/providers/object.rst | 2 +- docs/providers/provided_instance.rst | 2 +- docs/providers/selector.rst | 2 +- docs/providers/singleton.rst | 8 ++++---- 10 files changed, 23 insertions(+), 23 deletions(-) diff --git a/docs/providers/callable.rst b/docs/providers/callable.rst index e0cb5089..b9d72b8e 100644 --- a/docs/providers/callable.rst +++ b/docs/providers/callable.rst @@ -1,5 +1,5 @@ Callable provider ------------------ +================= .. meta:: :keywords: Python,DI,Dependency injection,IoC,Inversion of Control,Function,Method,Example diff --git a/docs/providers/configuration.rst b/docs/providers/configuration.rst index 43fd3ee3..9d049e18 100644 --- a/docs/providers/configuration.rst +++ b/docs/providers/configuration.rst @@ -1,5 +1,5 @@ Configuration provider ----------------------- +====================== .. meta:: :keywords: Python,DI,Dependency injection,IoC,Inversion of Control,Configuration,Injection, @@ -20,7 +20,7 @@ Configuration provider It implements the principle "use first, define later". Loading from an INI file -~~~~~~~~~~~~~~~~~~~~~~~~ +------------------------ ``Configuration`` provider can load configuration from an ``ini`` file using the :py:meth:`Configuration.from_ini` method: @@ -40,7 +40,7 @@ where ``examples/providers/configuration/config.ini`` is: variable ``ENV_NAME``. Loading from a YAML file -~~~~~~~~~~~~~~~~~~~~~~~~ +------------------------ ``Configuration`` provider can load configuration from a ``yaml`` file using the :py:meth:`Configuration.from_yaml` method: @@ -74,7 +74,7 @@ variable ``ENV_NAME``. *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: @@ -85,7 +85,7 @@ Loading from a dictionary :emphasize-lines: 6-13 Loading from an environment variable -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +------------------------------------ ``Configuration`` provider can load configuration from an environment variable using the :py:meth:`Configuration.from_env` method: @@ -96,7 +96,7 @@ Loading from an environment variable :emphasize-lines: 6-8 Loading from the multiple sources -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +--------------------------------- ``Configuration`` provider can load configuration from the multiple sources. Loaded configuration is merged recursively over the existing configuration. @@ -112,7 +112,7 @@ where ``examples/providers/configuration/config.local.yml`` is: :language: ini Specifying the value type -~~~~~~~~~~~~~~~~~~~~~~~~~ +------------------------- You can specify the type of the injected configuration value explicitly. diff --git a/docs/providers/coroutine.rst b/docs/providers/coroutine.rst index 3db7846a..6fac6c9e 100644 --- a/docs/providers/coroutine.rst +++ b/docs/providers/coroutine.rst @@ -1,5 +1,5 @@ Coroutine provider ------------------- +================== .. meta:: :keywords: Python,DI,Dependency injection,IoC,Inversion of Control,Coroutine,Asynchronous, diff --git a/docs/providers/dependency.rst b/docs/providers/dependency.rst index 9ce3977b..1246ceae 100644 --- a/docs/providers/dependency.rst +++ b/docs/providers/dependency.rst @@ -1,5 +1,5 @@ Dependency provider -------------------- +=================== .. currentmodule:: dependency_injector.providers diff --git a/docs/providers/factory.rst b/docs/providers/factory.rst index 23045591..626cda8c 100644 --- a/docs/providers/factory.rst +++ b/docs/providers/factory.rst @@ -41,7 +41,7 @@ injected following these rules: :lines: 3- Passing arguments to the underlying providers -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +--------------------------------------------- ``Factory`` provider can pass the arguments to the underlying providers. This helps when you need to assemble a nested objects graph and pass the arguments deep inside. @@ -88,7 +88,7 @@ If ```` is found the underlying provider will receive the .. _factory_providers_delegation: Passing providers to the objects -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +-------------------------------- When you need to inject the provider itself, but not the result of its call, use the ``.provider`` attribute of the provider that you're going to inject. @@ -105,7 +105,7 @@ attribute of the provider that you're going to inject. .. _factory-specialize-provided-type: Specializing the provided type -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +------------------------------ You can create a specialized ``Factory`` provider that provides only specific type. For doing this you need to create a subclass of the ``Factory`` provider and define the ``provided_type`` @@ -119,7 +119,7 @@ class attribute. .. _abstract-factory: Abstract factory -~~~~~~~~~~~~~~~~ +---------------- :py:class:`AbstractFactory` provider helps when you need to create a provider of some base class and the particular implementation is not yet know. ``AbstractFactory`` provider is a ``Factory`` @@ -138,7 +138,7 @@ provider with two peculiarities: :emphasize-lines: 32 Factory aggregate -~~~~~~~~~~~~~~~~~ +----------------- :py:class:`FactoryAggregate` provider aggregates multiple factories. When you call the ``FactoryAggregate`` it delegates the call to one of the factories. diff --git a/docs/providers/list.rst b/docs/providers/list.rst index 9ad4ece4..afd24a3d 100644 --- a/docs/providers/list.rst +++ b/docs/providers/list.rst @@ -1,5 +1,5 @@ List provider -------------- +============= .. meta:: :keywords: Python,DI,Dependency injection,IoC,Inversion of Control,List,Injection diff --git a/docs/providers/object.rst b/docs/providers/object.rst index 800b8116..61ad6ae1 100644 --- a/docs/providers/object.rst +++ b/docs/providers/object.rst @@ -1,5 +1,5 @@ Object provider ---------------- +=============== .. meta:: :keywords: Python,DI,Dependency injection,IoC,Inversion of Control,Object diff --git a/docs/providers/provided_instance.rst b/docs/providers/provided_instance.rst index 381557fe..f19fdddd 100644 --- a/docs/providers/provided_instance.rst +++ b/docs/providers/provided_instance.rst @@ -1,5 +1,5 @@ Injecting attributes, items, or call methods of the provided instance ---------------------------------------------------------------------- +===================================================================== .. currentmodule:: dependency_injector.providers diff --git a/docs/providers/selector.rst b/docs/providers/selector.rst index b3f372e0..6326e051 100644 --- a/docs/providers/selector.rst +++ b/docs/providers/selector.rst @@ -1,7 +1,7 @@ .. _selector-provider: Selector provider ------------------ +================= .. meta:: :keywords: Python,DI,Dependency injection,IoC,Inversion of Control,Configuration,Injection, diff --git a/docs/providers/singleton.rst b/docs/providers/singleton.rst index 10131e03..a3cc2d4d 100644 --- a/docs/providers/singleton.rst +++ b/docs/providers/singleton.rst @@ -1,5 +1,5 @@ Singleton provider ------------------- +================== .. meta:: :keywords: Python,DI,Dependency injection,IoC,Inversion of Control,Singleton,Pattern,Example, @@ -33,7 +33,7 @@ factories: - :ref:`abstract-factory` Resetting memorized object -~~~~~~~~~~~~~~~~~~~~~~~~~~ +-------------------------- To reset a memorized object you need to call the ``.reset()`` method of the ``Singleton`` provider. @@ -48,7 +48,7 @@ provider. managed by the garbage collector. Using singleton with multiple threads -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +------------------------------------- ``Singleton`` provider is NOT thread-safe. You need to explicitly establish a synchronization for using the ``Singleton`` provider in the multi-threading application. Otherwise you could trap @@ -67,7 +67,7 @@ There are two thread-safe singleton implementations out of the box: :emphasize-lines: 11,12 Implementing scopes -~~~~~~~~~~~~~~~~~~~ +------------------- To implement a scoped singleton provider use a ``Singleton`` provider and reset its scope when needed. From aeace8cba51d7f57bab3e8aaa155bf2c2cc4a0f8 Mon Sep 17 00:00:00 2001 From: Roman Mogylatov Date: Wed, 2 Sep 2020 17:59:31 -0400 Subject: [PATCH 04/11] Update documentation on injecting provided object attributes, items or method calls --- docs/main/changelog.rst | 1 + docs/providers/overriding.rst | 2 +- docs/providers/provided_instance.rst | 46 ++++++++----------- examples/providers/provided_instance.py | 1 + .../providers/provided_instance_complex.py | 1 + 5 files changed, 22 insertions(+), 29 deletions(-) diff --git a/docs/main/changelog.rst b/docs/main/changelog.rst index 2170edba..f9da42f0 100644 --- a/docs/main/changelog.rst +++ b/docs/main/changelog.rst @@ -10,6 +10,7 @@ follows `Semantic versioning`_ Development version ------------------- - Update providers overriding documentation and rework examples. +- Update documentation on injecting provided object attributes, items or method calls. 3.35.1 ------ diff --git a/docs/providers/overriding.rst b/docs/providers/overriding.rst index a8c4b006..23effd80 100644 --- a/docs/providers/overriding.rst +++ b/docs/providers/overriding.rst @@ -10,7 +10,7 @@ Provider overriding .. currentmodule:: dependency_injector.providers -Any provider can be overridden by another provider. +You can override any provider by another provider. When provider is overridden it calls to the overriding provider instead of providing the object by its own. diff --git a/docs/providers/provided_instance.rst b/docs/providers/provided_instance.rst index f19fdddd..cee70a9c 100644 --- a/docs/providers/provided_instance.rst +++ b/docs/providers/provided_instance.rst @@ -1,13 +1,14 @@ -Injecting attributes, items, or call methods of the provided instance -===================================================================== +Injecting provided object attributes, items, or call its methods +================================================================ + +.. meta:: + :keywords: Python,DI,Dependency injection,IoC,Inversion of Control,Attribute,Method,Call + :description: This page demonstrates how to inject attributes, items or call method of the + provided instance. .. currentmodule:: dependency_injector.providers -In this section you will know how to inject provided instance attribute or item into the other -provider. - -It also describes how to call a method of the provided instance and use the result of -this call as an injection value. +You can inject provided object attribute, item or result of its method call. .. literalinclude:: ../../examples/providers/provided_instance.py :language: python @@ -15,14 +16,14 @@ this call as an injection value. :lines: 3- To use the feature you should use the ``.provided`` attribute of the injected provider. This -attribute helps to specify what happens with the provided instance. You can retrieve an injection -value from: +attribute helps to specify what happens with the provided instance before the injection. You can +use any combination of the following: -- an attribute of the provided instance -- an item of the provided instance -- a call of the provided instance method +- an attribute of the provided object +- an item of the provided object +- a call of the provided object method -When you use the call of the provided instance method you can specify the injections into this +When you use a call of the provided instance method you can specify the injections for this method like you do with any other provider. You can do nested constructions: @@ -32,35 +33,24 @@ You can do nested constructions: :emphasize-lines: 24-30 :lines: 3- -Attribute ``.provided`` is available for the providers that return instances. Providers that -have ``.provided`` attribute: +The ``.provided`` attribute is available for the next providers: -- :py:class:`Callable` and its subclasses - :py:class:`Factory` and its subclasses - :py:class:`Singleton` and its subclasses +- :py:class:`Callable` and its subclasses - :py:class:`Object` - :py:class:`List` - :py:class:`Selector` - :py:class:`Dependency` -Special providers like :py:class:`Configuration` or :py:class:`Delegate` do not have the -``.provided`` attribute. - -Provider subclasses -------------------- - When you create a new provider subclass and want to implement the ``.provided`` attribute, you -should use the :py:class:`ProvidedInstance` provider. +should use the :py:class:`ProvidedInstance` provider. Add the ``.provided`` property +implementation to a new subclass: .. code-block:: python @property def provided(self): - """Return :py:class:`ProvidedInstance` provider.""" return ProvidedInstance(self) -In all other cases you should not use :py:class:`ProvidedInstance`, :py:class:`AttributeGetter`, -:py:class:`ItemGetter`, or :py:class:`MethodCaller` providers directly. Use the ``.provided`` -attribute of the injected provider instead. - .. disqus:: diff --git a/examples/providers/provided_instance.py b/examples/providers/provided_instance.py index 2e538120..e61f9bb7 100644 --- a/examples/providers/provided_instance.py +++ b/examples/providers/provided_instance.py @@ -33,6 +33,7 @@ client_factory = providers.Factory( value4=service.provided.get_value.call(), ) + if __name__ == '__main__': client = client_factory() assert client.value1 == client.value2 == client.value3 == 'foo' diff --git a/examples/providers/provided_instance_complex.py b/examples/providers/provided_instance_complex.py index 0e5ea107..20381f9b 100644 --- a/examples/providers/provided_instance_complex.py +++ b/examples/providers/provided_instance_complex.py @@ -31,6 +31,7 @@ demo_list = providers.List( dependency.provided['foo']['baz'].call(service)['arg'].get_value.call(), ) + if __name__ == '__main__': assert demo_list() == [ 10, From dd2ded732101bfd4c5aef34f790fafe15e160086 Mon Sep 17 00:00:00 2001 From: Roman Mogylatov Date: Wed, 2 Sep 2020 20:59:55 -0400 Subject: [PATCH 05/11] Update documentation and example on creating a custom provider --- docs/images/providers/abstract_factory.png | Bin 38000 -> 0 bytes docs/images/providers/custom_provider.png | Bin 37001 -> 0 bytes docs/images/providers/overriding_simple.png | Bin 17248 -> 0 bytes .../providers/overriding_users_model.png | Bin 32537 -> 0 bytes docs/main/changelog.rst | 1 + docs/providers/custom.rst | 56 ++++++++++-------- examples/providers/custom_factory.py | 54 +++++++++-------- src/dependency_injector/providers.pyi | 1 + 8 files changed, 62 insertions(+), 50 deletions(-) delete mode 100644 docs/images/providers/abstract_factory.png delete mode 100644 docs/images/providers/custom_provider.png delete mode 100644 docs/images/providers/overriding_simple.png delete mode 100644 docs/images/providers/overriding_users_model.png diff --git a/docs/images/providers/abstract_factory.png b/docs/images/providers/abstract_factory.png deleted file mode 100644 index ede202af7762d06f1f8e895bc1e114b198868865..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 38000 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 SWLGfHD=(vbx8TkLpZ^EuqZ!u# diff --git a/docs/images/providers/custom_provider.png b/docs/images/providers/custom_provider.png deleted file mode 100644 index 398e6bfa2c30ceb868ac01987b5db528c5196fdf..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 37001 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 diff --git a/docs/images/providers/overriding_users_model.png b/docs/images/providers/overriding_users_model.png deleted file mode 100644 index 16f3ff51452cfe507fc1b90860de90bc44c7eebe..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 32537 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 diff --git a/docs/main/changelog.rst b/docs/main/changelog.rst index f9da42f0..2e482c0e 100644 --- a/docs/main/changelog.rst +++ b/docs/main/changelog.rst @@ -11,6 +11,7 @@ Development version ------------------- - Update providers overriding documentation and rework examples. - Update documentation on injecting provided object attributes, items or method calls. +- Update documentation and example on creating a custom provider. 3.35.1 ------ diff --git a/docs/providers/custom.rst b/docs/providers/custom.rst index 237504c2..0d2ae08f 100644 --- a/docs/providers/custom.rst +++ b/docs/providers/custom.rst @@ -1,35 +1,43 @@ -Writing of custom providers ---------------------------- +Creating a custom providers +=========================== + +.. meta:: + :keywords: Python,DI,Dependency injection,IoC,Inversion of Control,Custom provider, Create + :description: This page demonstrates how to create a custom provider. .. currentmodule:: dependency_injector.providers -List of *Dependency Injector* providers could be widened with custom providers. +You can create a custom provider. -Below are some tips and recommendations that have to be met: +To create a custom provider you need to follow these rules: - 1. Every custom provider has to extend base provider class - - :py:class:`Provider`. - 2. Custom provider's ``__init__()`` could be overridden, but parent's - initializer (:py:meth:`Provider.__init__`) has to be called. - 3. Providing strategy has to be implemented in custom provider's - :py:meth:`Provider.__call__` method. - 4. If custom provider is based on some standard providers, it is better to - use delegation of standard providers, then extending of them. - 5. If custom provider defines any attributes, it is good to list them in - ``__slots__`` attribute (as *Dependency Injector* does). It can save - some memory. - 6. If custom provider deals with injections, it is strongly recommended - to be consistent with :py:class:`Factory`, :py:class:`Singleton` and - :py:class:`Callable` providers style. - -Example: - -.. image:: /images/providers/custom_provider.png - :width: 100% - :align: center +1. New provider class should inherit :py:class:`Provider`. +2. You need to implement the ``Provider._provide()`` method. +3. You need to implement the ``Provider.__deepcopy__()`` method. It should return an + equivalent copy of a provider. All providers must be copied with a ``deepcopy()`` function + from the ``providers`` module. After the a new provider object is created use + ``Provider._copy_overriding()`` method to copy all overriding providers. See the example + below. +4. If the new provider has a ``__init__()`` method, it should call the parent + ``Provider.__init__()``. .. literalinclude:: ../../examples/providers/custom_factory.py :language: python + :lines: 3- +.. note:: + 1. Prefer delegation over inheritance. If you choose between inheriting a ``Factory`` or + inheriting a ``Provider`` and use ``Factory`` internally - the last is better. + 2. When create a new provider follow the ``Factory``-like injections style. Consistency matters. + 3. Use the ``__slots__`` attribute to make sure nothing could be attached to your provider. You + will also save some memory. + +.. note:: + If you don't find needed provider in the ``providers`` module and experience troubles creating + one by your own - open a + `Github Issue `_. + + I'll help you to resolve the issue if that's possible. If the new provider can be useful for + others I'll include it into the ``providers`` module. .. disqus:: diff --git a/examples/providers/custom_factory.py b/examples/providers/custom_factory.py index 01c17425..706ed04c 100644 --- a/examples/providers/custom_factory.py +++ b/examples/providers/custom_factory.py @@ -1,40 +1,42 @@ -"""Custom `Factory` example.""" +"""Custom provider example.""" -import dependency_injector.providers as providers +from dependency_injector import providers -class User: - """Example class User.""" - - -class UsersFactory(providers.Provider): - """Example users factory.""" +class CustomFactory(providers.Provider): __slots__ = ('_factory',) - def __init__(self): - """Initialize instance.""" - self._factory = providers.Factory(User) + def __init__(self, provides, *args, **kwargs): + self._factory = providers.Factory(provides, *args, **kwargs) super().__init__() - def __call__(self, *args, **kwargs): - """Return provided object. + def __deepcopy__(self, memo): + copied = memo.get(id(self)) + if copied is not None: + return copied - Callable interface implementation. - """ - if self.last_overriding is not None: - return self.last_overriding._provide(args, kwargs) + copied = self.__class__( + self._factory.provides, + *providers.deepcopy(self._factory.args, memo), + **providers.deepcopy(self._factory.kwargs, memo), + ) + self._copy_overridings(copied, memo) + + return copied + + def _provide(self, args, kwargs): return self._factory(*args, **kwargs) -# Users factory: -users_factory = UsersFactory() +factory = CustomFactory(object) -# Creating several User objects: -user1 = users_factory() -user2 = users_factory() -# Making some asserts: -assert isinstance(user1, User) -assert isinstance(user2, User) -assert user1 is not user2 +if __name__ == '__main__': + object1 = factory() + assert isinstance(object1, object) + + object2 = factory() + assert isinstance(object1, object) + + assert object1 is not object2 diff --git a/src/dependency_injector/providers.pyi b/src/dependency_injector/providers.pyi index 0617e8f2..c8d97a70 100644 --- a/src/dependency_injector/providers.pyi +++ b/src/dependency_injector/providers.pyi @@ -43,6 +43,7 @@ class Provider(_Provider): def delegate(self) -> Provider: ... @property def provider(self) -> Provider: ... + def _copy_overridings(self, copied: Provider, memo: Optional[Dict[str, Any]]) -> None: ... class Object(Provider, Generic[T]): From c2426d2a09d4c984e7983e2713492f701ca6dea5 Mon Sep 17 00:00:00 2001 From: Roman Mogylatov Date: Wed, 2 Sep 2020 21:15:06 -0400 Subject: [PATCH 06/11] Update providers index page --- docs/providers/custom.rst | 2 ++ docs/providers/index.rst | 14 +++++++++----- docs/providers/provided_instance.rst | 2 ++ 3 files changed, 13 insertions(+), 5 deletions(-) diff --git a/docs/providers/custom.rst b/docs/providers/custom.rst index 0d2ae08f..088591cd 100644 --- a/docs/providers/custom.rst +++ b/docs/providers/custom.rst @@ -1,3 +1,5 @@ +.. _create-provider: + Creating a custom providers =========================== diff --git a/docs/providers/index.rst b/docs/providers/index.rst index 6e26779a..d2097593 100644 --- a/docs/providers/index.rst +++ b/docs/providers/index.rst @@ -7,7 +7,8 @@ Providers help to assemble the objects. They create objects and inject the depen Each provider is a callable. You call the provider like a function when you need to create an object. Provider retrieves the underlying dependencies and inject them into the created object. -It causes the cascade effect that helps to assemble object graphs. +It causes the cascade effect that helps to assemble object graphs. See ``Factory``, ``Singleton``, +``Callable`` and other provider docs below. .. code-block:: bash @@ -23,10 +24,13 @@ It causes the cascade effect that helps to assemble object graphs. │ └──> provider6() -Another providers feature is an overriding. Any of the providers can be overridden by another -provider. When provider is overridden it calls to the overriding provider instead of providing -the object by its own. This helps in testing. This also helps in overriding API clients with -stubs for the development or staging environment. See the example at :ref:`provider-overriding`. +Another providers feature is an overriding. You can override any provider by another provider. +This helps in testing. This also helps in overriding API clients with stubs for the development +or staging environment. See the example at :ref:`provider-overriding`. + +If you need to inject not the whole object but the parts see :ref:`provided-instance`. + +To create a new provider see :ref:`create-provider`. Providers module API docs - :py:mod:`dependency_injector.providers` diff --git a/docs/providers/provided_instance.rst b/docs/providers/provided_instance.rst index cee70a9c..a53035cf 100644 --- a/docs/providers/provided_instance.rst +++ b/docs/providers/provided_instance.rst @@ -1,3 +1,5 @@ +.. _provided-instance: + Injecting provided object attributes, items, or call its methods ================================================================ From 580a9a66b5556d466e8a6f6b500ef8ffa059f9c7 Mon Sep 17 00:00:00 2001 From: Roman Mogylatov Date: Wed, 2 Sep 2020 21:21:07 -0400 Subject: [PATCH 07/11] Fix a typo in the custom provider docs --- docs/providers/custom.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/providers/custom.rst b/docs/providers/custom.rst index 088591cd..45fbcd2c 100644 --- a/docs/providers/custom.rst +++ b/docs/providers/custom.rst @@ -1,7 +1,7 @@ .. _create-provider: -Creating a custom providers -=========================== +Creating a custom provider +========================== .. meta:: :keywords: Python,DI,Dependency injection,IoC,Inversion of Control,Custom provider, Create From e29bf348ea6a7c28cc535dab4da666e47a8e674a Mon Sep 17 00:00:00 2001 From: Roman Mogylatov Date: Wed, 2 Sep 2020 21:21:18 -0400 Subject: [PATCH 08/11] Rename the container overriding docs page --- docs/containers/overriding.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/containers/overriding.rst b/docs/containers/overriding.rst index cf5627af..3d1a7030 100644 --- a/docs/containers/overriding.rst +++ b/docs/containers/overriding.rst @@ -1,5 +1,5 @@ -Overriding of the container ---------------------------- +Container overriding +-------------------- .. currentmodule:: dependency_injector.containers From 6012d97a707df5228c1d43a605e05ca21fcdebec Mon Sep 17 00:00:00 2001 From: Roman Mogylatov Date: Wed, 2 Sep 2020 21:27:24 -0400 Subject: [PATCH 09/11] Remove not needed image from the docs --- docs/images/containers/bundles.png | Bin 301850 -> 0 bytes 1 file changed, 0 insertions(+), 0 deletions(-) delete mode 100644 docs/images/containers/bundles.png diff --git a/docs/images/containers/bundles.png b/docs/images/containers/bundles.png deleted file mode 100644 index f015088a212de67686c80ca5864bb3f82abaa859..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 301850 zcmeFZXH=9~&^5~FD2|LUsDKg`RFEhlNsQM@^F7=B|vP2mIo``zTa;&n2zoM4LG2Z!MGZ}xX(|0c_7X8Z{+&KTXg zt4K!Xa)FHO**|1t+wiMrQ)FZgm&nMb?~{>TjU*$ZvxzBD5r;Pp8_LVdkde@T@5)o& zz;FJrxus=KM#jsA{`~edNy-tvPIg=7`n{*PSpw#Xo^hJwTb_;4 z>&809VD0rjtk3lo^1(p&f4)~Sr0Ml@;)x%pNC;oeJM*3USe=o>RA8-EszgOR1{qL>z7vp~y@PEzXmnr;z zJXdL{j)y2sFc{3zasyv&IFHVVFMFJiEDPoeuCFg$kB5xxl&ynFBWk`Lw@9?0vSkw@0!{=lz^lCe%tf$;fPOnOj)}88?Ji!>!WvXnuY6nWvnH z{So-A;r8m!9NWXf%+KIH5x4}W0@B`NTDKg zc_$LE?r!<%;DOk(3Z0Z!S7(C^h|5k(x$zD)15VZf>+4L$9uwg@R=&y}+wCfR9*@9N zXO}ITjg$(P4Ij&KoWm9EE;pp>K`=o-�HY%ru5<7Ga0zeivY4Wp*BW^c9>a$FSZ) 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ລ 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%0DROU*PQZqH&PUhY&}4I1+XC+YVQYhix; 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 Date: Wed, 2 Sep 2020 21:27:44 -0400 Subject: [PATCH 10/11] Update copyright year in the docs --- docs/conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/conf.py b/docs/conf.py index f3638a1a..3d2cb7ad 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -52,7 +52,7 @@ master_doc = 'index' # General information about the project. project = u'Dependency Injector' -copyright = u'2017, ETS Labs' +copyright = u'2020, ETS Labs' author = u'ETS Labs' # The version info for the project you're documenting, acts as replacement for From 063301a0b32b6ef155c6f31bce64433cdb42430d Mon Sep 17 00:00:00 2001 From: Roman Mogylatov Date: Wed, 2 Sep 2020 21:28:09 -0400 Subject: [PATCH 11/11] Bump version to 3.36.0 --- docs/main/changelog.rst | 7 +++++-- src/dependency_injector/__init__.py | 2 +- 2 files changed, 6 insertions(+), 3 deletions(-) diff --git a/docs/main/changelog.rst b/docs/main/changelog.rst index 2e482c0e..498ab0e3 100644 --- a/docs/main/changelog.rst +++ b/docs/main/changelog.rst @@ -7,11 +7,14 @@ that were made in every particular version. From version 0.7.6 *Dependency Injector* framework strictly follows `Semantic versioning`_ -Development version -------------------- +3.36.0 +------ - Update providers overriding documentation and rework examples. - Update documentation on injecting provided object attributes, items or method calls. - Update documentation and example on creating a custom provider. +- Update providers index documentation page to give better overview of providers functionality. +- Fix mypy stub of the ``Provider`` to specify the protected ``._copy_overridings()`` method. +- Update copyright year in the documentation. 3.35.1 ------ diff --git a/src/dependency_injector/__init__.py b/src/dependency_injector/__init__.py index 724f9e1f..b1aa8bb1 100644 --- a/src/dependency_injector/__init__.py +++ b/src/dependency_injector/__init__.py @@ -1,6 +1,6 @@ """Dependency injector top-level package.""" -__version__ = '3.35.1' +__version__ = '3.36.0' """Version number that follows semantic versioning. :type: str