This Lua module offers an interface to the GNU readline library.

The function readline() is a wrapper, which invokes the GNU readline, adds the line to the end of the history list, and then returns the line. Usually you call save_history() before the program exits, so that the history list is saved to the histfile.

This Lua module can dialogue with the user on the controlling-terminal of the process (typically /dev/tty) as returned by ctermid(). It also support most of readline's alternative interface, namely handler_install, read_char and handler_remove, and readline's custom completion.