Skip to content
xUnit-style + randomized unit testing framework for Lua (and C projects using Lua, etc.)
Latest commit 32e3ecf Jun 19, 2015 @silentbicycle Merge pull request #21 from davegoopot/patch-1
Fixing the web address for lunit
Failed to load latest commit information.
files update API docs Jul 23, 2012
index.html Oops, add index.html from luadoc, too. Mar 6, 2010
suite-hooks.lua Upgrade to Lua 5.2, but keep compatible with Lua 5.1 Apr 1, 2014
suite-with-random-tests.lua Upgrade to Lua 5.2, but keep compatible with Lua 5.1 Mar 31, 2014
test-error_handler.lua Upgrade to Lua 5.2, but keep compatible with Lua 5.1 Mar 31, 2014

Lunatest is an xUnit-style, Lua-based unit testing framework with additional support for randomized testing (a la QuickCheck).

It's largely upwardly compatible from lunit, with the following changes:

  • Where lunit uses assert(), lunatest uses assert_true(). lunatest does not change any functions from the standard library.
  • If running tests in only one file, no module declaration is necessary.
  • For multiple suites, register them with lunatest.suite("file"). This uses require the file suite to return a table containing the suite related functions as well as the test functions. (Note: non local tests functions found outside the returned table go to the main suite.)
  • It doesn't have any dependencies except Lua, though if present, it will use lhf's lrandom module (for consistent pseudorandom numbers across operating systems) and luasocket's gettime() for timestamps).

The main (or only) test file should end in, and can be run as a normal lua script. The following command-line arguments are supported:

  • -v: verbose mode, which lists every test's name, result, and runtime.
  • -s / --suite pattern: Only run suite(s) with names matching the pattern.
  • -t / --test pattern: Only run test(s) with names matching the pattern.

For further examples, see the API documentation and included test suite.

Like Lua itself, Lunatest is distributed under the MIT license.

Something went wrong with that request. Please try again.