italomaia / luaunit Goto Github PK

by Philippe Fremy

Luaunit is a unit-testing framework for Lua. It allows you to write test functions and test classes with test methods, combined with setup/teardown functionality. A wide range of assertions are supported.

Luaunit supports several output format, like Junit or TAP, for easier integration into Continuous Integration platforms (Jenkins, Maven, ...) . The integrated command-line options provide a flexible interface to select tests by name or patterns, control output format, set verbosity, ...

LuaUnit works with Lua 5.1 and 5.2 . It was tested on Windows XP and Ubuntu 12.04 (see continuous build results on Travis-CI ) and should work on all platforms supported by lua. It has no other dependency than lua itself.

LuaUnit is packed into a single-file. To make start using it, just add the file to your project.

Luaunit is now maintained on github: https://github.com/bluebird75/luaunit

It is released under the BSD license.

Documentation is available on read-the-docs

Since some people have forked LuaUnit and release some 2.x version, I am jumping the version number.

• moved to Github
• full documentation available in text, html and pdf at read-the-docs.org
• new output format: JUnit
• much better table assertions
• new assertions for strings, with patterns and case insensitivity: assertStrContains, assertNotStrContains, assertNotStrIContains, assertStrIContains, assertStrMatches
• new assertions for floats: assertAlmostEquals, assertNotAlmostEquals
• type assertions: assertIsString, assertIsNumber, ...
• error assertions: assertErrorMsgEquals, assertErrorMsgContains, assertErrorMsgMatches
• improved error messages for several assertions
• command-line options to select test, control output type and verbosity

• compatibility with Lua 5.1 and 5.2
• better object model internally
• a lot more of internal tests
• several internal bug fixes
• make it easy to customize the test output
• running test functions no longer requires a wrapper
• several level of verbosity

• switch from X11 to more popular BSD license
• add TAP output format for integration into Jenkins
• official repository now on github

• port to lua 5.1
• iterate over the test classes, methods and functions in the alphabetical order
• change the default order of expected, actual in assertEquals (adjustable with USE_EXPECTED_ACTUAL_IN_ASSERT_EQUALS).

• first public release

• move global variables to internal variables
• assertion order is configurable between expected/actual or actual/expected
• new assertion to check that a function call returns an error
• display the calling stack when an error is spotted
• two verbosity level, like in python unittest