Python依赖注入框架——Dependency Injector

Python依赖注入框架——Dependency Injector

python-dependency-injector Dependency injection framework for Python 项目地址: https://gitcode.com/gh_mirrors/py/python-dependency-injector

1. 项目介绍

Dependency Injector 是一个为 Python 设计的依赖注入框架。它可以帮助开发者实施依赖注入原则，以降低代码间的耦合度和提高内聚性。框架提供了一系列功能，包括不同的提供者（Providers）用于组装对象，支持配置文件读取，资源初始化，容器（Containers）定义，以及依赖注入到函数和方法的特性。它还支持异步注入，类型标注，并且性能优越，成熟且适合生产环境使用。

2. 项目快速启动

首先，您需要安装 Dependency Injector。可以通过 PyPi 进行安装：

pip install dependency-injector

接下来，创建一个包含配置和依赖的容器：

from dependency_injector import containers, providers

class Container(containers.DeclarativeContainer):
    config = providers.Configuration()
    
    api_client = providers.Singleton(ApiClient, api_key=config.api_key, timeout=config.timeout)
    service = providers.Factory(Service, api_client=api_client)

在容器中配置环境变量：

container = Container()
container.config.api_key.from_env("API_KEY", required=True)
container.config.timeout.from_env("TIMEOUT", as_=int, default=5)

然后，使用 wire 方法将依赖注入到模块中：

@inject
def main(service: Service = Provide[Container.service]):
    ...

if __name__ == "__main__":
    main()

在测试时，可以覆盖依赖：

with container.api_client.override(Mock()):
    main()

3. 应用案例和最佳实践

以下是一些使用 Dependency Injector 的应用案例和最佳实践：

• 单容器应用示例
• 多容器应用示例
• 解耦包示例（使用多个容器）
• Boto3 集成示例
• Django 集成示例
• Flask 集成示例
• Aiohttp 集成示例
• Sanic 集成示例
• FastAPI 集成示例
• FastAPI + Redis 集成示例
• FastAPI + SQLAlchemy 集成示例

4. 典型生态项目

Dependency Injector 框架可以与多个 Python 生态项目集成，以下是一些典型的生态项目：

• Flask: 用于构建 Web 应用的微框架。
• Django: 一个高级的 Python Web 框架。
• Aiohttp: 一个异步的 HTTP 客户端/服务端框架。
• FastAPI: 一个现代、快速（高性能）的 Web 框架，用于构建 API。
• SQLAlchemy: Python SQL 工具包和对象关系映射（ORM）。

通过上述介绍，您可以对 Dependency Injector 有了基本的了解，并能够快速开始您的项目。更多的使用细节和进阶内容，可以参考官方文档和教程。

python-dependency-injector Dependency injection framework for Python 项目地址: https://gitcode.com/gh_mirrors/py/python-dependency-injector