☰

使用 LuaLaTeX 和 SQLite3

tag-icon • tag-icon luatex
使用 LuaLaTeX 和 SQLite3

我正在尝试从 LuaLaTeX 访问 SQLite 数据库，但无法加载已安装的lsqlite3包。以下是我迄今为止尝试过的方法：

  1. 安装全新 Xubuntu 14.04
  2. 安装完整的 TeX Live 2014
  3. 安装了 Luarocks（途中安装了 Lua5.1）

  4. 使用 Luarocks 安装lsqlite3

    uwe@luabuntu:/media/uwe$ luarocks 列表

    已安装的岩石：

    lsqlite3 0.9.1-2（已安装）- /usr/local/lib/luarocks/rocks

  5. 附加package.path在以下 TeX 文件中：

    \documentclass{article}    
\usepackage{luacode}

\begin{document}

\begin{luacode*}
  package.path="/usr/local/lib/luarocks/rocks;/usr/local/lib/luarocks/rocks/lsqlite3; 
  /usr/local/lib/lua/5.1/lsqlite3.so" .. package.path

  require("lsqlite3")
\end{luacode*}

Hello Lua!

\end{document}

我收到的错误如下：

! LuaTeX error [\directlua]:3: module 'lsqlite3' not found:
  no field package.preload['lsqlite3']
  [luatexbase.loader] Search failed
  [kpse lua searcher] file not found: 'lsqlite3'
  [kpse C searcher] file not found: 'lsqlite3'
  [oberdiek.luatex.kpse_module_loader]-eroux Search failed
stack traceback:
  [C]: in function 'require'
  [\directlua]:3: in main chunk.
\luacode@dbg@exec ...code@maybe@printdbg {#1} #1 }

l.9 \end{luacode*}

必须设置什么才能让 LuaLaTeX 找到该lsqlite3包？

编辑

我已尝试按照以下评论调整所有内容：

  1. 调整后/usr/local/texlive/2014/texmf.cnf
  2. 将所有内容放入示例中

  3. lsqlite3使用以下示例仍然会得到有关缺少模块的错误

    \documentclass{article}
\directlua{
require "lualoader"
}

\usepackage{fontspec}
\usepackage[english]{babel}
\begin{document}

\directlua{package.path='/usr/local/share/lua/5.1/?.lua;/usr/local/share/lua/5.1/?/init.lua;/home/uwe/.luarocks/share/lua/5.1/?.lua;/home/uwe/.luarocks/share/lua/5.1/?/init.lua;/usr/share/lua/5.1//?.lua;/usr/share/lua/5.1//?/init.lua;./?.lua;/usr/local/share/lua/5.1/?.lua;/usr/local/share/lua/5.1/?/init.lua;/usr/local/lib/lua/5.1/?.lua;/usr/local/lib/lua/5.1/?/init.lua;/usr/share/lua/5.1/?.lua;/usr/share/lua/5.1/?/init.lua'
package.cpath='/usr/local/lib/lua/5.1/?.so;/home/uwe/.luarocks/lib/lua/5.1/?.so;./?.so;/usr/local/lib/lua/5.1/?.so;/usr/lib/x86_64-linux-gnu/lua/5.1/?.so;/usr/lib/lua/5.1/?.so;/usr/local/lib/lua/5.1/loadall.so'
require "lualoader"
}

\directlua{%
local sqlite3 = require("lsqlite3")
local db = sqlite3.open_memory()

db:exec[[
  CREATE TABLE test (id INTEGER PRIMARY KEY, content);

  INSERT INTO test VALUES (NULL, 'Hello World');
  INSERT INTO test VALUES (NULL, 'Hello Lua');
  INSERT INTO test VALUES (NULL, 'Hello Sqlite3')
]]

for row in db:nrows("SELECT * FROM test") do
  tex.print(row.id .. " : ".. row.content )
end

}
\end{document}

答案1

可以修改 中的包加载机制Lua。在 的情况下LuaTeX，kpse库用于加载模块，而不是使用package.path和 的默认机制package.cpath。因此设置这些变量不会产生任何影响。但没有什么可以阻止我们使用Lua模块的两种方法lualoader.lua。将下面的代码片段保存为包含文档的目录中的文件：

-- lualoader.lua
-- this is copied from luatexbase.loader
local make_loader = function(path, pos, loadfunc)
  local default_loader = package.searchers[pos]
  local loader = function(name)
    local file, _ = package.searchpath(name,path)
    if not file then
      local msg = "\n\t[lualoader] Search failed"
      local ret = default_loader(name)
      if type(ret) == "string" then
        return msg ..ret
      elseif type(ret) == "nil" then
        return msg
      else
        return ret
      end
    end
    local loader,err = loadfunc(file, name)
    if not loader then
      return "\n\t[lualoader] Loading error:\n\t"..err
    end
    return loader
  end
  package.searchers[pos] = loader
end

local binary_loader = function(file, name)
  local symbol = name:gsub("%.","_")
  return package.loadlib(file, "luaopen_"..symbol)
end

make_loader(package.path,2,loadfile)
make_loader(package.cpath,3, binary_loader)

我们使用函数在表中的指定索引处插入搜索或make_loader函数。对于 lua 文件，对于二进制模块。我们还需要根据模块的类型使用不同的函数来加载模块。我们使用文件和稍微复杂一点的函数来加载二进制模块，该函数使用。package.pathpackage.cpathpackage.searchers23loadfileLuapackage.loadlib

作为示例，我们可以尝试lsqlite3从以下位置加载LuaTeX：

\documentclass{article}
\directlua{
require "lualoader"
}

\usepackage{fontspec}
\usepackage[english]{babel}
\begin{document}
\directlua{%
local sqlite3 = require("lsqlite3")

local db = sqlite3.open_memory()

db:exec[[
  CREATE TABLE test (id INTEGER PRIMARY KEY, content);

  INSERT INTO test VALUES (NULL, 'Hello World');
  INSERT INTO test VALUES (NULL, 'Hello Lua');
  INSERT INTO test VALUES (NULL, 'Hello Sqlite3')
]]

for row in db:nrows("SELECT * FROM test") do
  tex.print(row.id .. " : ".. row.content )
end

}
\end{document}

使用该标志运行 LuaLaTeX 非常重要--shell-escape，因为默认情况下二进制库是被阻止的。--shell-escape您可以使用该标志执行外部程序并调用二进制库。

该示例得出：

在此处输入图片描述

编辑：

作为乌韦指出，luarocks由于某些 Linux 包管理器安装的版本可能无法正常工作。我在 Fedora 上遇到了这个问题，所以我luarocks从源代码安装。另一个解决方案可能是将package.path和设置package.cpath为命令列出的目录

luarocks path

在我自己的系统上，结果如下：

$ luarocks path
export LUA_PATH='/home/michal/.luarocks/share/lua/5.2/?.lua;/home/michal/.luarocks/share/lua/5.2/?/init.lua;/usr/local/share/lua/5.2/?.lua;/usr/local/share/lua/5.2/?/init.lua;/usr/share/lua/5.2/?.lua;/usr/share/lua/5.2/?/init.lua;/usr/lib/lua/5.2/?.lua;/usr/lib/lua/5.2/?/init.lua;./?.lua'
export LUA_CPATH='/home/michal/.luarocks/lib/lua/5.2/?.so;/usr/local/lib/lua/5.2/?.so;/usr/lib/lua/5.2/?.so;/usr/lib/lua/5.2/loadall.so;./?.so'

因此，修改后的序言如下：

\directlua{    
package.cpath = '/home/michal/.luarocks/lib/lua/5.2/?.so;/usr/local/lib/lua/5.2/?.so;/usr/lib/lua/5.2/?.so;/usr/lib/lua/5.2/loadall.so;./?.so'
package.path = '/home/michal/.luarocks/share/lua/5.2/?.lua;/home/michal/.luarocks/share/lua/5.2/?/init.lua;/usr/local/share/lua/5.2/?.lua;/usr/local/share/lua/5.2/?/init.lua;/usr/share/lua/5.2/?.lua;/usr/share/lua/5.2/?/init.lua;/usr/lib/lua/5.2/?.lua;/usr/lib/lua/5.2/?/init.lua;./?.lua'
require "lualoader"
}

答案2

截至 2017 年 5 月，CTAN 上有一个名为lua包加载器，允许您修改 LuaTeX 中的默认包搜索行为。

加载后luapackageloader，执行require将首先尝试基于默认 kpse 的搜索器。如果未找到模块，它还将尝试从 Lua 的package.path和package.cpath值加载包。

使用示例

\documentclass{article}    
\usepackage{luacode}
\usepackage{luapackageloader}

\begin{document}

\begin{luacode*}
  package.path="/usr/local/lib/luarocks/rocks;/usr/local/lib/luarocks/rocks/lsqlite3; 
  /usr/local/lib/lua/5.1/lsqlite3.so" .. package.path

  require("lsqlite3")
\end{luacode*}

Hello Lua!

\end{document}

补充说明：您可以eval $(luarocks path)在 shell 上使用环境变量设置包路径，Lua 解释器会自动获取这些变量。这样，您就不需要自己动手了package.path。

答案3

根据评论这个问题，我有以下行/usr/local/texlive/2014/texmf.cnf：

CLUAINPUTS  = .;$SELFAUTOLOC/lib/{$progname,$engine,}/lua//;/usr/lib/{$progname,$engine,}/lua//

但我的luarocks list给予：

Installed rocks:

lsqlite3
   0.9.1-2 (installed) - /usr/lib/luarocks/rocks-5.2

因此您可能需要根据您的安装调整第二条路径。

答案4

概括

搜索包

  • package.path在正常的 Lua 中，会在和中搜索包package.cpath。

  • 在 LuaTeX 中，默认使用 kpse 搜索包。

  • 有两种方法可以修改 LuaTeX 搜索包的位置

  1. 修改 kpse 的行为

    修改texmf.cnf文件、变量LUAINPUTS和CLUAINPUTS。

  2. 让 Lua 加载package.(c)path，然后修改那些

    • 使用\usepackage{luapackageloader}，可以在 kpse 和 中搜索包package.(c)path。

    • package.(c)path用户可以在 Lua 代码中手动设置的值，但是最好设置环境变量例如LUA_PATH，LUA_CPATH。

      如果在 bash 中运行eval $(luarocks path)，则从该 bash shell 生成的所有进程都将继承环境变量。

二进制包

  • 如果包需要二进制文件，--shell-escape必須通過。

版本控制

  • 软件包版本必须与 Lua 版本兼容.print(_VERSION)在Lua 内部进行检查。

    要为 luarocks 指定特定版本，请执行以下操作luarocks --lua-version 5.3 path。

相关内容