FileFinder.h

Go to the documentation of this file.

// Mantid Repository : https://github.com/mantidproject/mantid
//
// Copyright © 2010 ISIS Rutherford Appleton Laboratory UKRI,
//   NScD Oak Ridge National Laboratory, European Spallation Source,
//   Institut Laue - Langevin & CSNS, Institute of High Energy Physics, CAS
// SPDX - License - Identifier: GPL - 3.0 +
#pragma once
 
//----------------------------------------------------------------------
// Includes
//----------------------------------------------------------------------
#include "MantidAPI/DllConfig.h"
#include "MantidAPI/IArchiveSearch.h"
#include "MantidKernel/SingletonHolder.h"
 
#include <filesystem>
#include <set>
#include <vector>
 
namespace Mantid {
//---------------------------------------------------------------------------
// Forward declarations
//---------------------------------------------------------------------------
namespace Kernel {
class InstrumentInfo;
class FacilityInfo;
} // namespace Kernel
namespace API {
 
class MANTID_API_DLL FileFinderImpl {
public:
  std::filesystem::path getFullPath(const std::string &filename, const bool ignoreDirs = false) const;
  std::string extractAllowedSuffix(std::string &userString) const;
  const API::Result<std::filesystem::path> getPath(const std::vector<IArchiveSearch_sptr> &archs,
                                                   const std::set<std::string> &hintstrs,
                                                   const std::vector<std::string> &exts) const;
  std::string makeFileName(const std::string &hintstr, const Kernel::InstrumentInfo &instrument) const;
  void setCaseSensitive(const bool cs);
  bool getCaseSensitive() const;
  static std::vector<IArchiveSearch_sptr> getArchiveSearch(const Kernel::FacilityInfo &facility);
  const API::Result<std::filesystem::path> findRun(const std::string &hintstr,
                                                   const std::vector<std::string> &exts = {},
                                                   const bool useExtsOnly = false,
                                                   const std::string &defaultInstrument = "") const;
  const API::Result<std::filesystem::path> findRun(const std::string &hintstr, const Kernel::InstrumentInfo &instrument,
                                                   const std::vector<std::string> &exts = {},
                                                   const bool useExtsOnly = false) const;
  std::vector<std::filesystem::path> findRuns(const std::string &hintstr, const std::vector<std::string> &exts = {},
                                              const bool useExtsOnly = false) const;
  const Kernel::InstrumentInfo getInstrument(const std::string &hintstr, const bool returnDefaultIfNotFound = true,
                                             const std::string &defaultInstrument = "") const;
  std::string getExtension(const std::string &filename, const std::vector<std::string> &exts) const;
  void getUniqueExtensions(const std::vector<std::string> &extensionsToAdd, std::vector<std::string> &uniqueExts) const;
  std::pair<std::string, std::string> toInstrumentAndNumber(const std::string &hintstr,
                                                            const std::string &defaultInstrument = "") const;
  std::pair<std::string, std::string> toInstrumentAndNumber(const std::string &hintstr,
                                                            const Kernel::InstrumentInfo &instrument) const;
 
private:
  friend struct Mantid::Kernel::CreateUsingNew<FileFinderImpl>;
 
  static const std::string ALLOWED_SUFFIX;
  FileFinderImpl();
  FileFinderImpl(const FileFinderImpl &);
  FileFinderImpl &operator=(const FileFinderImpl &);
  std::string validateRuns(const std::string &searchText) const;
  const API::Result<std::filesystem::path> getISISInstrumentDataCachePath(const std::string &cachePathToSearch,
                                                                          const std::set<std::string> &hintstrs,
                                                                          const std::vector<std::string> &exts) const;
  const API::Result<std::filesystem::path> getArchivePath(const std::vector<IArchiveSearch_sptr> &archs,
                                                          const std::set<std::string> &hintstrs,
                                                          const std::vector<std::string> &exts) const;
  std::string toUpper(const std::string &src) const;
  int m_globOption;
};
 
using FileFinder = Mantid::Kernel::SingletonHolder<FileFinderImpl>;
} // namespace API
} // namespace Mantid
 
namespace Mantid {
namespace Kernel {
EXTERN_MANTID_API template class MANTID_API_DLL Mantid::Kernel::SingletonHolder<Mantid::API::FileFinderImpl>;
}
} // namespace Mantid