如何在 Conky 中实现一个基本的 Lua 功能？

Question

我正在尝试向我的 Conky 添加一个函数，该函数会打印字符串的长度以进行调试。代码位于一个名为 test.lua 的文件中，非常简单：

function test(word)
return string.len(word)
end

...我像这样加载它。在我的conky.config 部分，我有：

lua_load = '/home/xvlaze/test.lua',
lua_draw_hook_pre = 'test'

...在conky.text 部分我有：

${lua test "fooo"}

...其中test 是函数的名称，fooo 是要测试的字符串。

预期的结果应该是在 Conky 中打印的 4，但我得到的是：

conky: llua_do_call: function conky_test execution failed: /home/xvlaze/test.lua:2: attempt to index a nil value (local 'string')
conky: llua_getstring: function conky_test didn't return a string, result discarded

我浏览了documentation，但找不到任何东西。有人知道失败在哪里吗？

Answer 1

关于如何在 Conky 中实现功能的几个指南：

• 首先：您必须在函数名称前使用conky_。 否则，在运行 Conky 时会出现以下错误：

  attempt to call a nil value
  

• 其次：您必须始终返回一个值。 我不介意重复一遍 - 这是至关重要的。否则，你会得到：

  function foobar didn't return a string, result discarded
  function_result
  

  ...在您的终端中，您的 Conky 将没有与您的额外代码相关的值。不会打印有关您的功能的任何内容。

• 最后但并非最不重要的一点：您必须始终像这样调用您的函数：

  lua_load = '/path/to/function.lua',
  -- Whatever content...
  ${lua function_name function_parameter1 function_parameterN} -- In case you use more than one parameter.
  

总之，一个虚拟函数模板可以是：

• 主文件（conky.conf）：

  conky.config = {
      -- Whatever content... Lua styled comments.
      lua_load = '/path/to/function.lua',
  }
  
  conky.text = [[
      # Whatever content... In this section comments are started with '#'!    
      ${lua function_name parameter}
  ]]
  

• 功能文件：

  function conky_function_name(parameter)
      -- Whatever content... Remember this is Lua, not conky.text syntax. Always use '--' comments!
      return whatever -- No return, no party. A function MUST always return something!
  end