tinyio：仅400行代码的轻量级Python事件循环，彻底告别asyncio的复杂性

【免费下载链接】tinyio Ever used asyncio and wished you hadn't? A tiny (~400 lines) event loop for Python. 项目地址: https://gitcode.com/gh_mirrors/tin/tinyio

tinyio 是一个仅400行代码的轻量级Python事件循环，专为简化异步编程而设计。如果你曾在使用asyncio时感到困惑或受挫，这个极简工具将为你提供清晰、高效的替代方案，让异步编程变得简单直观。

🚀 为什么选择tinyio？告别asyncio的复杂性

asyncio作为Python官方异步框架，功能强大但也以复杂著称。许多开发者在面对其庞大的API和隐晦的错误处理机制时感到头疼。而tinyio则秉持"少即是多"的理念：

• 极致精简：核心代码仅400行，源码可读性极强，让你轻松理解事件循环的工作原理
• 错误处理透明：一个协程出错时会取消整个事件循环，确保资源正确清理
• 无冗余设计：专注于事件循环的核心功能，去除不必要的抽象层

正如项目描述中所说："Ever used asyncio and wished you hadn't? A tiny (~400 lines) event loop for Python."（使用过asyncio并后悔过吗？试试这个仅400行的Python事件循环）

⚡ 核心优势：轻量级事件循环的强大能力

1. 简单直观的设计理念

tinyio的设计哲学是做减法。它专注于解决最常见的异步编程需求，避免了asyncio的过度设计：

这是针对简单用例的替代方案，当你只需要一个事件循环，并且希望在出现任何问题时能够让整个程序崩溃（在每个协程中引发异常以便清理资源）。

这种设计使得tinyio的学习曲线极低，即使是Python新手也能快速掌握异步编程的核心概念。

2. 强大的错误传播机制

与asyncio复杂的错误处理不同，tinyio采用了简单而可靠的错误传播策略：

一个协程中的错误会取消整个事件循环中的所有协程。

这种设计确保了错误不会被隐藏，开发者可以快速定位问题根源。你还可以通过设置.run(..., exception_group=None/False/True)来配置错误收集行为，例如将错误收集到BaseExceptionGroup中。

3. 灵活的集成能力

tinyio不仅可以独立使用，还支持与其他异步框架集成：

我们支持将tinyio循环集成到asyncio/trio事件循环中，反之亦然。

通过[tinyio.to_asyncio][]和[tinyio.from_asyncio][]等工具，你可以轻松实现不同事件循环之间的桥接，充分利用现有代码库。

📦 快速开始：安装与基础使用

一键安装步骤

安装tinyio非常简单，只需使用pip：

pip install tinyio

如果你想从源码安装，可以克隆仓库后进行本地安装：

git clone https://gitcode.com/gh_mirrors/tin/tinyio
cd tinyio
uv run prek install  # 创建本地虚拟环境 + 安装依赖 + 安装pre-commit钩子

基础使用示例

tinyio的API设计简洁明了，下面是一个基本示例：

import tinyio

async def main():
    print("Hello, tinyio!")
    await tinyio.sleep(1)
    print("Event loop is running smoothly!")

tinyio.run(main())

这段代码展示了tinyio的核心用法：创建协程、使用sleep函数和运行事件循环。相比asyncio，tinyio的语法更加直观，减少了不必要的抽象。

🔍 深入了解：核心模块解析

事件循环核心：tinyio/_core.py

事件循环的核心实现位于tinyio/_core.py文件中。其中Loop类是整个框架的心脏，提供了运行和管理协程的基础功能：

驱动事件循环的生成器。这是低级功能，使得可以一次只迭代循环一步。这通常用于与另一个事件循环集成。

Loop.run()方法是启动事件循环的入口点，而run_until_complete()则允许你运行单个协程直到完成。

时间管理：tinyio/_time.py

时间相关功能在tinyio/_time.py中实现，最常用的是sleep函数：

tinyio协程，用于在不阻塞事件循环的情况下休眠。

这个函数通过利用threading.Event.wait的超时机制来实现非阻塞休眠，完美融入tinyio的事件循环模型。

隔离执行：tinyio/_isolate.py

tinyio/_isolate.py提供了隔离执行协程的能力：

在隔离的事件循环中运行协程，如果它（或它产生的任何协程）失败，则返回异常而不是使整个程序崩溃。

这对于需要在主事件循环之外安全运行不可靠代码的场景非常有用。

❓ 常见问题解答

为什么tinyio使用yield而不是await？

tinyio选择使用yield语法而非await，主要是为了保持简洁性：

原因是await不会为事件循环提供暂停点（它只是调用__await__，也许那个提供暂停点），所以如果我们想使用该语法，我们需要将yield coro替换为类似await tinyio.Task(coro)的东西。传统语法不值得额外的类。

这种设计选择减少了代码量，同时保持了足够的表达能力。

如何在tinyio中处理并发？

tinyio提供了多种并发原语，如Event和Semaphore，它们都可以在事件循环中安全使用。你可以通过这些工具轻松实现协程之间的同步和通信。

🛠️ 高级功能：超越基础

与asyncio集成

tinyio提供了与asyncio的双向集成能力。你可以将tinyio事件循环运行在asyncio中，或者反之：

请注意，整个asyncio事件循环将在线程中运行。如果asyncio和tinyio代码共享状态，这可能会导致意外情况。

这种灵活性使得tinyio可以逐步集成到现有asyncio项目中，降低迁移成本。

异常组处理

tinyio支持Python 3.11+的异常组功能，允许你收集和处理多个同时发生的异常：

此行为可以配置（例如，通过设置.run(..., exception_group=None/False/True)将错误收集到BaseExceptionGroup中）。

这为复杂应用提供了更强大的错误处理能力。

🎯 总结：轻量级事件循环的未来

tinyio以其极简的设计、清晰的错误处理和强大的集成能力，为Python异步编程提供了一个令人耳目一新的选择。无论是作为学习异步编程的入门工具，还是作为生产环境中asyncio的轻量级替代品，tinyio都展现出了巨大的潜力。

如果你厌倦了asyncio的复杂性，想要一个简单、透明且可靠的事件循环，那么tinyio绝对值得一试。400行代码带来的不仅是简洁，更是对异步编程本质的回归。

立即通过pip install tinyio开始你的轻量级异步编程之旅吧！

【免费下载链接】tinyio Ever used asyncio and wished you hadn't? A tiny (~400 lines) event loop for Python. 项目地址: https://gitcode.com/gh_mirrors/tin/tinyio