教你使用luarocks来建立rock包

一、什么是Luarocks？

Luarocks是一个Lua包管理器，基于Lua语言开发，提供一个命令行的方式来管理Lua包依赖、安装第三方Lua包等，社区比较流行的包管理器之一，另还有一个LuaDist，Luarocks的包数量比LuaDist多，更细节的二者对比可参阅这里。

二、源码安装Luarocks

wget https://luarocks.org/releases/luarocks-2.4.1.tar.gz
tar -zxvf luarocks-2.4.1.tar.gz
cd luarocks-2.4.1
./configure
make build && make install
cd ..

三、建立rockspec文件并修改

mkdir lua-package
cd lua-package
luarocks write_rockspec

执行完以后会发现多了一个 lua-package-dev-1.rockspec 文件，这个文件就是咱们建立的 rockspec 文件，接着咱们打开这个文件，查看里面的元信息，以下所示

#该包名
package = "lua-package"
#版本号(注意：一、版本号和你文件名所包含的版本号要一致，如这里的版本号是：dev-1，文件名是：lua-package-dev-1.rockspec
#二、版本号要以-x结尾，如0.0.1-1，1.3-1，若是你不按照这种规则定义则会报错！)
version = "dev-1"
source = {
   #指定源码的位置(通常咱们会发布到git所在的托管服务器，如我托管的是github就能够填写github托管地址了)
   url = "*** please add URL for source tarball, zip or repository here ***"
}
description = {
   #该包所在的说明文档位置(我托管的是github，因此这里能够填写分支在gh-pages所在的url)
   homepage = "*** please enter a project homepage ***",
   #指明所基于的开源协议
   license = "*** please specify a license ***"
}
build = {
   #编译方式
   type = "builtin",
   #指定包含的模块
   modules = {}
}

如今咱们来修改下 rockspec 文件，以下所示：

package = "lua-package"
version = "1.0-1"
source = {
   #这里我指定的是我当前包所在的github托管地址
   url = "git://github.com/zhangwei900808/lua-package.git",
   #指定tag版本号
   tag = "v1.0-1",
   #设置为master分支
   branch = "master"
}
description = {
   #设置描述信息
   summary = "A test lua package with luarocks",
   #源码所在的说明文档地址
   homepage = "https://github.com/zhangwei900808/lua-package",
   #指定维护者信息
   maintainer = "zhangwei<zw900808@gmail.com>",
   #指定开源协议
   license = "MIT"
}
#设置Lua的依赖环境
dependencies = {
  "lua >= 5.1, < 5.4"
}
build = { 
   type = "builtin",
   modules = {}
}

注意：version 如今已经改为了 1.0-1 因此文件名也要改为lua-package-1.0-1.rockspec

四、建立lua-package.lua文件，并修改rockspec文件

touch lua-package.lua

建立好以后，接着咱们编辑这个文件，加入下面代码

local _M = {}
_M._VERSION = '0.1'

local mt = { __index = _M }

function _M.new( self, firstname, lastname )
    return setmetatable({
        firstname = firstname,
        lastname = lastname
    }, mt)
end

function _M.get_fullname(self)
    return self.firstname .. self.lastname
end

return _M

修改以后，咱们在rockspec文件里面加上这段

modules = {
     ["lua-package"] = "lua-package.lua"
   }

完整的rockspec代码以下所示：

package = "lua-package"
version = "1.0-1"
source = {
   url = "git://github.com/zhangwei900808/lua-package.git",
   tag = "v1.0-1",
   branch = "master"
}
description = {
   summary = "A test lua package with luarocks",
   homepage = "https://github.com/zhangwei900808/lua-package",
   maintainer = "zhangwei<zw900808@gmail.com>",
   license = "MIT"
}
dependencies = {
  "lua >= 5.1, < 5.4"
}
build = {
   type = "builtin",
   modules = {
     ["lua-package"] = "lua-package.lua"
   }
}

五、推送代码到github并添加README.md文件

touch README.md
vim README.md

git add .
git commit -am 'your commit'
git push -u origin master

并添加gh-pages分支作为 rockspec的homepage使用，以下所示：

git branch gh-pages
git checkout gh-pages
git push --set-upstream origin gh-pages

六、添加git tag

git tag v1.0-1
git push --tags

若是发现tag打错了，可使用下面代码进行删除

#删除本地版本
git tag -d your-tag
#删除远程仓库版本
git push origin :refs/tags/your-tag

七、注册luarocks并建立api-key

注册地址在这，注册完成以后，点击菜单里面的 Settings ，进去以后再点击 API keys，在这里你就能够建立本身的api-keys了，建立好以后复制一下，接下来咱们会用到。

八、上传你的lua-package包

luarocks upload your-rockspec-name.rockspec --api-key=your-api-key

成功以后，咱们到luarocks官网看看你刚上传的包，以下是我上传的结果

九、安装并使用lua-package包

luarocks install lua-package

接下来咱们写一段代码测试下lua-package可用性，以下所示：

location /test {
    content_by_lua_block {
        local package = require("lua-package")
        local packageObj = package:new('zhang', 'wei')
        ngx.say(packageObj:get_fullname())
    }
}

启动这段代码，并访问查看输出结果：

curl "http://127.0.0.1/test"

zhangwei

十、总结：

1：不要把tag和推送代码搞反了，是先推送代码，后打包tag

11 、引用

1. 源码
2. Creating a rock
3. Lua包管理工具Luarocks详解