# nvim-luadev

This plugins set up a REPL-like environment for developing lua plugins in Nvim.
The `:Luadev` command will open an scratch window which will show output from executing lua code.

Use the folllowing mappings to execute lua code:

Binding                       | Action
-------------------------     | ------
`<Plug>(Luadev-RunLine)`      | Execute the current line
`<Plug>(Luadev-Run)`          | Operator to execute lua code over a movement or text object.
`<Plug>(Luadev-RunWord)`      | Eval identifier under cursor, including `table.attr`
`<Plug>(Luadev-Complete)`     | in insert mode: complete (nested) global table fields

If the code is a expression, it will be evaluated, and the result shown with
`inspect.lua`. Otherwise it will be executed as a block of code. A top-level
`return` will cause the returned value to be inspected. A bare `nil` will not
be shown.

Global `print()` is also redirected to the output buffer, but only when executing
code via this plugin. `require'luadev'.print(...)` can be used to print to the
buffer from some other context.

Planned features:

 - [x] autodetect expression vs statements
 - [x] Fix `inspect.lua` to use `tostring()` on userdata (done on a local copy)
 - [x] completion of global names and table attributes (WIP: basic implementation done)
 - [x] make `<Plug>(Luadev-Run)` a proper operator
 - [ ] solution for step-wise execution of code with `local` assignments (such
        as a flag to copy local values to an env)
 - [x] tracebacks
 - [ ] interactive debugging
 - [x] debug helpers for async callbacks (WIP)