crashpad/test/gtest_disabled.h

// Copyright 2017 The Crashpad Authors. All rights reserved.
//
// 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
//
//     http://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.

#ifndef CRASHPAD_TEST_GTEST_DISABLED_H_
#define CRASHPAD_TEST_GTEST_DISABLED_H_

#include <string>
#include <vector>

#include "base/macros.h"
#include "gtest/gtest.h"

//! \file

namespace crashpad {
namespace test {

//! \brief Provides support for dynamically disabled gtest tests.
//!
//! A test runner must register this with gtest as follows prior to calling
//! `RUN_ALL_TESTS()`:
//! \code
//!   testing::AddGlobalTestEnvironment(
//!       crashpad::test::DisabledTestGtestEnvironment::Get());
//! \endcode
class DisabledTestGtestEnvironment final : public testing::Environment {
 public:
  //! \brief Returns the DisabledTestGtestEnvironment singleton instance,
  //!     creating it if necessary.
  static DisabledTestGtestEnvironment* Get();

  //! \brief Displays a message about a test being disabled, and arranges for
  //!     this information to be duplicated in TearDown().
  //!
  //! This method is for the internal use of the DISABLED_TEST() macro. Do not
  //! call it directly, use the macro instead.
  void DisabledTest();

 private:
  DisabledTestGtestEnvironment();
  ~DisabledTestGtestEnvironment() override;

  // testing::Environment:
  void TearDown() override;

  std::vector<std::string> disabled_tests_;

  DISALLOW_COPY_AND_ASSIGN(DisabledTestGtestEnvironment);
};

}  // namespace test
}  // namespace crashpad

//! \brief Displays a message about a test being disabled, and returns early.
//!
//! gtest only provides a mechanism for tests to be disabled statically, by
//! prefixing test case names or test names with `DISABLED_`. When it is
//! necessary to disable tests dynamically, gtest provides no assistance. This
//! macro displays a message about the disabled test and returns early. The
//! dynamically disabled test will also be displayed during gtest global test
//! environment tear-down before the test executable exits.
//!
//! This macro may only be invoked from the context of a gtest test.
//!
//! There’s a long-standing <a
//! href="https://groups.google.com/d/topic/googletestframework/Nwh3u7YFuN4">gtest
//! feature request</a> to provide this functionality directly in gtest, but
//! since it hasn’t been implemented, this macro provides a local mechanism to
//! achieve it.
#define DISABLED_TEST()                                                    \
  do {                                                                     \
    ::crashpad::test::DisabledTestGtestEnvironment::Get()->DisabledTest(); \
    return;                                                                \
  } while (false)

#endif  // CRASHPAD_TEST_GTEST_DISABLED_H_