Lua 异步等待库——Lua Async Await
在大约90行代码中,Lua Async Await 提供了一个强大的解决方案,使你的 Lua 代码可以优雅地处理异步操作。最初是为 Neovim 设计的,充分利用了与 Node.js 共享的 libuv 事件循环,但这个库适用于任何 Lua 环境。
特别致谢
感谢 svermeulen 解决了无法返回函数的问题(见 issue #2)。
预览功能
以下是一个简单的示例,展示了如何使用 async 和 await:
local a = require "async"
local do_thing = a.sync(function (val)
local o = a.wait(async_func())
return o + val
end)
local main = a.sync(function ()
local thing = a.wait(do_thing()) -- 可组合!
local x = a.wait(async_func())
local y, z = a.wait_all{async_func(), async_func()}
end)
main()
Luv 与 Libuv
Neovim 使用 libuv 进行异步处理,它也是 NodeJS 的核心部分。通过 luv 库,我们可以访问 libuv 在 Lua 中的各种 API,这些 API 形式上类似于 NodeJS,例如 (param1, param2, callback)。
我们的目标是避免回调地狱。
协程概述
了解协程的概念和 Lua 中的实现方式是必要的。建议阅读关于 Lua 协程 的前 500 字,以及 MDN 上关于 JavaScript 生成器 的教程,虽然语言不同,但理念相似。
同步协程
在深入研究异步版本之前,我们先来看看同步协程的工作原理。在 Lua 代码中,coroutine 是一个命名空间而不是协程本身,我们遵循《Lua 书》中的约定,用 thread 表示协程。
local co = coroutine
local thread = co.create(function ()
local x, y, z = co.yield(something)
return 12
end)
local cont, ret = co.resume(thread, x, y, z)
从同步到异步
现在,我们将创建一个能处理异步操作的协程。首先,我们需要了解 Thunk 概念,它是将 (arg, callback) -> void 转换为 arg -> (callback -> void) -> void 的函数。
结合 Thunk 和协程,我们就可以创建出一种机制,让协程在准备好时接收并处理值,这就是 async await 的基本思想。
推荐理由
- 简洁高效:仅需90行代码即可实现异步编程模型。
- 广泛适用:不仅限于 Neovim,可用于所有 Lua 环境。
- 可组合性:利用
wait和wait_all函数,可以轻松组合多个异步任务。 - 易用性:提供
sync和await包装器,隐藏底层复杂性,使得异步编程更加直观。
对于需要处理异步操作的 Lua 开发者来说,Lua AsyncAwait 是一个值得尝试的优秀库。立即安装并体验在你的项目中使用 async 和 await 带来的便利吧!
atomcodeClaude Code 的开源替代方案。连接任意大模型,编辑代码,运行命令,自动验证 — 全自动执行。用 Rust 构建,极致性能。 | An open-source alternative to Claude Code. Connect any LLM, edit code, run commands, and verify changes — autonomously. Built in Rust for speed. Get StartedRust0220
cann-learning-hubCANN 学习中心仓,支持在线互动运行、边学边练,提供教程、示例与优化方案,一站式助力昇腾开发者快速上手。Jupyter Notebook0140
uni-appA cross-platform framework using Vue.jsJavaScript09
GLM-5.2智谱开源 GLM-5.2,这是针对长文本任务的最新旗舰模型。相较于前代产品 GLM-5.1,它在长文本任务处理能力上实现了显著飞跃,并且首次在稳定的 100 万 token 上下文中提供这一能力。Jinja00
SwanLab⚡️SwanLab - an open-source, modern-design AI training tracking and visualization tool. Supports Cloud / Self-hosted use. Integrated with PyTorch / Transformers / LLaMA Factory / veRL/ Swift / Ultralytics / MMEngine / Keras etc.Python00
tiny-universe《大模型白盒子构建指南》:一个全手搓的Tiny-UniverseJupyter Notebook03