gz/common/testing/TestPaths.hh

Go to the documentation of this file.

/*
* Copyright (C) 2022 Open Source Robotics Foundation
*
* 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 GZ_COMMON_TESTING_TESTPATHS_HH_
#define GZ_COMMON_TESTING_TESTPATHS_HH_
 
#include <memory>
#include <string>
 
#include "gz/common/Filesystem.hh"
#include "gz/common/TempDirectory.hh"
#include "gz/common/Util.hh"
 
#include "gz/common/testing/Export.hh"
 
#ifndef TESTING_PROJECT_SOURCE_DIR
#define TESTING_PROJECT_SOURCE_DIR ""
#endif
 
namespace gz::common::testing
{
 
constexpr char kTestingProjectSourceDir[] = TESTING_PROJECT_SOURCE_DIR;
 
enum class GZ_COMMON_TESTING_VISIBLE BuildType
{
  kUnknown,
  kCMake,
  kBazel
};
 
class TestPaths
{
  public: GZ_COMMON_TESTING_VISIBLE
          explicit TestPaths(const std::string &_projectSourcePath =
              kTestingProjectSourceDir);
 
  public: GZ_COMMON_TESTING_VISIBLE
          virtual ~TestPaths() = 0;
 
  public: virtual bool GZ_COMMON_TESTING_VISIBLE
          ProjectSourcePath(std::string &_sourceDir) = 0;
 
  public: virtual bool GZ_COMMON_TESTING_VISIBLE
          TestTmpPath(std::string &_tmpDir) = 0;
 
  protected: std::string projectSourcePath;
};
 
std::shared_ptr<gz::common::TempDirectory>
GZ_COMMON_TESTING_VISIBLE
MakeTestTempDirectoryImpl(const std::string &_projectSourcePath,
                          const std::string &_prefix = "test",
                          const std::string &_subDir = "gz",
                          bool _cleanup = true);
 
 
inline std::shared_ptr<gz::common::TempDirectory>
MakeTestTempDirectory(const std::string &_prefix = "test",
                      const std::string &_subDir = "gz",
                      bool _cleanup = true)
{
  return MakeTestTempDirectoryImpl(kTestingProjectSourceDir,
                                   _prefix,
                                   _subDir,
                                   _cleanup);
}
 
BuildType
GZ_COMMON_TESTING_VISIBLE
TestBuildType(
    const std::string &_projectSourcePath = kTestingProjectSourceDir);
 
std::unique_ptr<TestPaths>
GZ_COMMON_TESTING_VISIBLE
TestPathFactory(
    const std::string &_projectSourcePath = kTestingProjectSourceDir);
 
template <typename... Args>
std::string SourceFile(Args const &... args)
{
  auto testPaths = TestPathFactory(kTestingProjectSourceDir);
  assert(nullptr != testPaths);
 
  std::string dataDir;
  testPaths->ProjectSourcePath(dataDir);
  return common::joinPaths(dataDir, args...);
}
 
template <typename... Args>
std::string TestFile(Args const &... args)
{
  return SourceFile("test", args...);
}
 
template <typename... Args>
std::string TempPath(Args const &... args)
{
  auto testPaths = TestPathFactory(kTestingProjectSourceDir);
  assert(nullptr != testPaths);
 
  std::string dataDir;
  testPaths->TestTmpPath(dataDir);
  return common::joinPaths(dataDir, args...);
}
}  // namespace gz::common::testing
#endif  // GZ_COMMON_TESTING_TESTPATHS_HH_