Lua on TripleZ's Blog https://blog.triplez.cn/tags/lua/ Recent content in Lua on TripleZ's Blog Hugo -- gohugo.io zh-cn Fri, 18 Dec 2020 15:41:57 +0000 发布你第一个 Luarocks 包 https://blog.triplez.cn/posts/publish-your-first-luarocks-package/ Fri, 18 Dec 2020 15:41:57 +0000 https://blog.triplez.cn/posts/publish-your-first-luarocks-package/ <p>手把手教你如何发布一个 LuaRocks 包。</p> 手把手教你如何发布一个 LuaRocks 包。

写一个 rockspec

首先写好你准备发布的包 当然是自己写好了才要发布啦 ，然后我们在项目根目录下写一个 rockspec 文件（用来描述 LuaRocks 包的元信息文件）。

1

luarocks write_rockspec <package_name> <package_version> <package_location>

比如，我希望发布的是 busted_resty 的 0.5.0 版本，那么我需要我的项目根目录上输入以下命令来创建我的 rockspec 文件。

1

$ luarocks write_rockspec busted_resty 0.5.0 .

然后，你会得到一个这样的 rockspec 文件：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

package = "package_name"
version = "1.0-1"
source = {
    url = "*** please add URL for source tarball, zip or repository here ***"
}
description = {
    homepage = "*** please enter a project homepage ***",
    license = "*** please specify a license ***"
}
dependencies = {
}
build = {
    type = "builtin",
    modules = {}
}

这里我们简单解释下其中的含义：

  • package ：包名称。
  • version ：包版本，必须为 <数字>.<数字>[.<数字>]-<数字> 。
  • source ：包的源代码位置，如 Git 地址等。
  • description ：包的基本描述，以及版权协议等信息。
  • dependencies ：与其他库的依赖关系。
  • build ：构建具体信息，比如安装的库名。

更多 rockspec 的具体细节可以在 LuaRocks 的 Wiki 中找到。

对于 busted_resty 的 0.5.0 版本（我已经事先在 Git 上打好了 v0.5.0 的 tag），它的 rockspec 是这样的：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

package = "busted_resty"
version = "0.5.0-1"
source = {
   url = "git://github.com/Triple-Z/busted_resty",
   tag = "v0.5.0"
}
description = {
   summary = "An extra mocking layer for OpenResty in busted testing environment.",
   detailed = [[
      This module mocks the following OpenResty APIs:

      - ngx.status
      - ngx.exit
      - ngx.exec
      - ngx.redirect
      - ngx.send_headers
      - ngx.headers_sent
      - ngx.print
      - ngx.say
      - ngx.flush
      - ngx.eof
      - ngx.is_subrequest
      - ngx.on_abort
      - ngx.arg.*
      - ngx.var.*
      - ngx.header.*
      - ngx.location.*
      - ngx.req.*
      - ngx.resp.*
   ]],
   homepage = "https://github.com/Triple-Z/busted_resty",
   license = "MIT"
}
dependencies = {
   'lua >= 5.1',
   'luassert >= 1.7.8',
}
build = {
   type = "builtin",
   modules = {
      busted_resty = "src/busted_resty.lua"
   }
}

其中，modules 代表着文件的安装方式及位置。如在 busted_resty 中，安装方式为 builtin ，因此 LuaRocks 只是将这些指定的文件复制粘贴到某个指定的位置。比如，库中的 src/busted_resty.lua 就会被复制到 LuaRocks 中 Lua 库的根目录。

检查 rockspec 语法

写好了 rockspec 后，我们可以来检查下 rockspec 的语法是否正确。当然，使用的是 luarocks lint 命令。

1

$ luarocks lint busted_resty-0.5.0-1.rockspec

如果按下 Enter 后什么都没发生，恭喜你，没有消息就是好消息（毕竟是高深莫测的 UNIX 哲学 😄）。

如果有信息输出，那就按照错误提示改吧 🤣。

MAKE!

当我们编写好了 rockspec 后，就可以尝试构建属于我们自己的第一个 LuaRocks 包了！怎么构建呢，当然是用 LuaRocks 中的 make 命令啦！

1

$ luarocks make

不出意外的话，你第一个 LuaRocks 包应该被 LuaRocks 安装到了指定的位置，快打开你最喜欢的 Lua 解释器，试一下吧！

1
2

$ luajit
> require "busted_resty"

如果什么也没有发生，那可就太好了！说明我们的 LuaRocks 包已经被安装到了本地环境上了！

打包并上传

最后，那当然就是最激动人心的环节：将我们的包发布到 LuaRocks 上。

你可以先打包，验证包是否正确：

1

$ luarocks pack <rockspec_file>

在我们的例子中，即为：

1

$ luarocks pack busted_resty-0.5.0-1.rockspec

执行完打包命令后，你会在目录下看到一个后缀为 .src.rock 的文件。没错，那就是我们的 LuaRocks 包。

接下来你有两种方式来将我们刚打出来的 LuaRocks 包上传至 LuaRocks 中心仓库，让我们分别介绍它们吧。

直接在网站上上传 rock

你可以直接在 LuaRocks 网站上上传你的 rockspec 描述文件以及 src.rock 包。点击“提交”即可在 LuaRocks 上发布你的 rock 包～

用命令行上传

使用 luarocks upload 即可帮你打包并直接上传至 LuaRocks 中心仓库：

1

$ luarocks upload [--api-key=<api-key>] <rockspec_file>

别忘了 API Key 哦，在这里可以获取你自己的 API Key。

busted_resty on luarocks.org
busted_resty on luarocks.org

🎉恭喜你，成功上传了自己的第一个 LuaRocks 包！

]]> macOS 上安装 Lua 及 Luarocks https://blog.triplez.cn/posts/install-lua-and-luarocks-in-macos/ Sun, 13 Dec 2020 15:38:20 +0000 https://blog.triplez.cn/posts/install-lua-and-luarocks-in-macos/ <p>在 macOS 上安装多版本 Lua 及 Luarocks。</p> 在 macOS 上安装多版本 Lua 及 Luarocks。

Homebrew

Lua、LuaJIT 和 Luarocks 都可以直接通过 brew 包管理直接安装，而且可以处理不同版本的 Luarocks，使用的仓库为 mesca/homebrew-luarocks 。

1

$ brew tap mesca/luarocks

Lua 5.1, 5.3 都需要在 Homebrew 中添加 mesca/luarocks 仓库。

Lua 5.1

1
2
3

# Lua 5.1
$ brew install lua51
$ brew install luarocks51

使用方式：

1
2
3
4

# 进入 Lua 5.1 REPL
$ lua5.1
# 使用 Lua 5.1 的 Luarocks
$ luarocks-5.1 --version

LuaJIT

1
2
3

# LuaJIT
$ brew install luajit
$ brew install luarocks51 --with-luajit

使用方式：

1
2
3
4

# 进入 LuaJIT REPL
$ luajit
# LuaJIT 与 Lua 5.1 共用 Luarocks
$ luarocks-5.1 --version

Lua 5.3

1
2
3

# Lua 5.3
$ brew install lua53
$ brew install luarocks53

使用方式：

1
2
3
4

# 进入 Lua 5.3 REPL
$ lua5.3
# 使用 Lua 5.3 的 Luarocks
$ luarocks-5.3 --version

Lua 5.4 (Current)

1
2
3

# Current: 5.4
$ brew install lua
$ brew install luarocks

使用方式：

1
2
3
4

# 进入 Lua 5.4 REPL
$ lua
# 使用 Lua 5.4 的 Luarocks
$ luarocks --version

Build from Source

请参照 Luarocks 官方安装指南 。或者 OpenResty 文档中关于 Luarocks 的内容 。

]]>