UnitTestFrameworkPkg: Apply uncrustify changes

[mirror_edk2.git] / UnitTestFrameworkPkg / Library / UnitTestLib / Assert.c

/**\r
  Implement UnitTestLib assert services\r
\r
  Copyright (c) Microsoft Corporation.<BR>\r
  SPDX-License-Identifier: BSD-2-Clause-Patent\r
**/\r
\r
#include <Uefi.h>\r
#include <UnitTestFrameworkTypes.h>\r
#include <Library/UnitTestLib.h>\r
#include <Library/BaseLib.h>\r
#include <Library/BaseMemoryLib.h>\r
#include <Library/DebugLib.h>\r
#include <Library/PrintLib.h>\r
\r
extern BASE_LIBRARY_JUMP_BUFFER  gUnitTestJumpBuffer;\r
\r
STATIC\r
EFI_STATUS\r
AddUnitTestFailure (\r
  IN OUT UNIT_TEST     *UnitTest,\r
  IN     CONST CHAR8   *FailureMessage,\r
  IN     FAILURE_TYPE  FailureType\r
  )\r
{\r
  //\r
  // Make sure that you're cooking with gas.\r
  //\r
  if ((UnitTest == NULL) || (FailureMessage == NULL)) {\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  UnitTest->FailureType = FailureType;\r
  AsciiStrCpyS (\r
    &UnitTest->FailureMessage[0],\r
    UNIT_TEST_TESTFAILUREMSG_LENGTH,\r
    FailureMessage\r
    );\r
\r
  return EFI_SUCCESS;\r
}\r
\r
STATIC\r
VOID\r
EFIAPI\r
UnitTestLogFailure (\r
  IN FAILURE_TYPE  FailureType,\r
  IN CONST CHAR8   *Format,\r
  ...\r
  )\r
{\r
  UNIT_TEST_FRAMEWORK_HANDLE  FrameworkHandle;\r
  CHAR8                       LogString[UNIT_TEST_TESTFAILUREMSG_LENGTH];\r
  VA_LIST                     Marker;\r
\r
  //\r
  // Get active Framework handle\r
  //\r
  FrameworkHandle = GetActiveFrameworkHandle ();\r
\r
  //\r
  // Convert the message to an ASCII String\r
  //\r
  VA_START (Marker, Format);\r
  AsciiVSPrint (LogString, sizeof (LogString), Format, Marker);\r
  VA_END (Marker);\r
\r
  //\r
  // Finally, add the string to the log.\r
  //\r
  AddUnitTestFailure (\r
    ((UNIT_TEST_FRAMEWORK *)FrameworkHandle)->CurrentTest,\r
    LogString,\r
    FailureType\r
    );\r
\r
  LongJump (&gUnitTestJumpBuffer, 1);\r
}\r
\r
/**\r
  If Expression is TRUE, then TRUE is returned.\r
  If Expression is FALSE, then an assert is triggered and the location of the\r
  assert provided by FunctionName, LineNumber, FileName, and Description are\r
  recorded and FALSE is returned.\r
\r
  @param[in]  Expression    The BOOLEAN result of the expression evaluation.\r
  @param[in]  FunctionName  Null-terminated ASCII string of the function\r
                            executing the assert macro.\r
  @param[in]  LineNumber    The source file line number of the assert macro.\r
  @param[in]  FileName      Null-terminated ASCII string of the filename\r
                            executing the assert macro.\r
  @param[in]  Description   Null-terminated ASCII string of the expression being\r
                            evaluated.\r
\r
  @retval  TRUE   Expression is TRUE.\r
  @retval  FALSE  Expression is FALSE.\r
**/\r
BOOLEAN\r
EFIAPI\r
UnitTestAssertTrue (\r
  IN BOOLEAN      Expression,\r
  IN CONST CHAR8  *FunctionName,\r
  IN UINTN        LineNumber,\r
  IN CONST CHAR8  *FileName,\r
  IN CONST CHAR8  *Description\r
  )\r
{\r
  if (!Expression) {\r
    UT_LOG_ERROR (\r
      "[ASSERT FAIL] %a:%d: Expression (%a) is not TRUE!\n",\r
      FileName,\r
      LineNumber,\r
      Description\r
      );\r
    UnitTestLogFailure (\r
      FAILURETYPE_ASSERTTRUE,\r
      "%a:%d: Expression (%a) is not TRUE!\n",\r
      FileName,\r
      LineNumber,\r
      Description\r
      );\r
  }\r
\r
  return Expression;\r
}\r
\r
/**\r
  If Expression is FALSE, then TRUE is returned.\r
  If Expression is TRUE, then an assert is triggered and the location of the\r
  assert provided by FunctionName, LineNumber, FileName, and Description are\r
  recorded and FALSE is returned.\r
\r
  @param[in]  Expression    The BOOLEAN result of the expression evaluation.\r
  @param[in]  FunctionName  Null-terminated ASCII string of the function\r
                            executing the assert macro.\r
  @param[in]  LineNumber    The source file line number of the assert macro.\r
  @param[in]  FileName      Null-terminated ASCII string of the filename\r
                            executing the assert macro.\r
  @param[in]  Description   Null-terminated ASCII string of the expression being\r
                            evaluated.\r
\r
  @retval  TRUE   Expression is FALSE.\r
  @retval  FALSE  Expression is TRUE.\r
**/\r
BOOLEAN\r
EFIAPI\r
UnitTestAssertFalse (\r
  IN BOOLEAN      Expression,\r
  IN CONST CHAR8  *FunctionName,\r
  IN UINTN        LineNumber,\r
  IN CONST CHAR8  *FileName,\r
  IN CONST CHAR8  *Description\r
  )\r
{\r
  if (Expression) {\r
    UT_LOG_ERROR (\r
      "[ASSERT FAIL] %a:%d: Expression (%a) is not FALSE!\n",\r
      FileName,\r
      LineNumber,\r
      Description\r
      );\r
    UnitTestLogFailure (\r
      FAILURETYPE_ASSERTFALSE,\r
      "%a:%d: Expression(%a) is not FALSE!\n",\r
      FileName,\r
      LineNumber,\r
      Description\r
      );\r
  }\r
\r
  return !Expression;\r
}\r
\r
/**\r
  If Status is not an EFI_ERROR(), then TRUE is returned.\r
  If Status is an EFI_ERROR(), then an assert is triggered and the location of\r
  the assert provided by FunctionName, LineNumber, FileName, and Description are\r
  recorded and FALSE is returned.\r
\r
  @param[in]  Status        The EFI_STATUS value to evaluate.\r
  @param[in]  FunctionName  Null-terminated ASCII string of the function\r
                            executing the assert macro.\r
  @param[in]  LineNumber    The source file line number of the assert macro.\r
  @param[in]  FileName      Null-terminated ASCII string of the filename\r
                            executing the assert macro.\r
  @param[in]  Description   Null-terminated ASCII string of the status\r
                            expression being evaluated.\r
\r
  @retval  TRUE   Status is not an EFI_ERROR().\r
  @retval  FALSE  Status is an EFI_ERROR().\r
**/\r
BOOLEAN\r
EFIAPI\r
UnitTestAssertNotEfiError (\r
  IN EFI_STATUS   Status,\r
  IN CONST CHAR8  *FunctionName,\r
  IN UINTN        LineNumber,\r
  IN CONST CHAR8  *FileName,\r
  IN CONST CHAR8  *Description\r
  )\r
{\r
  if (EFI_ERROR (Status)) {\r
    UT_LOG_ERROR (\r
      "[ASSERT FAIL] %a:%d: Status '%a' is EFI_ERROR (%r)!\n",\r
      FileName,\r
      LineNumber,\r
      Description,\r
      Status\r
      );\r
    UnitTestLogFailure (\r
      FAILURETYPE_ASSERTNOTEFIERROR,\r
      "%a:%d: Status '%a' is EFI_ERROR (%r)!\n",\r
      FileName,\r
      LineNumber,\r
      Description,\r
      Status\r
      );\r
  }\r
\r
  return !EFI_ERROR (Status);\r
}\r
\r
/**\r
  If ValueA is equal ValueB, then TRUE is returned.\r
  If ValueA is not equal to ValueB, then an assert is triggered and the location\r
  of the assert provided by FunctionName, LineNumber, FileName, DescriptionA,\r
  and DescriptionB are recorded and FALSE is returned.\r
\r
  @param[in]  ValueA        64-bit value.\r
  @param[in]  ValueB        64-bit value.\r
  @param[in]  FunctionName  Null-terminated ASCII string of the function\r
                            executing the assert macro.\r
  @param[in]  LineNumber    The source file line number of the assert macro.\r
  @param[in]  FileName      Null-terminated ASCII string of the filename\r
                            executing the assert macro.\r
  @param[in]  DescriptionA  Null-terminated ASCII string that is a description\r
                            of ValueA.\r
  @param[in]  DescriptionB  Null-terminated ASCII string that is a description\r
                            of ValueB.\r
\r
  @retval  TRUE   ValueA is equal to ValueB.\r
  @retval  FALSE  ValueA is not equal to ValueB.\r
**/\r
BOOLEAN\r
EFIAPI\r
UnitTestAssertEqual (\r
  IN UINT64       ValueA,\r
  IN UINT64       ValueB,\r
  IN CONST CHAR8  *FunctionName,\r
  IN UINTN        LineNumber,\r
  IN CONST CHAR8  *FileName,\r
  IN CONST CHAR8  *DescriptionA,\r
  IN CONST CHAR8  *DescriptionB\r
  )\r
{\r
  if (ValueA != ValueB) {\r
    UT_LOG_ERROR (\r
      "[ASSERT FAIL] %a:%d: Value %a != %a (%d != %d)!\n",\r
      FileName,\r
      LineNumber,\r
      DescriptionA,\r
      DescriptionB,\r
      ValueA,\r
      ValueB\r
      );\r
    UnitTestLogFailure (\r
      FAILURETYPE_ASSERTEQUAL,\r
      "%a:%d: Value %a != %a (%d != %d)!\n",\r
      FileName,\r
      LineNumber,\r
      DescriptionA,\r
      DescriptionB,\r
      ValueA,\r
      ValueB\r
      );\r
  }\r
\r
  return (ValueA == ValueB);\r
}\r
\r
/**\r
  If the contents of BufferA are identical to the contents of BufferB, then TRUE\r
  is returned.  If the contents of BufferA are not identical to the contents of\r
  BufferB, then an assert is triggered and the location of the assert provided\r
  by FunctionName, LineNumber, FileName, DescriptionA, and DescriptionB are\r
  recorded and FALSE is returned.\r
\r
  @param[in]  BufferA       Pointer to a buffer for comparison.\r
  @param[in]  BufferB       Pointer to a buffer for comparison.\r
  @param[in]  Length        Number of bytes to compare in BufferA and BufferB.\r
  @param[in]  FunctionName  Null-terminated ASCII string of the function\r
                            executing the assert macro.\r
  @param[in]  LineNumber    The source file line number of the assert macro.\r
  @param[in]  FileName      Null-terminated ASCII string of the filename\r
                            executing the assert macro.\r
  @param[in]  DescriptionA  Null-terminated ASCII string that is a description\r
                            of BufferA.\r
  @param[in]  DescriptionB  Null-terminated ASCII string that is a description\r
                            of BufferB.\r
\r
  @retval  TRUE   The contents of BufferA are identical to the contents of\r
                  BufferB.\r
  @retval  FALSE  The contents of BufferA are not identical to the contents of\r
                  BufferB.\r
**/\r
BOOLEAN\r
EFIAPI\r
UnitTestAssertMemEqual (\r
  IN VOID         *BufferA,\r
  IN VOID         *BufferB,\r
  IN UINTN        Length,\r
  IN CONST CHAR8  *FunctionName,\r
  IN UINTN        LineNumber,\r
  IN CONST CHAR8  *FileName,\r
  IN CONST CHAR8  *DescriptionA,\r
  IN CONST CHAR8  *DescriptionB\r
  )\r
{\r
  if (CompareMem (BufferA, BufferB, Length) != 0) {\r
    UT_LOG_ERROR (\r
      "[ASSERT FAIL] %a:%d: Value %a != %a for length %d bytes!\n",\r
      FileName,\r
      LineNumber,\r
      DescriptionA,\r
      DescriptionB,\r
      Length\r
      );\r
    UnitTestLogFailure (\r
      FAILURETYPE_ASSERTEQUAL,\r
      "%a:%d: Memory at %a != %a for length %d bytes!\n",\r
      FileName,\r
      LineNumber,\r
      DescriptionA,\r
      DescriptionB,\r
      Length\r
      );\r
    return FALSE;\r
  }\r
\r
  return TRUE;\r
}\r
\r
/**\r
  If ValueA is not equal ValueB, then TRUE is returned.\r
  If ValueA is equal to ValueB, then an assert is triggered and the location\r
  of the assert provided by FunctionName, LineNumber, FileName, DescriptionA\r
  and DescriptionB are recorded and FALSE is returned.\r
\r
  @param[in]  ValueA        64-bit value.\r
  @param[in]  ValueB        64-bit value.\r
  @param[in]  FunctionName  Null-terminated ASCII string of the function\r
                            executing the assert macro.\r
  @param[in]  LineNumber    The source file line number of the assert macro.\r
  @param[in]  FileName      Null-terminated ASCII string of the filename\r
                            executing the assert macro.\r
  @param[in]  DescriptionA  Null-terminated ASCII string that is a description\r
                            of ValueA.\r
  @param[in]  DescriptionB  Null-terminated ASCII string that is a description\r
                            of ValueB.\r
\r
  @retval  TRUE   ValueA is not equal to ValueB.\r
  @retval  FALSE  ValueA is equal to ValueB.\r
**/\r
BOOLEAN\r
EFIAPI\r
UnitTestAssertNotEqual (\r
  IN UINT64       ValueA,\r
  IN UINT64       ValueB,\r
  IN CONST CHAR8  *FunctionName,\r
  IN UINTN        LineNumber,\r
  IN CONST CHAR8  *FileName,\r
  IN CONST CHAR8  *DescriptionA,\r
  IN CONST CHAR8  *DescriptionB\r
  )\r
{\r
  if (ValueA == ValueB) {\r
    UT_LOG_ERROR (\r
      "[ASSERT FAIL] %a:%d: Value %a == %a (%d == %d)!\n",\r
      FileName,\r
      LineNumber,\r
      DescriptionA,\r
      DescriptionB,\r
      ValueA,\r
      ValueB\r
      );\r
    UnitTestLogFailure (\r
      FAILURETYPE_ASSERTNOTEQUAL,\r
      "%a:%d: Value %a == %a (%d == %d)!\n",\r
      FileName,\r
      LineNumber,\r
      DescriptionA,\r
      DescriptionB,\r
      ValueA,\r
      ValueB\r
      );\r
  }\r
\r
  return (ValueA != ValueB);\r
}\r
\r
/**\r
  If Status is equal to Expected, then TRUE is returned.\r
  If Status is not equal to Expected, then an assert is triggered and the\r
  location of the assert provided by FunctionName, LineNumber, FileName, and\r
  Description are recorded and FALSE is returned.\r
\r
  @param[in]  Status        EFI_STATUS value returned from an API under test.\r
  @param[in]  Expected      The expected EFI_STATUS return value from an API\r
                            under test.\r
  @param[in]  FunctionName  Null-terminated ASCII string of the function\r
                            executing the assert macro.\r
  @param[in]  LineNumber    The source file line number of the assert macro.\r
  @param[in]  FileName      Null-terminated ASCII string of the filename\r
                            executing the assert macro.\r
  @param[in]  Description   Null-terminated ASCII string that is a description\r
                            of Status.\r
\r
  @retval  TRUE   Status is equal to Expected.\r
  @retval  FALSE  Status is not equal to Expected.\r
**/\r
BOOLEAN\r
EFIAPI\r
UnitTestAssertStatusEqual (\r
  IN EFI_STATUS   Status,\r
  IN EFI_STATUS   Expected,\r
  IN CONST CHAR8  *FunctionName,\r
  IN UINTN        LineNumber,\r
  IN CONST CHAR8  *FileName,\r
  IN CONST CHAR8  *Description\r
  )\r
{\r
  if (Status != Expected) {\r
    UT_LOG_ERROR (\r
      "[ASSERT FAIL] %a:%d: Status '%a' is %r, should be %r!\n",\r
      FileName,\r
      LineNumber,\r
      Description,\r
      Status,\r
      Expected\r
      );\r
    UnitTestLogFailure (\r
      FAILURETYPE_ASSERTSTATUSEQUAL,\r
      "%a:%d: Status '%a' is %r, should be %r!\n",\r
      FileName,\r
      LineNumber,\r
      Description,\r
      Status,\r
      Expected\r
      );\r
  }\r
\r
  return (Status == Expected);\r
}\r
\r
/**\r
  If Pointer is not equal to NULL, then TRUE is returned.\r
  If Pointer is equal to NULL, then an assert is triggered and the location of\r
  the assert provided by FunctionName, LineNumber, FileName, and PointerName\r
  are recorded and FALSE is returned.\r
\r
  @param[in]  Pointer       Pointer value to be checked against NULL.\r
  @param[in]  Expected      The expected EFI_STATUS return value from a function\r
                            under test.\r
  @param[in]  FunctionName  Null-terminated ASCII string of the function\r
                            executing the assert macro.\r
  @param[in]  LineNumber    The source file line number of the assert macro.\r
  @param[in]  FileName      Null-terminated ASCII string of the filename\r
                            executing the assert macro.\r
  @param[in]  PointerName   Null-terminated ASCII string that is a description\r
                            of Pointer.\r
\r
  @retval  TRUE   Pointer is not equal to NULL.\r
  @retval  FALSE  Pointer is equal to NULL.\r
**/\r
BOOLEAN\r
EFIAPI\r
UnitTestAssertNotNull (\r
  IN VOID         *Pointer,\r
  IN CONST CHAR8  *FunctionName,\r
  IN UINTN        LineNumber,\r
  IN CONST CHAR8  *FileName,\r
  IN CONST CHAR8  *PointerName\r
  )\r
{\r
  if (Pointer == NULL) {\r
    UT_LOG_ERROR (\r
      "[ASSERT FAIL] %a:%d: Pointer (%a) is NULL!\n",\r
      FileName,\r
      LineNumber,\r
      PointerName\r
      );\r
    UnitTestLogFailure (\r
      FAILURETYPE_ASSERTNOTNULL,\r
      "%a:%d: Pointer (%a) is NULL!\n",\r
      FileName,\r
      LineNumber,\r
      PointerName\r
      );\r
  }\r
\r
  return (Pointer != NULL);\r
}\r
\r
/**\r
  If UnitTestStatus is UNIT_TEST_PASSED, then log an info message and return\r
  TRUE because an ASSERT() was expected when FunctionCall was executed and an\r
  ASSERT() was triggered. If UnitTestStatus is UNIT_TEST_SKIPPED, then log a\r
  warning message and return TRUE because ASSERT() macros are disabled.  If\r
  UnitTestStatus is UNIT_TEST_ERROR_TEST_FAILED, then log an error message and\r
  return FALSE because an ASSERT() was expected when FunctionCall was executed,\r
  but no ASSERT() conditions were triggered.  The log messages contain\r
  FunctionName, LineNumber, and FileName strings to provide the location of the\r
  UT_EXPECT_ASSERT_FAILURE() macro.\r
\r
  @param[in]  UnitTestStatus  The status from UT_EXPECT_ASSERT_FAILURE() that\r
                              is either pass, skipped, or failed.\r
  @param[in]  FunctionName    Null-terminated ASCII string of the function\r
                              executing the UT_EXPECT_ASSERT_FAILURE() macro.\r
  @param[in]  LineNumber      The source file line number of the the function\r
                              executing the UT_EXPECT_ASSERT_FAILURE() macro.\r
  @param[in]  FileName        Null-terminated ASCII string of the filename\r
                              executing the UT_EXPECT_ASSERT_FAILURE() macro.\r
  @param[in]  FunctionCall    Null-terminated ASCII string of the function call\r
                              executed by the UT_EXPECT_ASSERT_FAILURE() macro.\r
  @param[out] ResultStatus    Used to return the UnitTestStatus value to the\r
                              caller of UT_EXPECT_ASSERT_FAILURE().  This is\r
                              optional parameter that may be NULL.\r
\r
  @retval  TRUE   UnitTestStatus is UNIT_TEST_PASSED.\r
  @retval  TRUE   UnitTestStatus is UNIT_TEST_SKIPPED.\r
  @retval  FALSE  UnitTestStatus is UNIT_TEST_ERROR_TEST_FAILED.\r
**/\r
BOOLEAN\r
EFIAPI\r
UnitTestExpectAssertFailure (\r
  IN  UNIT_TEST_STATUS  UnitTestStatus,\r
  IN  CONST CHAR8       *FunctionName,\r
  IN  UINTN             LineNumber,\r
  IN  CONST CHAR8       *FileName,\r
  IN  CONST CHAR8       *FunctionCall,\r
  OUT UNIT_TEST_STATUS  *ResultStatus  OPTIONAL\r
  )\r
{\r
  if (ResultStatus != NULL) {\r
    *ResultStatus = UnitTestStatus;\r
  }\r
\r
  if (UnitTestStatus == UNIT_TEST_PASSED) {\r
    UT_LOG_INFO (\r
      "[ASSERT PASS] %a:%d: UT_EXPECT_ASSERT_FAILURE(%a) detected expected assert\n",\r
      FileName,\r
      LineNumber,\r
      FunctionCall\r
      );\r
  }\r
\r
  if (UnitTestStatus == UNIT_TEST_SKIPPED) {\r
    UT_LOG_WARNING (\r
      "[ASSERT WARN] %a:%d: UT_EXPECT_ASSERT_FAILURE(%a) disabled\n",\r
      FileName,\r
      LineNumber,\r
      FunctionCall\r
      );\r
  }\r
\r
  if (UnitTestStatus == UNIT_TEST_ERROR_TEST_FAILED) {\r
    UT_LOG_ERROR (\r
      "[ASSERT FAIL] %a:%d: Function call (%a) did not ASSERT()!\n",\r
      FileName,\r
      LineNumber,\r
      FunctionCall\r
      );\r
    UnitTestLogFailure (\r
      FAILURETYPE_EXPECTASSERT,\r
      "%a:%d: Function call (%a) did not ASSERT()!\n",\r
      FileName,\r
      LineNumber,\r
      FunctionCall\r
      );\r
  }\r
\r
  return (UnitTestStatus != UNIT_TEST_ERROR_TEST_FAILED);\r
}\r