Changes between Version 4 and Version 5 of oss/lolunit Tweet

Timestamp:

Sep 8, 2011, 3:54:22 PM (12 years ago)

Author:

sam

Comment:

--

oss/lolunit

@@ +1 @@
+{{{
+#!div style="float: right; color: blue; background-color: yellow; border: solid blue 1px; margin: 5px;"
+'''''I Can't Believe It's Not CppUnit! '''''
+}}}
+
 = The LolUnit test framework =
 
@@ -20 +25 @@
 == Documentation ==
 
-There is no documentation as of now. Feel free to ask for help by e-mailing sam@hocevar.net.
-
-A good way to understand how to use LolUnit is by comparing it with CppUnit’s helper macros. Here is a sample program using CppUnit:
-
-{{{
-#!cpp
-#include <cppunit/extensions/HelperMacros.h>
-#include <cppunit/extensions/TestFactoryRegistry.h>
-#include <cppunit/TestCaller.h>
-#include <cppunit/TestCase.h>
-#include <cppunit/TestSuite.h>
-#include <cppunit/TextTestRunner.h>
-
-class Test1 : public CppUnit::TestCase
-{
-    CPPUNIT_TEST_SUITE(Test1);
-        CPPUNIT_TEST(Addition);
-        CPPUNIT_TEST(Multiplication);
-    CPPUNIT_TEST_SUITE_END();
-
-    void Addition()
-    {
-        int i = 1;
-        CPPUNIT_ASSERT_EQUAL(i + 1, 2);
-        CPPUNIT_ASSERT_EQUAL(i + 2, 3);
-    }
-
-    void Multiplication()
-    {
-        int i = 2;
-        CPPUNIT_ASSERT_EQUAL(i * 1, 2);
-        CPPUNIT_ASSERT_EQUAL(i * 2, 4);
-    }
-};
-CPPUNIT_TEST_SUITE_REGISTRATION(Test1);
-
-int main(void)
-{
-    CppUnit::TextTestRunner runner;
-    runner.addTest(CppUnit::TestFactoryRegistry::getRegistry().makeTest());
-    return !runner.run();
-}
-}}}
-
-One major problem I have with this system is that `Addition` needs to be declared and defined at two different places. Similarly, `Test1` needs to be declared, then given as an argument to `CPPUNIT_TEST_SUITE`, and finally as an argument to `CPPUNIT_TEST_SUITE_REGISTRATION`. There is no reason the user should have to duplicate this information.
-
-This is the LolUnit equivalent:
-
-{{{
-#!cpp
-#include <lol/unit.h>
-
-LOLUNIT_FIXTURE(Test1)
-{
-    LOLUNIT_TEST(Addition)
-    {
-        int i = 1;
-        LOLUNIT_ASSERT_EQUAL(i + 1, 2);
-        LOLUNIT_ASSERT_EQUAL(i + 2, 3);
-    }
-
-    LOLUNIT_TEST(Multiplication)
-    {
-        int i = 2;
-        LOLUNIT_ASSERT_EQUAL(i * 1, 2);
-        LOLUNIT_ASSERT_EQUAL(i * 2, 4);
-    }
-};
-
-int main(void)
-{
-    lol::TextTestRunner runner;
-    return !runner.run();
-}
-}}}
-
-We believe it is a lot simpler.
+See the [wiki:/oss/lolunit/tutorial LolUnit tutorial] for an introduction on how to use LolUnit.