2 * This file is part of the GROMACS molecular simulation package.
4 * Copyright (c) 2012,2013, by the GROMACS development team, led by
5 * Mark Abraham, David van der Spoel, Berk Hess, and Erik Lindahl,
6 * and including many others, as listed in the AUTHORS file in the
7 * top-level source directory and at http://www.gromacs.org.
9 * GROMACS is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU Lesser General Public License
11 * as published by the Free Software Foundation; either version 2.1
12 * of the License, or (at your option) any later version.
14 * GROMACS is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 * Lesser General Public License for more details.
19 * You should have received a copy of the GNU Lesser General Public
20 * License along with GROMACS; if not, see
21 * http://www.gnu.org/licenses, or write to the Free Software Foundation,
22 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
24 * If you want to redistribute modifications to GROMACS, please
25 * consider that scientific software is very special. Version
26 * control is crucial - bugs must be traceable. We will be happy to
27 * consider code for inclusion in the official distribution, but
28 * derived work must not be called official GROMACS. Details are found
29 * in the README & COPYING files - if they are missing, get the
30 * official version at http://www.gromacs.org.
32 * To help us fund GROMACS development, we humbly ask that you cite
33 * the research papers on the package. Check out http://www.gromacs.org.
37 * Implements gmx::test::TestFileManager.
39 * \author Teemu Murtola <teemu.murtola@gmail.com>
40 * \ingroup module_testutils
42 #include "testfilemanager.h"
50 #include <gtest/gtest.h>
52 #include "gromacs/utility/gmxassert.h"
53 #include "gromacs/utility/path.h"
54 #include "gromacs/options/options.h"
55 #include "gromacs/options/basicoptions.h"
56 #include "testutils/testoptions.h"
63 /********************************************************************
64 * TestFileManager::Impl
68 * Private implementation class for TestFileManager.
70 * \ingroup module_testutils
72 class TestFileManager::Impl
75 //! Global test input data path set with setDataInputDirectory().
76 static const char *s_inputDirectory;
78 //! Global temporary output directory for tests, set with setOutputTempDirectory().
79 static const char *s_outputTempDirectory;
81 //! Container type for names of temporary files.
82 typedef std::set<std::string> FileNameList;
85 * Try to remove all temporary files.
87 * Does not throw; errors (e.g., missing files) are silently ignored.
91 //! List of unique paths returned by getTemporaryFilePath().
95 const char *TestFileManager::Impl::s_inputDirectory = NULL;
96 const char *TestFileManager::Impl::s_outputTempDirectory = NULL;
97 /** Controls whether TestFileManager should delete temporary files
98 after the test finishes. */
99 static bool g_bDeleteFilesAfterTest = true;
101 GMX_TEST_OPTIONS(TestFileManagerOptions, options)
103 options->addOption(BooleanOption("delete-temporary-files")
104 .store(&g_bDeleteFilesAfterTest)
105 .description("At the end of each test case, delete temporary and output files"));
109 void TestFileManager::Impl::removeFiles()
111 FileNameList::const_iterator i;
112 for (i = files_.begin(); i != files_.end(); ++i)
114 std::remove(i->c_str());
119 /********************************************************************
123 TestFileManager::TestFileManager()
128 TestFileManager::~TestFileManager()
130 if (g_bDeleteFilesAfterTest)
132 impl_->removeFiles();
136 std::string TestFileManager::getTemporaryFilePath(const char *suffix)
138 /* Configure a temporary directory from CMake, so that temporary
139 * output from a test goes to a location relevant to that
140 * test. Currently, files whose names are returned by this method
141 * get cleaned up (by default) at the end of all tests.
143 std::string filename =
144 Path::join(getOutputTempDirectory(),
145 getTestSpecificFileName(suffix));
146 impl_->files_.insert(filename);
150 std::string TestFileManager::getTestSpecificFileName(const char *suffix)
152 const ::testing::TestInfo *test_info =
153 ::testing::UnitTest::GetInstance()->current_test_info();
154 std::string filename = std::string(test_info->test_case_name())
155 + "_" + test_info->name();
156 if (suffix[0] != '.')
158 filename.append("_");
160 filename.append(suffix);
161 std::replace(filename.begin(), filename.end(), '/', '_');
165 std::string TestFileManager::getInputFilePath(const char *filename)
167 return Path::join(getInputDataDirectory(), filename);
170 const char *TestFileManager::getInputDataDirectory()
172 GMX_RELEASE_ASSERT(Impl::s_inputDirectory != NULL, "Path for test input files is not set");
173 return Impl::s_inputDirectory;
176 const char *TestFileManager::getOutputTempDirectory()
178 GMX_RELEASE_ASSERT(Impl::s_outputTempDirectory != NULL, "Path for temporary output files from tests is not set");
179 return Impl::s_outputTempDirectory;
182 void TestFileManager::setInputDataDirectory(const char *path)
184 // There is no need to protect this by a mutex, as this is called in early
185 // initialization of the tests.
186 GMX_RELEASE_ASSERT(Directory::exists(path),
187 "Test data directory does not exist");
188 Impl::s_inputDirectory = path;
191 void TestFileManager::setOutputTempDirectory(const char *path)
193 // There is no need to protect this by a mutex, as this is called in early
194 // initialization of the tests.
195 GMX_RELEASE_ASSERT(Directory::exists(path),
196 "Directory for tests' temporary files does not exist");
197 Impl::s_outputTempDirectory = path;