Linenoise (https://github.com/antirez/linenoise) is a delightfully simple command line library. This Lua module is simply a binding for it.

lua-linenoise was written by Rob Hoelz. You can find the original version here.

This repository also contains a Windows-compatible version of linenoise taken from MSOpenTech's Windows port of redis.

If you use LuaRocks, you can run luarocks make on the latest rockspec.

You can also build with make. When building this module using make, you may use the original linenoise source included in the repository, or you may set the Makefile variable LIBLINENOISE to override it:

make LIBLINENOISE=-llinenoise
# OR:
make LIBLINENOISE=/path/to/liblinenoise.a

You may need to change the value of the LN_EXPORT macro in lua-linenoise.c to the appropriate keyword to ensure the luaopen_linenoise function is exported properly (I don't know much about C or Unix-like systems, so I may have gotten it wrong).

If you have Visual Studio 2012 (even the free Express version), you can compile this module with the Windows-compatible linenoise source using the included solution file (you'll need to edit the include paths and import library dependencies to match your configuration).

If you prefer to compile using other tools, just link lua-linenoise.c with line-noise-windows/linenoise.c and line-noise-windows/win32fixes.c to create the Windows-compatible DLL.

This library is a fairly thin wrapper over linenoise itself, so the function calls are named similarly. I may develop a "porcelain" layer in the future.

Prompts for a line of input, using prompt as the prompt string. Returns nil if no more input is available.

Adds line to the history list.

Sets the history list size to length.

Saves the history list to filename.

Loads the history list from filename.

Clears the screen.

Sets the completion callback. This callback is called with two arguments:

• A completions object. Use L.addcompletion to add a completion to this object.
• The current line of input.

Adds string to the list of completions.

All functions return nil on error; functions that don't have an obvious return value return true on success.

local L = require 'linenoise'
-- L.clearscreen()
print '----- Testing lua-linenoise! ------'
local prompt, history = '? ', 'history.txt'
L.historyload(history) -- load existing history
L.setcompletion(function(c,s)
   if s == 'h' then
    L.addcompletion(c,'help')
    L.addcompletion(c,'halt')
  end
end)
local line = L.linenoise(prompt)
while line do
    if #line > 0 then
        print(line:upper())
        L.historyadd(line)
        L.historysave(history) -- save every new line
    end
    line = L.linenoise(prompt)
end