// Protocol Buffers - Google's data interchange format // Copyright 2008 Google Inc. All rights reserved. // https://developers.google.com/protocol-buffers/ // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are // met: // // * Redistributions of source code must retain the above copyright // notice, this list of conditions and the following disclaimer. // * Redistributions in binary form must reproduce the above // copyright notice, this list of conditions and the following disclaimer // in the documentation and/or other materials provided with the // distribution. // * Neither the name of Google Inc. nor the names of its // contributors may be used to endorse or promote products derived from // this software without specific prior written permission. // // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. // Author: kenton@google.com (Kenton Varda) // emulates google3/testing/base/public/googletest.cc #include "google/protobuf/testing/googletest.h" #include #include #include #include #include "absl/log/absl_check.h" #include "absl/log/absl_log.h" #include "absl/strings/match.h" #include "absl/strings/str_cat.h" #include "absl/strings/str_replace.h" #include "google/protobuf/io/io_win32.h" #include "google/protobuf/testing/file.h" #ifdef _MSC_VER // #include #else #include #endif #include #include #include #include namespace google { namespace protobuf { #ifdef _WIN32 // DO NOT include , instead create functions in io_win32.{h,cc} and import // them like we do below. using google::protobuf::io::win32::close; using google::protobuf::io::win32::dup2; using google::protobuf::io::win32::dup; using google::protobuf::io::win32::mkdir; using google::protobuf::io::win32::open; #endif #ifndef O_BINARY #ifdef _O_BINARY #define O_BINARY _O_BINARY #else #define O_BINARY 0 // If this isn't defined, the platform doesn't need it. #endif #endif std::string TestSourceDir() { #ifndef GOOGLE_THIRD_PARTY_PROTOBUF #ifdef GOOGLE_PROTOBUF_TEST_SOURCE_PATH return GOOGLE_PROTOBUF_TEST_SOURCE_PATH; #else #ifndef _MSC_VER // automake sets the "srcdir" environment variable. char* result = getenv("srcdir"); if (result != NULL) { return result; } #endif // _MSC_VER // Look for the "src" directory. std::string prefix = "."; // Keep looking further up the directory tree until we find // src/.../descriptor.cc. It is important to look for a particular file, // keeping in mind that with Bazel builds the directory structure under // bazel-bin/ looks similar to the main directory tree in the Git repo. while (!File::Exists( absl::StrCat(prefix, "/src/google/protobuf/descriptor.cc"))) { if (!File::Exists(prefix)) { ABSL_LOG(FATAL) << "Could not find protobuf source code. Please run tests from " "somewhere within the protobuf source package."; } absl::StrAppend(&prefix, "/.."); } absl::StrAppend(&prefix, "/src"); return prefix; #endif // GOOGLE_PROTOBUF_TEST_SOURCE_PATH #else return "third_party/protobuf/src"; #endif // GOOGLE_THIRD_PARTY_PROTOBUF } namespace { std::string GetTemporaryDirectoryName() { // Tests run under Bazel "should not" use /tmp. Bazel sets this environment // variable for tests to use instead. char* from_environment = getenv("TEST_TMPDIR"); if (from_environment != NULL && from_environment[0] != '\0') { return absl::StrCat(from_environment, "/protobuf_tmpdir"); } // tmpnam() is generally not considered safe but we're only using it for // testing. We cannot use tmpfile() or mkstemp() since we're creating a // directory. char b[L_tmpnam + 1]; // HPUX multithread return 0 if s is 0 #pragma GCC diagnostic push #pragma GCC diagnostic ignored "-Wdeprecated-declarations" std::string result = tmpnam(b); #pragma GCC diagnostic pop #ifdef _WIN32 // Avoid a trailing dot by changing it to an underscore. On Win32 the names of // files and directories can, but should not, end with dot. // // In MS-DOS and FAT16 filesystem the filenames were 8dot3 style so it didn't // make sense to have a name ending in dot without an extension, so the shell // silently ignored trailing dots. To this day the Win32 API still maintains // this behavior and silently ignores trailing dots in path arguments of // functions such as CreateFile{A,W}. Even POSIX API function implementations // seem to wrap the Win32 API functions (e.g. CreateDirectoryA) and behave // this way. // It's possible to avoid this behavior and create files / directories with // trailing dots (using CreateFileW / CreateDirectoryW and prefixing the path // with "\\?\") but these will be degenerate in the sense that you cannot // chdir into such directories (or navigate into them with Windows Explorer) // nor can you open such files with some programs (e.g. Notepad). if (result[result.size() - 1] == '.') { result[result.size() - 1] = '_'; } // On Win32, tmpnam() returns a file prefixed with '\', but which is supposed // to be used in the current working directory. WTF? if (absl::StartsWith(result, "\\")) { result.erase(0, 1); } // The Win32 API accepts forward slashes as a path delimiter as long as the // path doesn't use the "\\?\" prefix. // Let's avoid confusion and use only forward slashes. result = absl::StrReplaceAll(result, {{"\\", "/"}}); #endif // _WIN32 return result; } // Creates a temporary directory on demand and deletes it when the process // quits. class TempDirDeleter { public: TempDirDeleter() {} ~TempDirDeleter() { if (!name_.empty()) { File::DeleteRecursively(name_, NULL, NULL); } } std::string GetTempDir() { if (name_.empty()) { name_ = GetTemporaryDirectoryName(); ABSL_CHECK(mkdir(name_.c_str(), 0777) == 0) << strerror(errno); // Stick a file in the directory that tells people what this is, in case // we abort and don't get a chance to delete it. File::WriteStringToFileOrDie( "", absl::StrCat(name_, "/TEMP_DIR_FOR_PROTOBUF_TESTS")); } return name_; } private: std::string name_; }; TempDirDeleter temp_dir_deleter_; } // namespace std::string TestTempDir() { return temp_dir_deleter_.GetTempDir(); } // TODO(kenton): Share duplicated code below. Too busy/lazy for now. static std::string stdout_capture_filename_; static std::string stderr_capture_filename_; static int original_stdout_ = -1; static int original_stderr_ = -1; void CaptureTestStdout() { ABSL_CHECK_EQ(original_stdout_, -1) << "Already capturing."; stdout_capture_filename_ = absl::StrCat(TestTempDir(), "/captured_stdout"); int fd = open(stdout_capture_filename_.c_str(), O_WRONLY | O_CREAT | O_EXCL | O_BINARY, 0777); ABSL_CHECK(fd >= 0) << "open: " << strerror(errno); original_stdout_ = dup(1); close(1); dup2(fd, 1); close(fd); } void CaptureTestStderr() { ABSL_CHECK_EQ(original_stderr_, -1) << "Already capturing."; stderr_capture_filename_ = absl::StrCat(TestTempDir(), "/captured_stderr"); int fd = open(stderr_capture_filename_.c_str(), O_WRONLY | O_CREAT | O_EXCL | O_BINARY, 0777); ABSL_CHECK(fd >= 0) << "open: " << strerror(errno); original_stderr_ = dup(2); close(2); dup2(fd, 2); close(fd); } std::string GetCapturedTestStdout() { ABSL_CHECK_NE(original_stdout_, -1) << "Not capturing."; close(1); dup2(original_stdout_, 1); original_stdout_ = -1; std::string result; File::ReadFileToStringOrDie(stdout_capture_filename_, &result); remove(stdout_capture_filename_.c_str()); return result; } std::string GetCapturedTestStderr() { ABSL_CHECK_NE(original_stderr_, -1) << "Not capturing."; close(2); dup2(original_stderr_, 2); original_stderr_ = -1; std::string result; File::ReadFileToStringOrDie(stderr_capture_filename_, &result); remove(stderr_capture_filename_.c_str()); return result; } namespace { // Force shutdown at process exit so that we can test for memory leaks. To // actually check for leaks, I suggest using the heap checker included with // google-perftools. Set it to "draconian" mode to ensure that every last // call to malloc() has a corresponding free(). struct ForceShutdown { ~ForceShutdown() { ShutdownProtobufLibrary(); // Test to shutdown the library twice, which should succeed. ShutdownProtobufLibrary(); } } force_shutdown; } // namespace } // namespace protobuf } // namespace google