Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Remote debugger for Lua. Based on RemDebug, but with a new set of features.
Lua
Branch: master

README.md

Project Description

MobDebug is a remote debugger for Lua (including Lua 5.1, Lua 5.2, Lua 5.3, and LuaJIT 2.x).

Features

MobDebug allows to control the execution of another Lua program remotely, set breakpoints, and inspect the current state of the program.

MobDebug is based on RemDebug and extends it in several ways:

  • fixed several existing bugs;
  • removed dependency on LuaFileSystem;
  • added new commands: LOAD, RELOAD, OUT, STACK, DONE;
  • added support for debugging wxwidgets applications;
  • added ability to pause and abort running applications;
  • added pretty printing and handling of multiple results in EXEC;
  • added stack and local/upvalue value reporting (STACK);
  • added on/off commands to turn debugging on and off (to improve performance);
  • added support for coroutine debugging (see examples/README for details);
  • added support for Moai debugging;
  • added support for MoSync using MobileLua;
  • added support for Lua 5.2 and Lua 5.3;
  • added support for varargs in stack trace;
  • added support for LuaJIT debugging (see note in Dependencies);
  • added support for nginx/OpenResty and Lapis debugging;
  • added support for cross-platform debugging (with client and server running on different platforms/filesystems);
  • provided integration with ZeroBrane Studio IDE.

Usage

-- to start a server you can use to debug your application
> lua -e "require('mobdebug').listen()"

-- to debug a script, add the following line to it:
require("mobdebug").start()

Installation

Make src/mobdebug.lua available to your script. See examples/README and examples/*.lua for examples of how to use the module.

Dependencies

MobDebug depends on LuaSocket 2.0+ and has been tested with Lua 5.1, Lua 5.2, and Lua 5.3. MobDebug also works with LuaJIT v2.0; using loop and scratchpad methods requires v2.0.1.

Author

Paul Kulchenko (paul@kulchenko.com)

License

See LICENSE file

Something went wrong with that request. Please try again.