From 7bdf57da9cae005d7a74bd9b62b207b9e2f40f49 Mon Sep 17 00:00:00 2001 From: Roman Mogylatov Date: Wed, 19 Aug 2020 21:05:14 -0400 Subject: [PATCH] Update index page --- docs/providers/index.rst | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/providers/index.rst b/docs/providers/index.rst index 15e2eccb..f2a0160b 100644 --- a/docs/providers/index.rst +++ b/docs/providers/index.rst @@ -3,16 +3,16 @@ Providers ========= -Providers are strategies of accessing objects. They define how particular -objects are provided. +Providers help you to define how objects are created. They manage objects lifetime and their +dependencies. -Every provider is callable (implements ``__call__()``). Every call to provider -instance returns provided result, according to the providing strategy of -particular provider. +Each provider is a callable. You call the provider like a function when you need to create an +object or call a function. Provider calls all dependent providers to retrieve the dependencies +and injects them. -Current documentation section consists from description of standard providers -library and some useful information like overriding of providers and writing -of custom providers. +Any of the providers can be overridden by another provider. When provider is overridden it calls +to the overriding provider. This helps in testing or overriding API clients with stubs for dev or +stage environment. Providers package API docs - :py:mod:`dependency_injector.providers`