Skip to main content

A modern component / dependency injector for python 3.6+.

Project description


A modern component / dependency injector for python 3.6+.

This library provides a framework-agnostic component (or dependency) injector that injects registered components into your function calls. The components to insert are identified by looking at the called function argument annotations.

When registering a component, all its base classes are registered as well unless you explicitly disable that. You can also choose to only register base classes that are not already registered with the injector.

It provides local scopes where you can register additional components or override existing components. After exiting the scope, the registry will return to the state it was in before entering the scope.


component-injector is compatible with python 3.6+ using the backported contextvars and dataclasses packages.

The scopes are thread-safe and when using python 3.7 also safe for for use with asyncio tasks.


component-injector is available from pypi:

pip install component-injector

Usage example

Here's a small demo on how to use the injector:

from component_injector import Injector

injector = Injector()

class O:

def consumer_of_o(o: O) -> None:

consumer_of_o()  # 'o' wil be the registered instance.

consumer_of_o(O())  # 'o' will be this new instance.

For more examples and usage, please refer to and

Development setup

For development purposes, you can clone the repository and use poetry to install and maintain the dependencies. There is no test suite. The project comes with a set of pre-commit hooks that can format (isort, black) and check your code (mypy, flake8) automatically.

git clone
cd component-injector
poetry run pre-commit install

Release History

  • 1.1.1

    • Fix incorrect type registration when not registering bases.
    • Fix typo in documentation (thanks @trbs!).
  • 1.1.0

    • Add documentation.
    • Add support for component factories. Asynchronous factories are supported as well when injecting into asynchronous functions.
  • 1.0.2

    • Fix bug where already bound arguments were overwritten.
  • 1.0.1

    • Fix links to examples.
  • 1.0.0

    • Initial Release.


Ingmar Steen – @iksteen

Distributed under the MIT license. See LICENSE for more information.


  1. Fork it (
  2. Create your feature branch (git checkout -b feature/fooBar)
  3. Commit your changes (git commit -am 'Add some fooBar')
  4. Push to the branch (git push origin feature/fooBar)
  5. Create a new Pull Request

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

component-injector-1.1.1.tar.gz (5.5 kB view hashes)

Uploaded source

Built Distribution

component_injector-1.1.1-py3-none-any.whl (14.3 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page