Debug API

[mxpv]

luaz should provide a high level debugger interface:

• Should provide API to retrieve various info about execution.
  • Should not require user to manipulate Lua stack.
• Function calls should support breaks dd4f2da
• Set break points d61f1b1
• Should provide APIs to install callbacks eb513fb
• Retrieve trace 7ac34e0
• Debug break on Lua side?
• Documentation
• Guided tour update

API surface

• lua_stackdepth(lua_State* L);
• lua_getinfo(lua_State* L, int level, const char* what, lua_Debug* ar);
• lua_getargument(lua_State* L, int level, int n);
• lua_getlocal(lua_State* L, int level, int n);
• lua_setlocal(lua_State* L, int level, int n);
• lua_getupvalue(lua_State* L, int funcindex, int n);
• lua_setupvalue(lua_State* L, int funcindex, int n);
• lua_singlestep(lua_State* L, int enabled);
• lua_breakpoint(lua_State* L, int funcindex, int line, int enabled);
• lua_debugtrace(lua_State* L);

[EtienneParmentier]

I second this. I gave up writing an embeded debugger multiple times. The documentation in the luau repo is not at all sufficient.

[mxpv]

I have a draft implementation, will publish it soon.

[mxpv]

This is done: https://github.com/mxpv/luaz/releases/tag/v0.3.0