gz/common/TempDirectory.hh

Go to the documentation of this file.

/*
 * Copyright 2021 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_TEMPDIRECTORY_HH_
#define GZ_COMMON_TEMPDIRECTORY_HH_
 
#include <string>
 
#include <gz/common/Export.hh>
#include <gz/common/Filesystem.hh>
 
#include <gz/utils/ImplPtr.hh>
 
namespace gz
{
  namespace common
  {
    std::string GZ_COMMON_VISIBLE tempDirectoryPath();
 
    std::string GZ_COMMON_VISIBLE createTempDirectory(
        const std::string &_baseName,
        const std::string &_parentPath,
        const FilesystemWarningOp _warningOp = FSWO_LOG_WARNINGS);
 
    class GZ_COMMON_VISIBLE TempDirectory
    {
      public: TempDirectory(const std::string &_prefix = "temp_dir",
                            const std::string &_subDir = "gz",
                            bool _cleanup = true);
 
      public: explicit TempDirectory(const std::string &_root,
                            const std::string &_prefix = "temp_dir",
                            const std::string &_subDir = "gz",
                            bool _cleanup = true);
 
      public: ~TempDirectory();
 
      public: bool Valid() const;
 
      public: void DoCleanup(bool _doCleanup);
 
      public: bool DoCleanup() const;
 
      public: std::string Path() const;
 
      GZ_UTILS_UNIQUE_IMPL_PTR(dataPtr)
    };
  }  // namespace common
}  // namespace gz
#endif  // GZ_COMMON_TEMPDIRECTORY_HH_