如何在10分钟内上手tinyio：超简单异步编程入门指南

【免费下载链接】tinyioEver 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复杂的错误处理问题而生。如果你曾在使用asyncio时感到困惑，tinyio 将为你提供一种简单直观的异步编程体验，让你快速掌握异步任务的调度与管理。

🚀 1分钟安装：开启tinyio之旅

安装 tinyio 只需一行命令，通过 pip 即可快速完成：

pip install tinyio

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

git clone https://gitcode.com/gh_mirrors/tin/tinyio cd tinyio

🔍 核心概念：tinyio的极简设计

tinyio 的核心设计围绕事件循环（Loop）和协程（Coro）展开，主要包含以下组件：

• tinyio.Loop：事件循环的核心，负责调度和执行所有协程
• tinyio.sleep：非阻塞睡眠函数，允许协程暂停指定时间
• tinyio.run_in_thread：在单独线程中运行阻塞函数，避免阻塞事件循环
• tinyio.CancelledError：协程取消时抛出的异常，用于错误处理

💡 3分钟上手：第一个tinyio程序

下面是一个简单的示例，展示如何创建事件循环并运行异步任务：

import tinyio def hello_world() -> tinyio.Coro[str]: # 非阻塞睡眠1秒 yield tinyio.sleep(1) return "Hello, tinyio!" # 创建事件循环 loop = tinyio.Loop() # 运行协程并获取结果 result = loop.run(hello_world()) print(result) # 输出: Hello, tinyio!

关键点解析：

1. 协程定义：使用yield关键字标记异步操作（如tinyio.sleep）
2. 事件循环：通过tinyio.Loop()创建，调用.run()方法执行协程
3. 非阻塞特性：yield tinyio.sleep(1)不会阻塞整个程序，其他任务可同时执行

⚡ 高级用法：并发任务与线程管理

tinyio 支持同时运行多个协程，并能轻松处理阻塞操作。以下是两个实用场景示例：

1. 并发执行多个任务

使用列表同时 yield 多个协程，实现并发执行：

import tinyio import time def task(name: str, delay: float) -> tinyio.Coro[str]: start = time.time() yield tinyio.sleep(delay) return f"Task {name} finished in {time.time() - start:.2f}s" def main() -> tinyio.Coro[list[str]]: # 并发执行三个任务 results = yield [ task("A", 0.5), task("B", 0.3), task("C", 0.7) ] return results loop = tinyio.Loop() print(loop.run(main())) # 输出（顺序可能不同）: # ['Task B finished in 0.30s', 'Task A finished in 0.50s', 'Task C finished in 0.70s']

2. 在线程中运行阻塞函数

对于CPU密集型或阻塞操作，使用tinyio.run_in_thread避免阻塞事件循环：

import tinyio import time def blocking_task(seconds: int) -> int: # 模拟阻塞操作 time.sleep(seconds) return seconds * 2 def async_wrapper() -> tinyio.Coro[int]: # 在单独线程中运行阻塞函数 result = yield tinyio.run_in_thread(blocking_task, 2) return result loop = tinyio.Loop() print(loop.run(async_wrapper())) # 输出: 4

📚 官方文档与资源

• 完整API文档：docs/index.md
• 并发控制：docs/api/synchronisation.md
• 线程管理：docs/api/threading.md
• 错误处理：docs/api/error_propagation.md

❓ 常见问题解答

Q: tinyio 与 asyncio 有什么区别？

A: tinyio 采用更简单的设计理念，使用yield而非await，避免了asyncio中的任务（Task）概念，错误处理更直观。核心代码仅400行，易于理解和调试。

Q: 如何在 tinyio 中处理超时？

A: 使用tinyio.timeout函数包装协程，超时会抛出tinyio.TimeoutError：

result, success = yield tinyio.timeout(coroutine, timeout_in_seconds)

Q: 能否嵌套使用多个事件循环？

A: 可以！tinyio 支持嵌套循环，使用tinyio.isolate可创建独立的子循环，避免单个任务崩溃影响整个程序：

result, success = yield tinyio.isolate(coroutine)

🎯 总结：为什么选择 tinyio？

• 极简设计：约400行代码，易于理解和扩展
• 直观语法：使用yield标记异步操作，降低学习门槛
• 强大功能：支持并发、线程池、超时控制和错误隔离
• 无缝集成：可与asyncio和trio生态系统互操作

现在你已经掌握了 tinyio 的基本用法，只需10分钟就能将其应用到实际项目中。无论是简单的定时任务还是复杂的并发场景，tinyio 都能为你提供高效、可靠的异步编程体验！

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