set up a unittest_main macro

Author: ianfixes

CHANGELOG.md

@@ -12,6 +12,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 ### Changed
 - `arduino_ci_remote.rb` doesn't attempt to set URLs if nothing needs to be downloaded
 - `arduino_ci_remote.rb` does unit tests first
+- `unittest_main()` is now the macro for the `int main()` of test files
 
 ### Deprecated
 

README.md

@@ -43,12 +43,10 @@ unittest(your_test_name)
   assertEqual(4, doSomething());
 }
 
-int main(int argc, char *argv[]) {
-  return Test::run_and_report(argc, argv);
-}
+unittest_main()
 ```
 
-This test defines one `unittest` (a macro provided by `ArduionUnitTests.h`), called `your_test_name`, which makes some assertions on the target library.  The `int main` section is boilerplate.
+This test defines one `unittest` (a macro provided by `ArduionUnitTests.h`), called `your_test_name`, which makes some assertions on the target library.  The `unittest_main()` is a macro for the `int main()` boilerplate required for unit testing.
 
 
 ## More Documentation

SampleProjects/DoSomething/README.md

@@ -98,9 +98,7 @@ unittest(your_test_name)
   assertEqual(4, doSomething());
 }
 
-int main(int argc, char *argv[]) {
-  return Test::run_and_report(argc, argv);
-}
+unittest_main()
 ```
 
 This test defines one `unittest` (a macro provided by `ArduionUnitTests.h`), called `your_test_name`, which makes some assertions on the target library.  The `int main` section is boilerplate.

SampleProjects/DoSomething/test/good-library.cpp

@@ -6,6 +6,4 @@ unittest(library_does_something)
   assertEqual(4, doSomething());
 }
 
-int main(int argc, char *argv[]) {
-  return Test::run_and_report(argc, argv);
-}
+unittest_main()

SampleProjects/DoSomething/test/good-null.cpp

@@ -19,6 +19,4 @@ unittest(nothing)
 {
 }
 
-int main(int argc, char *argv[]) {
-  return Test::run_and_report(argc, argv);
-}
+unittest_main()

SampleProjects/TestSomething/test/bad-null.cpp

@@ -7,6 +7,4 @@ unittest(pretend_equal_things_arent)
   assertNotEqual(x, y);
 }
 
-int main(int argc, char *argv[]) {
-  return Test::run_and_report(argc, argv);
-}
+unittest_main()

SampleProjects/TestSomething/test/good-library.cpp

@@ -6,6 +6,4 @@ unittest(library_tests_something)
   assertEqual(4, testSomething());
 }
 
-int main(int argc, char *argv[]) {
-  return Test::run_and_report(argc, argv);
-}
+unittest_main()

SampleProjects/TestSomething/test/good-null.cpp

@@ -19,6 +19,4 @@ unittest(nothing)
 {
 }
 
-int main(int argc, char *argv[]) {
-  return Test::run_and_report(argc, argv);
-}
+unittest_main()

cpp/unittest/ArduinoUnitTests.h

@@ -216,3 +216,9 @@ class Test
     void task();                   \
   } test_##name##_instance;        \
   void test_##name ::task()
+
+
+#define unittest_main()                      \
+  int main(int argc, char *argv[]) {         \
+    return Test::run_and_report(argc, argv); \
+  }