lua-users home
lua-l archive

[Date Prev][Date Next][Thread Prev][Thread Next] [Date Index] [Thread Index]


luaprompt is both an interactive Lua prompt that can be used instead
of the official interpreter, as well as a module that provides a Lua
command prompt that can be embedded in a host application.  As a
standalone interpreter it provides many conveniences that are missing
from the official Lua interpreter.  As an embedded prompt, it's meant
for applications that use Lua as a configuration or interface language
and can therefore benefit from an interactive prompt for debugging or
regular use.

luaprompt features:

* Readline-based input with history and completion: In particular all
  keywords, global variables and table accesses (with string or
  integer keys) can be completed in addition to readline's standard
  file completion.  Module names are also completed, for modules
  installed in the standard directories, and completed modules can
  optionally be loaded.

* Persistent command history (retained across sessions), as well as
  recording of command results for future reference.

* Proper value pretty-printing for interactive use: When an expression
  is entered at the prompt, all returned values are printed
  (prepending with an equal sign is not required).  Values are printed
  in a descriptive way that tries to be as readable as possible.  The
  formatting tries to mimic Lua code (this is done to minimize
  ambiguities and no guarantees are made that it is valid code).

* Color highlighting of error messages and variable printouts.

This release includes mostly bug fixes, but also:

* Luap now sets rl_readline_name, in order to allow luaprompt-specific readline configuration. This means you can configure the command-line (including changing keybindings, changing behavior, adding macros and more) and you can make this configuration specific to luaprompt/luap.

* When completing an already loaded module, which is not in the globals table, the module is put there so that completion can go on. This is configurable through the same macro, as automatic model loading.

* There's a Makefile now, for those who prefer to build themselves. Additionally, there's a manpage for luap, which only gets installed by said Makefile.

You can install luaprompt via LuaRocks, with:

	luarocks install luaprompt

Alternatively, you can download luaprompt and build it yourself. For more information, see the README at luaprompt's GitHub page, which you can find at the URL below:

https://github.com/dpapavas/luaprompt