framework_backend.h

// Copyright 2020 The Pigweed Authors
//
// Licensed under the Apache License, Version 2.0 (the "License"); you may not
// use this file except in compliance with the License. You may obtain a copy of
// the License at
//
//     https://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
// WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
// License for the specific language governing permissions and limitations under
// the License.
#pragma once
 
// IWYU pragma: private, include "pw_unit_test/framework.h"
 
#if defined(GTEST_TEST)
#error \
    "GTEST_TEST is already defined. Make sure googletest headers are not " \
       "included when using the pw_unit_test light backend."
#endif  // GTEST_TEST
 
#include <cstddef>
#include <cstdint>
#include <cstring>
#include <new>
#include <string_view>
 
#include "pw_bytes/alignment.h"
#include "pw_polyfill/standard.h"
#include "pw_preprocessor/compiler.h"
#include "pw_preprocessor/util.h"
#include "pw_span/span.h"
#include "pw_status/status.h"
#include "pw_string/string_builder.h"
#include "pw_unit_test/config.h"
#include "pw_unit_test/event_handler.h"
 
#define GTEST_TEST(test_suite_name, test_name)                           \
  _PW_TEST_SUITE_NAMES_MUST_BE_UNIQUE(void /* TEST */, test_suite_name); \
  _PW_TEST(test_suite_name, test_name, ::pw::unit_test::internal::Test)
 
#if !(defined(GTEST_DONT_DEFINE_TEST) && GTEST_DONT_DEFINE_TEST)
#define TEST(test_suite_name, test_name) GTEST_TEST(test_suite_name, test_name)
#endif  // !GTEST_DONT_DEFINE_TEST
 
#define TEST_F(test_fixture, test_name)                                \
  _PW_TEST_SUITE_NAMES_MUST_BE_UNIQUE(int /* TEST_F */, test_fixture); \
  _PW_TEST(test_fixture, test_name, test_fixture)
 
#define FRIEND_TEST(test_suite_name, test_name) \
  friend class test_suite_name##_##test_name##_Test
 
#define EXPECT_TRUE(expr) _PW_TEST_EXPECT(_PW_TEST_BOOL(expr, true))
 
#define EXPECT_FALSE(expr) _PW_TEST_EXPECT(_PW_TEST_BOOL(expr, false))
 
#define EXPECT_EQ(lhs, rhs) _PW_TEST_EXPECT(_PW_TEST_OP(lhs, rhs, ==))
 
 
#define EXPECT_NE(lhs, rhs) _PW_TEST_EXPECT(_PW_TEST_OP(lhs, rhs, !=))
 
#define EXPECT_GT(lhs, rhs) _PW_TEST_EXPECT(_PW_TEST_OP(lhs, rhs, >))
 
#define EXPECT_GE(lhs, rhs) _PW_TEST_EXPECT(_PW_TEST_OP(lhs, rhs, >=))
 
#define EXPECT_LT(lhs, rhs) _PW_TEST_EXPECT(_PW_TEST_OP(lhs, rhs, <))
 
#define EXPECT_LE(lhs, rhs) _PW_TEST_EXPECT(_PW_TEST_OP(lhs, rhs, <=))
 
#define EXPECT_NEAR(lhs, rhs, epsilon) \
  _PW_TEST_EXPECT(_PW_TEST_NEAR(lhs, rhs, epsilon))
 
#define EXPECT_FLOAT_EQ(lhs, rhs) \
  _PW_TEST_EXPECT(                \
      _PW_TEST_NEAR(lhs, rhs, 4 * std::numeric_limits<float>::epsilon()))
 
#define EXPECT_DOUBLE_EQ(lhs, rhs) \
  _PW_TEST_EXPECT(                 \
      _PW_TEST_NEAR(lhs, rhs, 4 * std::numeric_limits<double>::epsilon()))
 
#define EXPECT_STREQ(lhs, rhs) _PW_TEST_EXPECT(_PW_TEST_C_STR(lhs, rhs, ==))
 
#define EXPECT_STRNE(lhs, rhs) _PW_TEST_EXPECT(_PW_TEST_C_STR(lhs, rhs, !=))
 
#define ASSERT_TRUE(expr) _PW_TEST_ASSERT(_PW_TEST_BOOL(expr, true))
 
#define ASSERT_FALSE(expr) _PW_TEST_ASSERT(_PW_TEST_BOOL(expr, false))
 
#define ASSERT_EQ(lhs, rhs) _PW_TEST_ASSERT(_PW_TEST_OP(lhs, rhs, ==))
 
#define ASSERT_NE(lhs, rhs) _PW_TEST_ASSERT(_PW_TEST_OP(lhs, rhs, !=))
 
#define ASSERT_GT(lhs, rhs) _PW_TEST_ASSERT(_PW_TEST_OP(lhs, rhs, >))
 
#define ASSERT_GE(lhs, rhs) _PW_TEST_ASSERT(_PW_TEST_OP(lhs, rhs, >=))
 
#define ASSERT_LT(lhs, rhs) _PW_TEST_ASSERT(_PW_TEST_OP(lhs, rhs, <))
 
#define ASSERT_LE(lhs, rhs) _PW_TEST_ASSERT(_PW_TEST_OP(lhs, rhs, <=))
 
#define ASSERT_NEAR(lhs, rhs, epsilon) \
  _PW_TEST_ASSERT(_PW_TEST_NEAR(lhs, rhs, epsilon))
 
#define ASSERT_FLOAT_EQ(lhs, rhs) \
  _PW_TEST_ASSERT(                \
      _PW_TEST_NEAR(lhs, rhs, 4 * std::numeric_limits<float>::epsilon()))
 
#define ASSERT_DOUBLE_EQ(lhs, rhs) \
  _PW_TEST_ASSERT(                 \
      _PW_TEST_NEAR(lhs, rhs, 4 * std::numeric_limits<double>::epsilon()))
 
#define ASSERT_STREQ(lhs, rhs) _PW_TEST_ASSERT(_PW_TEST_C_STR(lhs, rhs, ==))
 
#define ASSERT_STRNE(lhs, rhs) _PW_TEST_ASSERT(_PW_TEST_C_STR(lhs, rhs, !=))
 
#define ADD_FAILURE()                                                      \
  ::pw::unit_test::internal::ReturnHelper() =                              \
      ::pw::unit_test::internal::Framework::Get().CurrentTestExpectSimple( \
          "(line is not executed)", "(line was executed)", __LINE__, false)
 
#define GTEST_FAIL() return ADD_FAILURE()
 
#define GTEST_SKIP()                                                      \
  return ::pw::unit_test::internal::ReturnHelper() =                      \
             ::pw::unit_test::internal::Framework::Get().CurrentTestSkip( \
                 __LINE__)
 
#if !(defined(GTEST_DONT_DEFINE_FAIL) && GTEST_DONT_DEFINE_FAIL)
#define FAIL() GTEST_FAIL()
#endif  // !GTEST_DONT_DEFINE_FAIL
 
#define GTEST_SUCCEED()                                                \
  ::pw::unit_test::internal::Framework::Get().CurrentTestExpectSimple( \
      "(success)", "(success)", __LINE__, true)
 
#if !(defined(GTEST_DONT_DEFINE_SUCCEED) && GTEST_DONT_DEFINE_SUCCEED)
#define SUCCEED() GTEST_SUCCEED()
#endif  // !GTEST_DONT_DEFINE_SUCCEED
 
// TODO: https://pwbug.dev/441096262 - Add SCOPED_TRACE support.
#define SCOPED_TRACE(message)
 
int RUN_ALL_TESTS();
 
#define GTEST_HAS_DEATH_TEST 0
 
#define EXPECT_DEATH_IF_SUPPORTED(statement, regex) \
  if (0) {                                          \
    static_cast<void>(statement);                   \
    static_cast<void>(regex);                       \
  }                                                 \
  static_assert(true, "Macros must be terminated with a semicolon")
 
#define ASSERT_DEATH_IF_SUPPORTED(statement, regex) \
  EXPECT_DEATH_IF_SUPPORTED(statement, regex)
 
namespace pw {
namespace string {
 
// This function is used to print unknown types that are used in EXPECT or
// ASSERT statements in tests.
//
// You can add support for displaying custom types by defining a ToString
// template specialization. For example:
//
//   namespace pw {
//
//   template <>
//   StatusWithSize ToString<MyType>(const MyType& value,
//                                   span<char> buffer) {
//     return string::Format("<MyType|%d>", value.id);
//   }
//
//   }  // namespace pw
//
// See the documentation in pw_string/string_builder.h for more information.
template <typename T>
StatusWithSize UnknownTypeToString(const T& value, span<char> buffer) {
  StringBuilder sb(buffer);
  sb << '<' << sizeof(value) << "-byte object at 0x" << &value;
 
  // How many bytes of the object to print.
  //
  // WARNING: Printing the contents of an object may be undefined behavior!
  // Accessing uninitialized memory is undefined behavior, and objects
  // sometimes contain uninitialized regions, such as padding bytes or
  // unallocated storage (e.g. std::optional). kPrintMaybeUninitializedBytes
  // MUST stay at 0, except when changed locally to help with debugging.
  constexpr size_t kPrintMaybeUnintializedBytes = 0;
 
  constexpr size_t kBytesToPrint =
      std::min(sizeof(value), kPrintMaybeUnintializedBytes);
 
  if (kBytesToPrint != 0u) {
    sb << " |";
 
    // reinterpret_cast to std::byte is permitted by C++'s type aliasing
    // rules.
    const std::byte* bytes = reinterpret_cast<const std::byte*>(&value);
 
    for (size_t i = 0; i < kBytesToPrint; ++i) {
      sb << ' ' << bytes[i];
    }
 
    // If there's just one more byte, output it. Otherwise, output ellipsis.
    if (sizeof(value) == kBytesToPrint + 1) {
      sb << ' ' << bytes[sizeof(value) - 1];
    } else if (sizeof(value) > kBytesToPrint) {
      sb << " …";
    }
  }
 
  sb << '>';
  return sb.status_with_size();
}
 
}  // namespace string
 
namespace unit_test {
namespace internal {
 
class Test;
class TestInfo;
 
// Types of SetUpTestSuite() and TearDownTestSuite() functions.
using SetUpTestSuiteFunc = void (*)();
using TearDownTestSuiteFunc = void (*)();
 
// Used to tag arguments to EXPECT_STREQ/EXPECT_STRNE so they are treated like
// C strings rather than pointers.
struct CStringArg {
  const char* const c_str;
};
 
constexpr size_t MaxPaddingNeededToRaiseAlignment(size_t current_align,
                                                  size_t new_align) {
  if (new_align < current_align) {
    return 0;
  }
  return new_align - current_align;
}
 
// GoogleTest supports stream-style messages, but pw_unit_test does not. This
// class accepts and ignores C++ <<-style logs.
class FailureMessageAdapter {
 public:
  constexpr FailureMessageAdapter() = default;
 
  template <typename T>
  constexpr const FailureMessageAdapter& operator<<(const T&) const {
    return *this;
  }
};
 
// Used to ignore a stream-style message in an assert, which returns. This
// uses a similar approach as upstream GoogleTest, but drops any messages.
class ReturnHelper {
 public:
  constexpr ReturnHelper() = default;
 
  // Return void so that assigning to ReturnHelper converts the log expression
  // to void without blocking the stream-style log with a closing parenthesis.
  // NOLINTNEXTLINE(misc-unconventional-assign-operator)
  constexpr void operator=(const FailureMessageAdapter&) const {}
};
 
// Singleton test framework class responsible for managing and running test
// cases. This implementation is internal to Pigweed test; free functions
// wrapping its functionality are exposed as the public interface.
class Framework {
 public:
  constexpr Framework()
      : current_test_(nullptr),
        current_result_(TestResult::kSuccess),
        run_tests_summary_{.passed_tests = 0,
                           .failed_tests = 0,
                           .skipped_tests = 0,
                           .disabled_tests = 0},
        exit_status_(0),
        event_handler_(nullptr),
        memory_pool_() {}
 
  static Framework& Get() { return framework_; }
 
  // Registers a single test case with the framework. The framework owns the
  // registered unit test. Called during static initialization.
  void RegisterTest(TestInfo* test) const;
 
  // Sets the handler to which the framework dispatches test events. During a
  // test run, the framework owns the event handler.
  inline void RegisterEventHandler(EventHandler* event_handler) {
    event_handler_ = event_handler;
  }
 
  // Runs all registered test cases, returning a status of 0 if all succeeded
  // or nonzero if there were any failures. Test events that occur during the
  // run are sent to the registered event handler, if any.
  int RunAllTests();
 
  // Only run test suites whose names are included in the provided list during
  // the next test run.
  void SetTestSuitesToRun(span<std::string_view> test_suites) {
    test_suites_to_run_ = test_suites;
  }
 
  bool ShouldRunTest(const TestInfo& test_info) const;
 
  // Whether the current test is skipped.
  bool IsSkipped() const { return current_result_ == TestResult::kSkipped; }
 
  // Whether the current test has failed.
  bool HasFailure() const { return current_result_ == TestResult::kFailure; }
 
  // Constructs an instance of a unit test class and runs the test.
  //
  // Tests are constructed within a static memory pool at run time instead of
  // being statically allocated to avoid blowing up the size of the test
  // binary in cases where users have large test fixtures (e.g. containing
  // buffers) reused many times. Instead, only a small, fixed-size TestInfo
  // struct is statically allocated per test case, with a run() function that
  // references this method instantiated for its test class.
  template <typename TestInstance>
  static void CreateAndRunTest(const TestInfo& test_info) {
    static_assert(
        sizeof(TestInstance) +
                MaxPaddingNeededToRaiseAlignment(
                    alignof(decltype(memory_pool_)), alignof(TestInstance)) <=
            sizeof(memory_pool_),
        "The test memory pool is too small for this test. Either increase "
        "PW_UNIT_TEST_CONFIG_MEMORY_POOL_SIZE or decrease the size of your "
        "test fixture.");
 
    Framework& framework = Get();
    framework.StartTest(test_info);
 
    // Reset the memory pool to a marker value to help detect use of
    // uninitialized memory.
    std::memset(&framework.memory_pool_, 0xa5, sizeof(framework.memory_pool_));
 
    framework.SetUpTestSuiteIfNeeded(TestInstance::SetUpTestSuite);
 
    // Construct the test object within the static memory pool. The StartTest
    // function has already been called by the TestInfo at this point.
    void* aligned_pool =
        AlignUp(&framework.memory_pool_, alignof(TestInstance));
    TestInstance* test_instance = new (aligned_pool) TestInstance();
    test_instance->PigweedTestRun();
 
    // Manually call the destructor as it is not called automatically for
    // objects constructed using placement new.
    test_instance->~TestInstance();
 
    framework.TearDownTestSuiteIfNeeded(TestInstance::TearDownTestSuite);
 
    framework.EndCurrentTest();
  }
 
  template <typename Expectation, typename Lhs, typename Rhs, typename Epsilon>
  [[nodiscard]] bool CurrentTestExpectWithEpsilon(Expectation expectation,
                                                  const Lhs& lhs,
                                                  const Rhs& rhs,
                                                  const Epsilon& epsilon,
                                                  const char* expression,
                                                  int line) {
    const bool success = expectation(lhs, rhs, epsilon);
    if (!success) {
      CurrentTestExpectSimple(expression,
                              MakeString<config::kExpectationBufferSizeBytes>(
                                  ConvertForPrint(lhs),
                                  " within ",
                                  ConvertForPrint(epsilon),
                                  " of ",
                                  ConvertForPrint(rhs))
                                  .c_str(),
                              line,
                              success);
    }
    return success;
  }
 
  // Runs an expectation function for the currently active test case.
  template <typename Expectation, typename Lhs, typename Rhs>
  [[nodiscard]] bool CurrentTestExpect(Expectation expectation,
                                       const Lhs& lhs,
                                       const Rhs& rhs,
                                       const char* expectation_string,
                                       const char* expression,
                                       int line) {
    const bool success = expectation(lhs, rhs);
    if (!success) {
      CurrentTestExpectSimple(
          expression,
          MakeString<config::kExpectationBufferSizeBytes>(ConvertForPrint(lhs),
                                                          ' ',
                                                          expectation_string,
                                                          ' ',
                                                          ConvertForPrint(rhs))
              .c_str(),
          line,
          success);
    }
    return success;
  }
 
  // Skips the current test and dispatches an event for it.
  ::pw::unit_test::internal::FailureMessageAdapter CurrentTestSkip(int line);
 
  // Dispatches an event indicating the result of an expectation.
  ::pw::unit_test::internal::FailureMessageAdapter CurrentTestExpectSimple(
      const char* expression,
      const char* evaluated_expression,
      int line,
      bool success);
 
 private:
  // Convert char* to void* so that they are printed as pointers instead of
  // strings in EXPECT_EQ and other macros. EXPECT_STREQ wraps its pointers in
  // a CStringArg so its pointers are treated like C strings.
  static constexpr const void* ConvertForPrint(const char* str) { return str; }
 
  static constexpr const void* ConvertForPrint(char* str) { return str; }
 
  static constexpr const char* ConvertForPrint(CStringArg value) {
    return value.c_str;
  }
 
  template <typename T>
  static constexpr T ConvertForPrint(T&& value) {
    return std::forward<T>(value);
  }
 
  // If current_test_ will be first of its suite, call set_up_ts
  void SetUpTestSuiteIfNeeded(SetUpTestSuiteFunc set_up_ts) const;
 
  // If current_test_ was the last of its suite, call tear_down_ts
  void TearDownTestSuiteIfNeeded(TearDownTestSuiteFunc tear_down_ts) const;
 
  // Sets current_test_ and dispatches an event indicating that a test
  // started.
  void StartTest(const TestInfo& test);
 
  // Dispatches event indicating that a test finished and clears
  // current_test_.
  void EndCurrentTest();
 
  // Singleton instance of the framework class.
  static Framework framework_;
 
  // Linked list of all registered test cases. This is static as it tests are
  // registered using static initialization.
  static TestInfo* tests_;
 
  // The current test case which is running.
  const TestInfo* current_test_;
 
  // Overall result of the current test case (pass/fail/skip).
  TestResult current_result_;
 
  // Overall result of the ongoing test run, which covers multiple tests.
  RunTestsSummary run_tests_summary_;
 
  // Program exit status returned by RunAllTests for GoogleTest compatibility.
  int exit_status_;
 
  // Handler to which to dispatch test events.
  EventHandler* event_handler_;
 
  span<std::string_view> test_suites_to_run_;
 
  alignas(std::max_align_t) std::byte memory_pool_[config::kMemoryPoolSize];
};
 
// Information about a single test case, including a pointer to a function
// which constructs and runs the test class. These are statically allocated
// instead of the test classes, as test classes can be very large.
class TestInfo {
 public:
  TestInfo(const char* const test_suite_name,
           const char* const test_name,
           const char* const file_name,
           void (*run_func)(const TestInfo&))
      : test_case_{
        .suite_name = test_suite_name,
        .test_name = test_name,
        .file_name = file_name,
       }, run_(run_func) {
    Framework::Get().RegisterTest(this);
  }
 
  // The name of the suite to which the test case belongs, the name of the
  // test case itself, and the path to the file in which the test case is
  // located.
  const TestCase& test_case() const { return test_case_; }
 
  bool enabled() const;
 
  void run() const { run_(*this); }
 
  TestInfo* next() const { return next_; }
  void set_next(TestInfo* next) { next_ = next; }
 
 private:
  TestCase test_case_;
 
  // Function which runs the test case. Refers to Framework::CreateAndRunTest
  // instantiated for the test case's class.
  void (*run_)(const TestInfo&);
 
  // TestInfo structs are registered with the test framework and stored as a
  // linked list.
  TestInfo* next_ = nullptr;
};
 
// Base class for all test cases or custom test fixtures.
// Every unit test created using the TEST or TEST_F macro defines a class that
// inherits from this (or a subclass of this).
//
// For example, given the following test definition:
//
//   TEST(MyTest, SaysHello) {
//     ASSERT_STREQ(SayHello(), "Hello, world!");
//   }
//
// A new class is defined for the test, e.g. MyTest_SaysHello_Test. This class
// inherits from the Test class and implements its PigweedTestBody function
// with the block provided to the TEST macro.
class Test {
 public:
  Test(const Test&) = delete;
  Test& operator=(const Test&) = delete;
 
  virtual ~Test() = default;
 
  static void SetUpTestSuite() {}
  static void TearDownTestSuite() {}
 
  static bool HasFailure() { return Framework::Get().HasFailure(); }
 
  // Runs the unit test.
  void PigweedTestRun() {
    SetUp();
    if (!HasFailure() && !Framework::Get().IsSkipped()) {
      PigweedTestBody();
    }
    TearDown();
  }
 
 protected:
  Test() = default;
 
  // Called immediately before executing the test body.
  //
  // Setup and cleanup can typically be done in the test fixture's constructor
  // and destructor, but there are cases where SetUp/TearDown must be used
  // instead. See the Google Test documentation for more information.
  virtual void SetUp() {}
 
  // Called immediately after executing the test body.
  virtual void TearDown() {}
 
 private:
  friend class internal::Framework;
 
  // The user-provided body of the test case. Populated by the TEST macro.
  virtual void PigweedTestBody() = 0;
};
 
// Checks that a test suite name is valid.
constexpr bool HasNoUnderscores(const char* suite) {
  const char* disabled_prefix = "DISABLED_";
 
  for (; *suite != '\0'; ++suite) {
    if (*suite == *disabled_prefix) {
      disabled_prefix += 1;
    } else {
      disabled_prefix = "";
      if (*suite == '_') {
        return false;
      }
    }
  }
  return true;
}
 
}  // namespace internal
 
inline void SetTestSuitesToRun(span<std::string_view> test_suites) {
  internal::Framework::Get().SetTestSuitesToRun(test_suites);
}
 
}  // namespace unit_test
}  // namespace pw
 
inline int RUN_ALL_TESTS() {
  return ::pw::unit_test::internal::Framework::Get().RunAllTests();
}
 
#define _PW_TEST(test_suite_name, test_name, parent_class)                     \
  static_assert(sizeof(#test_suite_name) > 1,                                  \
                "The test suite name must not be empty");                      \
  static_assert(::pw::unit_test::internal::HasNoUnderscores(#test_suite_name), \
                "The test suite name (" #test_suite_name                       \
                ") cannot contain underscores");                               \
  static_assert(sizeof(#test_name) > 1, "The test name must not be empty");    \
                                                                               \
  _PW_TEST_CLASS(test_suite_name,                                              \
                 test_name,                                                    \
                 test_suite_name##_##test_name##_Test,                         \
                 parent_class)
 
#define _PW_TEST_CLASS(suite, name, class_name, parent_class)               \
  class class_name final : public parent_class {                            \
   private:                                                                 \
    void PigweedTestBody() override;                                        \
  };                                                                        \
                                                                            \
  extern "C" {                                                              \
                                                                            \
  /* Silence ASAN to avoid errors in the initialization order checker */    \
  /* caused by the intentional use of dynamic initializers which modify */  \
  /* other globals */                                                       \
  PW_NO_SANITIZE("address")                                                 \
  /* Declare the TestInfo as non-const since const variables do not work */ \
  /* with the PW_UNIT_TEST_LINK_FILE_CONTAINING_TEST macro. */              \
  /* NOLINTNEXTLINE(cppcoreguidelines-avoid-non-const-global-variables) */  \
  ::pw::unit_test::internal::TestInfo _pw_unit_test_Info_##suite##_##name(  \
      #suite,                                                               \
      #name,                                                                \
      __FILE__,                                                             \
      ::pw::unit_test::internal::Framework::CreateAndRunTest<class_name>);  \
                                                                            \
  } /* extern "C" */                                                        \
                                                                            \
  void class_name::PigweedTestBody()
 
#define _PW_TEST_ASSERT(expectation)                 \
  if (!(expectation))                                \
  return ::pw::unit_test::internal::ReturnHelper() = \
             ::pw::unit_test::internal::FailureMessageAdapter()
 
#define _PW_TEST_EXPECT(expectation) \
  if (!(expectation))                \
  ::pw::unit_test::internal::FailureMessageAdapter()
 
#define _PW_TEST_BOOL(expr, value)                                   \
  ::pw::unit_test::internal::Framework::Get().CurrentTestExpect(     \
      [](bool _pw_lhs, bool _pw_rhs) { return _pw_lhs == _pw_rhs; }, \
      static_cast<bool>(expr),                                       \
      value,                                                         \
      "is",                                                          \
      #expr " is " #value,                                           \
      __LINE__)
 
#define _PW_TEST_OP(lhs, rhs, op)                                \
  ::pw::unit_test::internal::Framework::Get().CurrentTestExpect( \
      [](const auto& _pw_lhs, const auto& _pw_rhs) {             \
        return _pw_lhs op _pw_rhs;                               \
      },                                                         \
      (lhs),                                                     \
      (rhs),                                                     \
      #op,                                                       \
      #lhs " " #op " " #rhs,                                     \
      __LINE__)
 
#define _PW_TEST_NEAR(lhs, rhs, epsilon)                                      \
  ::pw::unit_test::internal::Framework::Get().CurrentTestExpectWithEpsilon(   \
      [](const auto& _pw_lhs, const auto& _pw_rhs, const auto& _pw_epsilon) { \
        return std::abs(_pw_lhs - _pw_rhs) <= _pw_epsilon;                    \
      },                                                                      \
      (lhs),                                                                  \
      (rhs),                                                                  \
      (epsilon),                                                              \
      #lhs " within " #epsilon " of " #rhs,                                   \
      __LINE__)
 
#define _PW_TEST_C_STR(lhs, rhs, op)                             \
  ::pw::unit_test::internal::Framework::Get().CurrentTestExpect( \
      [](const auto& _pw_lhs, const auto& _pw_rhs) {             \
        auto cmp = [](const char* l, const char* r) -> int {     \
          if (!l || !r) {                                        \
            return l != r;                                       \
          }                                                      \
          return std::strcmp(l, r);                              \
        };                                                       \
        return cmp(_pw_lhs.c_str, _pw_rhs.c_str) op 0;           \
      },                                                         \
      ::pw::unit_test::internal::CStringArg{lhs},                \
      ::pw::unit_test::internal::CStringArg{rhs},                \
      #op,                                                       \
      #lhs " " #op " " #rhs,                                     \
      __LINE__)
 
// Checks that test suite names between TEST and TEST_F declarations are unique.
// This works by declaring a function named for the test suite. The function
// takes no arguments but is declared with different return types in the TEST
// and TEST_F macros. If a TEST and TEST_F use the same test suite name, the
// function declarations conflict, resulting in a compilation error.
//
// This catches most conflicts, but a runtime check is ultimately needed since
// tests may be declared in different translation units.
#if !defined(__clang__) && !defined(__GNUC___) && __GNUC__ <= 8
// For some reason GCC8 is unable to ignore -Wredundant-decls here.
#define _PW_TEST_SUITE_NAMES_MUST_BE_UNIQUE(return_type, test_suite)
#else  // All other compilers.
#define _PW_TEST_SUITE_NAMES_MUST_BE_UNIQUE(return_type, test_suite)           \
  PW_MODIFY_DIAGNOSTICS_PUSH();                                                \
  PW_MODIFY_DIAGNOSTIC(ignored, "-Wredundant-decls");                          \
  extern "C" return_type /* use extern "C" to escape namespacing */            \
      PwUnitTestSuiteNamesMustBeUniqueBetweenTESTandTEST_F_##test_suite(void); \
  PW_MODIFY_DIAGNOSTICS_POP()
#endif  // GCC8 or older.
 
namespace testing {
 
// Alias Test as ::testing::Test for GoogleTest compatibility.
using Test = ::pw::unit_test::internal::Test;
 
// Provide a no-op init routine for GoogleTest compatibility.
inline void InitGoogleTest(int*, char**) {}
 
}  // namespace testing