| OLD | NEW |
| 1 // Copyright (c) 2009 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2010 The Chromium Authors. All rights reserved. |
| 2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
| 4 | 4 |
| 5 #ifndef BASE_TEST_TEST_SUITE_H_ | 5 #ifndef BASE_TEST_TEST_SUITE_H_ |
| 6 #define BASE_TEST_TEST_SUITE_H_ | 6 #define BASE_TEST_TEST_SUITE_H_ |
| 7 #pragma once | 7 #pragma once |
| 8 | 8 |
| 9 // Defines a basic test suite framework for running gtest based tests. You can | 9 // Defines a basic test suite framework for running gtest based tests. You can |
| 10 // instantiate this class in your main function and call its Run method to run | 10 // instantiate this class in your main function and call its Run method to run |
| 11 // any gtest based tests that are linked into your executable. | 11 // any gtest based tests that are linked into your executable. |
| 12 | 12 |
| 13 #include <string> |
| 14 |
| 13 #include "base/at_exit.h" | 15 #include "base/at_exit.h" |
| 14 #include "base/base_paths.h" | |
| 15 #include "base/debug_on_start.h" | |
| 16 #include "base/debug_util.h" | |
| 17 #include "base/file_path.h" | |
| 18 #include "base/i18n/icu_util.h" | |
| 19 #include "base/multiprocess_test.h" | |
| 20 #include "base/nss_util.h" | |
| 21 #include "base/path_service.h" | |
| 22 #include "base/process_util.h" | |
| 23 #include "base/scoped_nsautorelease_pool.h" | |
| 24 #include "base/scoped_ptr.h" | |
| 25 #include "base/time.h" | |
| 26 #include "testing/gtest/include/gtest/gtest.h" | |
| 27 #include "testing/multiprocess_func_list.h" | |
| 28 | 16 |
| 29 #if defined(OS_POSIX) && !defined(OS_MACOSX) | 17 namespace testing { |
| 30 #include <gtk/gtk.h> | 18 class TestInfo; |
| 31 #endif | 19 } |
| 32 | 20 |
| 33 // A command-line flag that makes a test failure always result in a non-zero | 21 namespace base { |
| 34 // process exit code. | |
| 35 const char kStrictFailureHandling[] = "strict_failure_handling"; | |
| 36 | |
| 37 // Match function used by the GetTestCount method. | |
| 38 typedef bool (*TestMatch)(const testing::TestInfo&); | |
| 39 | |
| 40 // By setting up a shadow AtExitManager, this test event listener ensures that | |
| 41 // no state is carried between tests (like singletons, lazy instances, etc). | |
| 42 // Of course it won't help if the code under test corrupts memory. | |
| 43 class TestIsolationEnforcer : public testing::EmptyTestEventListener { | |
| 44 public: | |
| 45 virtual void OnTestStart(const testing::TestInfo& test_info) { | |
| 46 ASSERT_FALSE(exit_manager_.get()); | |
| 47 exit_manager_.reset(new base::ShadowingAtExitManager()); | |
| 48 } | |
| 49 | |
| 50 virtual void OnTestEnd(const testing::TestInfo& test_info) { | |
| 51 ASSERT_TRUE(exit_manager_.get()); | |
| 52 exit_manager_.reset(); | |
| 53 } | |
| 54 | |
| 55 private: | |
| 56 scoped_ptr<base::ShadowingAtExitManager> exit_manager_; | |
| 57 }; | |
| 58 | 22 |
| 59 class TestSuite { | 23 class TestSuite { |
| 60 public: | 24 public: |
| 61 TestSuite(int argc, char** argv) { | 25 // Match function used by the GetTestCount method. |
| 62 base::EnableTerminationOnHeapCorruption(); | 26 typedef bool (*TestMatch)(const testing::TestInfo&); |
| 63 CommandLine::Init(argc, argv); | |
| 64 testing::InitGoogleTest(&argc, argv); | |
| 65 #if defined(OS_POSIX) && !defined(OS_MACOSX) | |
| 66 g_thread_init(NULL); | |
| 67 gtk_init_check(&argc, &argv); | |
| 68 #endif // defined(OS_LINUX) | |
| 69 // Don't add additional code to this constructor. Instead add it to | |
| 70 // Initialize(). See bug 6436. | |
| 71 } | |
| 72 | 27 |
| 73 virtual ~TestSuite() { | 28 TestSuite(int argc, char** argv); |
| 74 CommandLine::Reset(); | 29 virtual ~TestSuite(); |
| 75 } | |
| 76 | 30 |
| 77 // Returns true if the test is marked as flaky. | 31 // Returns true if the test is marked as flaky. |
| 78 static bool IsMarkedFlaky(const testing::TestInfo& test) { | 32 static bool IsMarkedFlaky(const testing::TestInfo& test); |
| 79 return strncmp(test.name(), "FLAKY_", 6) == 0; | |
| 80 } | |
| 81 | 33 |
| 82 // Returns true if the test is marked as failing. | 34 // Returns true if the test is marked as failing. |
| 83 static bool IsMarkedFailing(const testing::TestInfo& test) { | 35 static bool IsMarkedFailing(const testing::TestInfo& test); |
| 84 return strncmp(test.name(), "FAILS_", 6) == 0; | |
| 85 } | |
| 86 | 36 |
| 87 // Returns true if the test is marked as "MAYBE_". | 37 // Returns true if the test is marked as "MAYBE_". |
| 88 // When using different prefixes depending on platform, we use MAYBE_ and | 38 // When using different prefixes depending on platform, we use MAYBE_ and |
| 89 // preprocessor directives to replace MAYBE_ with the target prefix. | 39 // preprocessor directives to replace MAYBE_ with the target prefix. |
| 90 static bool IsMarkedMaybe(const testing::TestInfo& test) { | 40 static bool IsMarkedMaybe(const testing::TestInfo& test); |
| 91 return strncmp(test.name(), "MAYBE_", 6) == 0; | |
| 92 } | |
| 93 | 41 |
| 94 // Returns true if the test failure should be ignored. | 42 // Returns true if the test failure should be ignored. |
| 95 static bool ShouldIgnoreFailure(const testing::TestInfo& test) { | 43 static bool ShouldIgnoreFailure(const testing::TestInfo& test); |
| 96 if (CommandLine::ForCurrentProcess()->HasSwitch(kStrictFailureHandling)) | |
| 97 return false; | |
| 98 return IsMarkedFlaky(test) || IsMarkedFailing(test); | |
| 99 } | |
| 100 | 44 |
| 101 // Returns true if the test failed and the failure shouldn't be ignored. | 45 // Returns true if the test failed and the failure shouldn't be ignored. |
| 102 static bool NonIgnoredFailures(const testing::TestInfo& test) { | 46 static bool NonIgnoredFailures(const testing::TestInfo& test); |
| 103 return test.should_run() && test.result()->Failed() && | |
| 104 !ShouldIgnoreFailure(test); | |
| 105 } | |
| 106 | 47 |
| 107 // Returns the number of tests where the match function returns true. | 48 // Returns the number of tests where the match function returns true. |
| 108 int GetTestCount(TestMatch test_match) { | 49 int GetTestCount(TestMatch test_match); |
| 109 testing::UnitTest* instance = testing::UnitTest::GetInstance(); | |
| 110 int count = 0; | |
| 111 | |
| 112 for (int i = 0; i < instance->total_test_case_count(); ++i) { | |
| 113 const testing::TestCase& test_case = *instance->GetTestCase(i); | |
| 114 for (int j = 0; j < test_case.total_test_count(); ++j) { | |
| 115 if (test_match(*test_case.GetTestInfo(j))) { | |
| 116 count++; | |
| 117 } | |
| 118 } | |
| 119 } | |
| 120 | |
| 121 return count; | |
| 122 } | |
| 123 | 50 |
| 124 // TODO(phajdan.jr): Enforce isolation for all tests once it's stable. | 51 // TODO(phajdan.jr): Enforce isolation for all tests once it's stable. |
| 125 void EnforceTestIsolation() { | 52 void EnforceTestIsolation(); |
| 126 testing::TestEventListeners& listeners = | |
| 127 testing::UnitTest::GetInstance()->listeners(); | |
| 128 listeners.Append(new TestIsolationEnforcer); | |
| 129 } | |
| 130 | 53 |
| 131 void CatchMaybeTests() { | 54 void CatchMaybeTests(); |
| 132 testing::TestEventListeners& listeners = | |
| 133 testing::UnitTest::GetInstance()->listeners(); | |
| 134 listeners.Append(new MaybeTestDisabler); | |
| 135 } | |
| 136 | 55 |
| 137 // Don't add additional code to this method. Instead add it to | 56 int Run(); |
| 138 // Initialize(). See bug 6436. | |
| 139 int Run() { | |
| 140 base::ScopedNSAutoreleasePool scoped_pool; | |
| 141 | |
| 142 Initialize(); | |
| 143 std::string client_func = | |
| 144 CommandLine::ForCurrentProcess()->GetSwitchValueASCII( | |
| 145 kRunClientProcess); | |
| 146 // Check to see if we are being run as a client process. | |
| 147 if (!client_func.empty()) | |
| 148 return multi_process_function_list::InvokeChildProcessTest(client_func); | |
| 149 int result = RUN_ALL_TESTS(); | |
| 150 | |
| 151 // If there are failed tests, see if we should ignore the failures. | |
| 152 if (result != 0 && GetTestCount(&TestSuite::NonIgnoredFailures) == 0) | |
| 153 result = 0; | |
| 154 | |
| 155 // Display the number of flaky tests. | |
| 156 int flaky_count = GetTestCount(&TestSuite::IsMarkedFlaky); | |
| 157 if (flaky_count) { | |
| 158 printf(" YOU HAVE %d FLAKY %s\n\n", flaky_count, | |
| 159 flaky_count == 1 ? "TEST" : "TESTS"); | |
| 160 } | |
| 161 | |
| 162 // Display the number of tests with ignored failures (FAILS). | |
| 163 int failing_count = GetTestCount(&TestSuite::IsMarkedFailing); | |
| 164 if (failing_count) { | |
| 165 printf(" YOU HAVE %d %s with ignored failures (FAILS prefix)\n\n", | |
| 166 failing_count, failing_count == 1 ? "test" : "tests"); | |
| 167 } | |
| 168 | |
| 169 // This MUST happen before Shutdown() since Shutdown() tears down | |
| 170 // objects (such as NotificationService::current()) that Cocoa | |
| 171 // objects use to remove themselves as observers. | |
| 172 scoped_pool.Recycle(); | |
| 173 | |
| 174 Shutdown(); | |
| 175 | |
| 176 return result; | |
| 177 } | |
| 178 | 57 |
| 179 protected: | 58 protected: |
| 180 class MaybeTestDisabler : public testing::EmptyTestEventListener { | |
| 181 public: | |
| 182 virtual void OnTestStart(const testing::TestInfo& test_info) { | |
| 183 ASSERT_FALSE(TestSuite::IsMarkedMaybe(test_info)) | |
| 184 << "Probably the OS #ifdefs don't include all of the necessary " | |
| 185 "platforms.\nPlease ensure that no tests have the MAYBE_ prefix " | |
| 186 "after the code is preprocessed."; | |
| 187 } | |
| 188 }; | |
| 189 | |
| 190 // By default fatal log messages (e.g. from DCHECKs) result in error dialogs | 59 // By default fatal log messages (e.g. from DCHECKs) result in error dialogs |
| 191 // which gum up buildbots. Use a minimalistic assert handler which just | 60 // which gum up buildbots. Use a minimalistic assert handler which just |
| 192 // terminates the process. | 61 // terminates the process. |
| 193 static void UnitTestAssertHandler(const std::string& str) { | 62 static void UnitTestAssertHandler(const std::string& str); |
| 194 RAW_LOG(FATAL, str.c_str()); | |
| 195 } | |
| 196 | 63 |
| 197 // Disable crash dialogs so that it doesn't gum up the buildbot | 64 // Disable crash dialogs so that it doesn't gum up the buildbot |
| 198 virtual void SuppressErrorDialogs() { | 65 virtual void SuppressErrorDialogs(); |
| 199 #if defined(OS_WIN) | |
| 200 UINT new_flags = SEM_FAILCRITICALERRORS | | |
| 201 SEM_NOGPFAULTERRORBOX | | |
| 202 SEM_NOOPENFILEERRORBOX; | |
| 203 | |
| 204 // Preserve existing error mode, as discussed at | |
| 205 // http://blogs.msdn.com/oldnewthing/archive/2004/07/27/198410.aspx | |
| 206 UINT existing_flags = SetErrorMode(new_flags); | |
| 207 SetErrorMode(existing_flags | new_flags); | |
| 208 #endif // defined(OS_WIN) | |
| 209 } | |
| 210 | 66 |
| 211 // Override these for custom initialization and shutdown handling. Use these | 67 // Override these for custom initialization and shutdown handling. Use these |
| 212 // instead of putting complex code in your constructor/destructor. | 68 // instead of putting complex code in your constructor/destructor. |
| 213 | 69 |
| 214 virtual void Initialize() { | 70 virtual void Initialize(); |
| 215 // Initialize logging. | 71 virtual void Shutdown(); |
| 216 FilePath exe; | |
| 217 PathService::Get(base::FILE_EXE, &exe); | |
| 218 FilePath log_filename = exe.ReplaceExtension(FILE_PATH_LITERAL("log")); | |
| 219 logging::InitLogging(log_filename.value().c_str(), | |
| 220 logging::LOG_TO_BOTH_FILE_AND_SYSTEM_DEBUG_LOG, | |
| 221 logging::LOCK_LOG_FILE, | |
| 222 logging::DELETE_OLD_LOG_FILE); | |
| 223 // We want process and thread IDs because we may have multiple processes. | |
| 224 // Note: temporarily enabled timestamps in an effort to catch bug 6361. | |
| 225 logging::SetLogItems(true, true, true, true); | |
| 226 | |
| 227 CHECK(base::EnableInProcessStackDumping()); | |
| 228 #if defined(OS_WIN) | |
| 229 // Make sure we run with high resolution timer to minimize differences | |
| 230 // between production code and test code. | |
| 231 base::Time::EnableHighResolutionTimer(true); | |
| 232 #endif // defined(OS_WIN) | |
| 233 | |
| 234 // In some cases, we do not want to see standard error dialogs. | |
| 235 if (!DebugUtil::BeingDebugged() && | |
| 236 !CommandLine::ForCurrentProcess()->HasSwitch("show-error-dialogs")) { | |
| 237 SuppressErrorDialogs(); | |
| 238 DebugUtil::SuppressDialogs(); | |
| 239 logging::SetLogAssertHandler(UnitTestAssertHandler); | |
| 240 } | |
| 241 | |
| 242 icu_util::Initialize(); | |
| 243 | |
| 244 #if defined(USE_NSS) | |
| 245 // Trying to repeatedly initialize and cleanup NSS and NSPR may result in | |
| 246 // a deadlock. Such repeated initialization will happen when using test | |
| 247 // isolation. Prevent problems by initializing NSS here, so that the cleanup | |
| 248 // will be done only on process exit. | |
| 249 base::EnsureNSSInit(); | |
| 250 #endif // defined(USE_NSS) | |
| 251 | |
| 252 CatchMaybeTests(); | |
| 253 } | |
| 254 | |
| 255 virtual void Shutdown() { | |
| 256 } | |
| 257 | 72 |
| 258 // Make sure that we setup an AtExitManager so Singleton objects will be | 73 // Make sure that we setup an AtExitManager so Singleton objects will be |
| 259 // destroyed. | 74 // destroyed. |
| 260 base::AtExitManager at_exit_manager_; | 75 base::AtExitManager at_exit_manager_; |
| 76 |
| 77 DISALLOW_COPY_AND_ASSIGN(TestSuite); |
| 261 }; | 78 }; |
| 262 | 79 |
| 80 } // namespace base |
| 81 |
| 263 #endif // BASE_TEST_TEST_SUITE_H_ | 82 #endif // BASE_TEST_TEST_SUITE_H_ |
| OLD | NEW |