Editing Module:RadioGatun32/doc (section)

== Testing ==

=== Testing inside Mediawiki ===

To test this in Mediawiki, go to [[Module talk:RadioGatun32/testcases]], and verify that one sees "All RadioGatun[32] test vectors pass".  One can rerun the test by going to [[Module:RadioGatun32/testcases]], clicking on "edit this page", then in the debug console at the bottom, typing in <code>print(p.test())</code>.  One should then see "All RadioGatun[32] test vectors pass".

Another way to test this is to add <code><nowiki>{{#invoke:RadioGatun32/testcases|test}}</nowiki></code> to a page; wherever RadioGatun32/test is invoked, it should show "All RadioGatun[32] test vectors pass".

=== Testing outside Mediawiki ===

This module can either be run as a Mediawiki Lua module, or as a standalone Lua script.  This very same script is also available on GitHub in a repo which includes automated tests to ensure implementations of RadioGatun[32] generate correct hashes against a number of test inputs, including all official RadioGatun[32] test vectors.

To test this code, in a *NIX compatible environment like Linux, with Git and a version of Lua ''above'' 5.1 and ''below'' 5.4 (Lua 5.4 dropped <code>bit32</code>; a Lua 5.1 implementation with <code>bit32</code> support will also work), do the following:

 git clone https://github.com/samboy/rg32hash
 cd rg32hash/sqa
 ./do.test.sh ../Lua/rg32wiki.sh