python-dependency-injector/docs/advanced_usage/index.rst

Advanced usage
==============

Current section of documentation describes advanced usage of 
*Dependency Injector*.

@inject decorator
-----------------

``@di.inject`` decorator can be used for making *inline* dependency injections.
It *patches* decorated callable in such way that dependency injection will be
done during every call of decorated callable.

``@di.inject`` decorator takes keyword argument, that will be injected during 
every next call of decorated callback with the same name. Any Python object 
will be injected *as is*, except ``di.Provider``'s, which will be called to 
provide injectable values.

Example:

.. literalinclude:: ../../examples/advanced_usage/inject_decorator_simple.py
   :language: python

Example of usage ``@di.inject`` decorator with Flask:

.. literalinclude:: ../../examples/advanced_usage/inject_decorator_flask.py
   :language: python