Skip to content


Subversion checkout URL

You can clone with
Download ZIP
xUnit-style + randomized unit testing framework for Lua (and C projects using Lua, etc.)
Branch: master

Merge pull request #21 from davegoopot/patch-1

Fixing the web address for lunit
latest commit 32e3ecfdb6
@silentbicycle authored

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.