/core/src/aos_test.c - Annotate - AMiRo-OS - Research for Cognitive Interaction

amiro-os / core / src / aos_test.c @ 4c72a54c

History | View | Annotate | Download (8.243 KB)

-            e545e620
+/*
 AMiRo-OS is an operating system designed for the Autonomous Mini Robot (AMiRo) platform.
-f0ce9e
+Copyright (C) 2016..2019  Thomas Schöpping et al.
-            e545e620
+            Thomas Schöpping
 This program is free software: you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
 the Free Software Foundation, either version 3 of the License, or
 (at your option) any later version.
 This program is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 GNU General Public License for more details.
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */
-ca3
+/**
-c72a54c
+ * @file    aos_test.c
  * @brief   Test code.
  * @details Functions to initialize and run tests,
  *          as well as utility functions to be used in tests.
-ca3
+            Marc Rothmann
-c72a54c
+ * @addtogroup aos_tests
-ca3
+ * @{
  */
-ba8a
+#include <amiroos.h>
-            e545e620
+            Thomas Schöpping
-            bc5cdb79
+#if (AMIROOS_CFG_TESTS_ENABLE == true) || defined(__DOXYGEN__)
-ba8a
+            Thomas Schöpping
-c72a54c
+#include <string.h>
 #include <stdarg.h>
-            f3ac1c96
+/******************************************************************************/
 /* LOCAL DEFINITIONS                                                          */
 /******************************************************************************/
 /******************************************************************************/
 /* EXPORTED VARIABLES                                                         */
 /******************************************************************************/
 /******************************************************************************/
 /* LOCAL TYPES                                                                */
 /******************************************************************************/
 /******************************************************************************/
 /* LOCAL VARIABLES                                                            */
 /******************************************************************************/
 /******************************************************************************/
 /* LOCAL FUNCTIONS                                                            */
 /******************************************************************************/
 /******************************************************************************/
 /* EXPORTED FUNCTIONS                                                         */
 /******************************************************************************/
-            e545e620
+            Thomas Schöpping
 /**
-c72a54c
+ * @brief   Adds two result objects.
+ *
  * @param[in] a   The first summand.
  * @param[in] b   The second summand.
+ *
  * @return    Resulting sum of both summands added.
  */
 inline aos_testresult_t aosTestResultAdd(aos_testresult_t a, aos_testresult_t b)
+{
   a.passed += b.passed;
   a.failed += b.failed;
   return a;
+}
 /**
-            e545e620
+ * @brief   Retrieve the total number of tests (passed and failed).
+ *
  * @param[in] result    The result object to evaluate.
+ *
  * @return  Number of total tests executed.
  */
-c72a54c
+inline uint32_t aosTestResultTotal(const aos_testresult_t* result)
-            e545e620
+            Thomas Schöpping
   aosDbgCheck(result != NULL);
   return result->passed + result->failed;
+}
 /**
  * @brief   Retrieve the ratio of passed tests.
+ *
  * @param[in] result    The result object to evaluate.
+ *
  * @return  Ratio of passed tests to total tests as float in range [0, 1].
  */
-c72a54c
+inline float aosTestResultRatio(const aos_testresult_t *result)
-            e545e620
+            Thomas Schöpping
   aosDbgCheck(result != NULL);
-c72a54c
+  if (aosTestResultTotal(result) > 0) {
     return (float)result->passed / (float)(aosTestResultTotal(result));
-            e545e620
+  } else {
     return 1.0f;
+  }
+}
 /**
  * @brief   Print the summary of a test.
  * @details The summary consists of:
  *          - total numer of tests executed
  *          - absolute number of passed tests
  *          - absolute number of failed tests
  *          - relative ratio of passed tests
+ *
  * @param[in] stream    Stream to print the result to.
  * @param[in] result    Result to evaluate and print.
  * @param[in] heading   Optional heading (defaults to "summary").
  */
-c72a54c
+void aosTestResultPrintSummary(BaseSequentialStream *stream, const aos_testresult_t* result, const char* heading)
-            e545e620
+            Thomas Schöpping
   aosDbgCheck(stream != NULL);
   aosDbgCheck(result != NULL);
   chprintf(stream, "%s:\n", (heading != NULL) ? heading : "summary");
-c72a54c
+  chprintf(stream, "\ttotal:  %3u\n", aosTestResultTotal(result));
-            e545e620
+  chprintf(stream, "\tpassed: %3u\n", result->passed);
   chprintf(stream, "\tfailed: %3u\n", result->failed);
-c72a54c
+  chprintf(stream, "\tratio:  %3u%%\n", (uint8_t)(aosTestResultRatio(result) * 100.0f)); // implicitly rounded off by cast to integer
-            e545e620
+            Thomas Schöpping
   return;
+}
 /**
-c72a54c
+ * @brief   Run a test.
-            e545e620
+            Thomas Schöpping
  * @param[in] stream  A stream for printing messages.
-c72a54c
+ * @param[in] test    Test to execute.
-            e545e620
+ * @param[in] note    Optional note string.
+ *
  * @return    Result of the test.
  */
-c72a54c
+aos_testresult_t aosTestRun(BaseSequentialStream *stream, const aos_test_t *test, const char* note)
-            e545e620
+            Thomas Schöpping
   aosDbgCheck(stream != NULL);
-c72a54c
+  aosDbgCheck(test != NULL);
-            e545e620
+            Thomas Schöpping
   // print name heading
+  {
     chprintf(stream, "\n");
-c72a54c
+    const int nchars = chprintf(stream, "%s test\n", test->name);
-            e545e620
+    for (int c = 0; c < nchars-1; ++c) {
       chprintf(stream, "=");
+    }
     chprintf(stream, "\n");
+  }
   // print info (if any)
-c72a54c
+  if (test->info != NULL) {
     chprintf(stream, "info: %s\n", test->info);
-            e545e620
+            Thomas Schöpping
   // print note (if any)
   if (note != NULL) {
     chprintf(stream, "note: %s\n", note);
+  }
   chprintf(stream, "\n");
   // run test
-c72a54c
+  aos_testresult_t result = test->testfunc(stream, test);
-            e545e620
+            Thomas Schöpping
   // print summary
-c72a54c
+  aosTestResultPrintSummary(stream, &result, NULL);
-            e545e620
+            Thomas Schöpping
   return result;
+}
 /**
  * @brief   Helper function for passed tests.
  * @details Prints a message that the test was passed and modifies the result accordigly.
+ *
  * @param[in] stream      Stream to print the message to.
  * @param[in,out] result  Result object to modify.
  */
-c72a54c
+void aosTestPassed(BaseSequentialStream *stream, aos_testresult_t* result)
-            e545e620
+            Thomas Schöpping
   aosDbgCheck(stream != NULL);
   aosDbgCheck(result != NULL);
   ++result->passed;
   chprintf(stream, "\tPASSED\n");
   chprintf(stream, "\n");
   return;
+}
 /**
  * @brief   Helper function for passed tests.
  * @details Prints a message that the test was passed, an additional custom message, and modifies the result accordigly.
+ *
  * @param[in] stream      Stream to print the message to.
  * @param[in,out] result  Result object to modify.
  * @param[in] fmt         Formatted message string.
  */
-c72a54c
+void aosTestPassedMsg(BaseSequentialStream *stream, aos_testresult_t* result, const char *fmt, ...)
-            e545e620
+            Thomas Schöpping
   aosDbgCheck(stream != NULL);
   aosDbgCheck(result != NULL);
   va_list ap;
   ++result->passed;
   chprintf(stream, "\tPASSED\t");
   va_start(ap, fmt);
   chvprintf(stream, fmt, ap);
   va_end(ap);
   chprintf(stream, "\n");
   return;
+}
 /**
  * @brief   Helper function for failed tests.
  * @details Prints a message that the test was failed and modifies the result accordigly.
+ *
  * @param[in] stream      Stream to print the message to.
  * @param[in,out] result  Result object to modify.
  */
-c72a54c
+void aosTestFailed(BaseSequentialStream *stream, aos_testresult_t* result)
-            e545e620
+            Thomas Schöpping
   aosDbgCheck(stream != NULL);
   aosDbgCheck(result != NULL);
   ++result->failed;
   chprintf(stream, "\tFAILED\n");
   chprintf(stream, "\n");
   return;
+}
 /**
  * @brief   Helper function for failed tests.
  * @details Prints a message that the test was failed, an additional custom message, and modifies the result accordigly.
+ *
  * @param[in] stream      Stream to print the message to.
  * @param[in,out] result  Result object to modify.
  * @param[in] fmt         Formatted message string.
  */
-c72a54c
+void aosTestFailedMsg(BaseSequentialStream *stream, aos_testresult_t* result, const char *fmt, ...)
-            e545e620
+            Thomas Schöpping
   aosDbgCheck(stream != NULL);
   aosDbgCheck(result != NULL);
   va_list ap;
   ++result->failed;
   chprintf(stream, "\tFAILED\t");
   va_start(ap, fmt);
   chvprintf(stream, fmt, ap);
   va_end(ap);
   chprintf(stream, "\n");
   return;
+}
 /**
  * @brief   Helper function for information messages.
+ *
  * @param[in] stream  Strean to rpint the message to.
  * @param[in] fmt     Formatted message string.
  */
-c72a54c
+void aosTestInfoMsg(BaseSequentialStream* stream, const char* fmt, ...)
-            e545e620
+            Thomas Schöpping
   aosDbgCheck(stream != NULL);
   va_list ap;
   va_start(ap, fmt);
   chvprintf(stream, fmt, ap);
   va_end(ap);
   chprintf(stream, "\n");
   return;
+}
-de0cc90
+#endif /* (AMIROOS_CFG_TESTS_ENABLE == true) */
-ca3
+            Marc Rothmann
 /** @} */