aiodine 1.2.7

艾奥丁

aiodine以python 3.6+的pytest fixtures的方式，首先提供异步依赖注入。

• 安装
• 概念
• 用法
• 常见问题
• 更改日志

安装

pip install aiodine

概念

艾奥丁围绕两个概念展开：

• 提供者负责设置、返回和选择性地清理资源
• 消费者可以通过将提供者声明为其参数之一来访问这些资源。

这种方法是依赖注入的实现，使得提供者和消费者：

• 显式：根据消费者签名上的名称引用提供者，使依赖关系清晰且可预测。
• 模块化：提供者本身可以使用其他提供者，允许构建可重用（和可替换）依赖关系的生态系统。
• 灵活：提供的值在给定的范围内重用，提供者和使用者支持各种语法（异步/同步、函数/生成器）以使资源调配再次变得有趣。

aiodine首先是异步的

• 它是用来处理协同程序函数和异步/等待语法的。
• 只能在异步设置中调用使用者。
• 但是提供者和使用者函数也可以是常规的python函数和生成器，如果只是为了方便的话。

用法

提供者

提供者在特定范围内为消费者提供资源。它们是通过用@aiodine.provider

这里有一个"Hello World"提供商：

importaiodine@aiodine.providerasyncdefhello():return"Hello, aiodine!"

提供程序有两个作用域：

• 函数：提供程序的值在每次使用时都会重新计算。
• 会话：提供者的值只计算一次（第一次使用时），并在随后的调用中重复使用。

默认情况下，提供者是功能范围的。

消费者

一旦声明了提供者，它就可以被消费者使用。consumer是通过用@aiodine.consumer装饰一个consumer函数来构建的。使用者可以将提供者声明为其参数之一，并且aiodine将在运行时注入它。

下面是一个消费者示例：

@aiodine.consumerasyncdefshow_friendly_message(hello):print(hello)

所有aiodine使用者都是异步的，因此您需要在异步上下文中运行它们：

fromasyncioimportrunasyncdefmain():awaitshow_friendly_message()run(main())# "Hello, aiodine!"

当然，使用者也可以声明非提供者参数。aiodine足够聪明，能够确定哪些参数应该通过提供者注入，哪些应该从被调用方获得。

@aiodine.consumerasyncdefshow_friendly_message(hello,repeat=1):for_inrange(repeat):print(hello)asyncdefmain():awaitshow_friendly_message(repeat=10)

使用其他提供商的提供商

提供商是模块化的，因为他们自己可以使用其他提供商。

但是，要使其正常工作，必须首先冻结提供者。这可确保无论申报顺序如何，依赖关系图都能正确解析。

importaiodine@aiodine.providerdefemail():return"user@example.net"@aiodine.providerasyncdefsend_email(email):print(f"Sending email to {email}…")aiodine.freeze()# <- Ensures that `send_email` has resolved `email`.

注意：可以安全地多次调用.freeze（）。

上下文管理器语法也可用：

importaiodinewithaiodine.exit_freeze():@aiodine.providerdefemail():return"user@example.net"@aiodine.providerasyncdefsend_email(email):print(f"Sending email to {email}…")

发电机供应商

生成器提供程序可用于在提供程序超出范围后执行清理（终结）操作。

importosimportaiodine@aiodine.providerasyncdefcomplex_resource():print("setting up complex resource…")yield"complex"print("cleaning up complex resource…")

提示：即使使用者中发生异常，也会执行清除代码，因此无需用try/finally块包围yield语句。

重要信息：只有在会话上下文中使用会话范围的生成器提供程序时，才会清除它们。有关详细信息，请参见会话。

延迟异步提供程序

默认情况下，异步提供程序是急切的：它们的返回值在注入到使用者之前等待。

您可以将提供程序标记为懒惰，以便推迟等待提供给消费者的值。这在需要有条件地评估提供者时非常有用。

fromasyncioimportsleepimportaiodine@aiodine.provider(lazy=True)asyncdefexpensive_io_call():awaitsleep(10)return42@aiodine.consumerasyncdefcompute(expensive_io_call,cache=None):ifcache:returncachereturnawaitexpensive_io_call

工厂供应商

工厂提供程序返回一个函数，而不是返回一个标量值。工厂提供程序有助于实现可重用的提供程序，以接受各种输入。

pip install aiodine

pip install aiodine

pip install aiodine

pip install aiodine

pip install aiodine

pip install aiodine

pip install aiodine

pip install aiodine

pip install aiodine

pip install aiodine

importaiodine@aiodine.providerasyncdefhello():return"Hello, aiodine!"

importaiodine@aiodine.providerasyncdefhello():return"Hello, aiodine!"

importaiodine@aiodine.providerasyncdefhello():return"Hello, aiodine!"