Dependency Injector is a dependency injection framework for Python.
Dependency Injector helps you understand and change the structure of the application.
With the Dependency Injector you keep application structure in one place.
This place is called the container. You use the container to manage all the components of the
application. All the component dependencies are defined explicitly. This provides the control on
the application structure. It is easy to understand and change it.
The container is like a map of your application. You always know what depends on what.
Flask + Dependency Injector example application container:
from dependency_injector import containers, providers
from dependency_injector.ext import flask
from flask import Flask
from flask_bootstrap import Bootstrap
from github import Github
from . import views, services
class ApplicationContainer(containers.DeclarativeContainer):
"""Application container."""
app = flask.Application(Flask, __name__)
bootstrap = flask.Extension(Bootstrap)
config = providers.Configuration()
github_client = providers.Factory(
Github,
login_or_token=config.github.auth_token,
timeout=config.github.request_timeout,
)
search_service = providers.Factory(
services.SearchService,
github_client=github_client,
)
index_view = flask.View(
views.index,
search_service=search_service,
default_query=config.search.default_query,
default_limit=config.search.default_limit,
)Running such container looks like this:
from .containers import ApplicationContainer
def create_app():
"""Create and return Flask application."""
container = ApplicationContainer()
container.config.from_yaml('config.yml')
container.config.github.auth_token.from_env('GITHUB_TOKEN')
app = container.app()
app.container = container
bootstrap = container.bootstrap()
bootstrap.init_app(app)
app.add_url_rule('/', view_func=container.index_view.as_view())
return appAnd testing looks like:
from unittest import mock
import pytest
from github import Github
from flask import url_for
from .application import create_app
@pytest.fixture
def app():
return create_app()
def test_index(client, app):
github_client_mock = mock.Mock(spec=Github)
# Configure mock
with app.container.github_client.override(github_client_mock):
response = client.get(url_for('index'))
assert response.status_code == 200
# Do more assertsSee complete example here - Flask + Dependency Injector Example
The package is available on the PyPi:
pip install dependency-injector
- The documentation is available on the Read The Docs
- Open a Github Issue
- Open a Github Issue
- ⭐️ Star the
Dependency Injectoron the Github - 🆕 Start a new project with the
Dependency Injector - 💬 Tell your friend about the
Dependency Injector
- 🔀 Fork the project
- ⬅️ Open a pull request to the
developbranch