LuaUnit Test-Adapter

This is a personal fork of lej.vscode-lua-test-adapter with additional features for personal use.

A LuaUnit test adapter for Test Explorer UI.

Supported

• Detect LuaUnit tests
• Run LuaUnit tests
• Debugging (requires one of the extensions below, configurable with debugExtension)
  • Lua Debug by actboy168 (default)
  • Local Lua Debugger by tomblind
    • The test file must pass varargs to LuaUnit so the debugger can forward test filter arguments: LuaUnit.run(...) or LuaUnit.new():runSuite(...)
  • Second Local Lua Debugger by ismoh-games (fork of tomblind's)
    • Same requirement as Local Lua Debugger: the test file must use LuaUnit.run(...) or LuaUnit.new():runSuite(...)

Not supported

• Automatic reloading of test definitions
• Autorun

Getting Started

1. Install LuaUnit Test-Adapter
2. Download LuaUnit (example/luaunit.lua)
3. Create a test file (example/test.lua) with the below content

luaunit  = require('luaunit')

function testPass()
    luaunit.assertEquals({1, 2, 3}, {1, 2, 3})
end

function testFail()
    luaunit.assertEquals({1, 2, 3}, {1, 2, 4})
end
-- Use LuaUnit.run(...) with varargs if you want to use Local Lua Debugger for debugging
os.exit(luaunit.LuaUnit.run())

1. If the Lua executable is not on PATH as lua, set luaExe in settings. Use ${workspaceFolder} to reference the workspace root, e.g. "${workspaceFolder}/lua5.1.exe"
2. Test Explorer UI is installed automatically as necessary. Newer version of VSCode has this feature built-in so no need to install the extension.
3. For debugging capability install one of the supported debug extensions (see Supported) and set debugExtension if not using the default
4. Run (or debug) the tests via the Test Explorer UI

Configuration