#pragma once #include "fwd.h" #include "pathsplit.h" #include #include #include #include #include #include #include #include #include #include /** * Class behaviour is platform-dependent. * It uses platform-dependent separators for path-reconstructing operations. */ class TFsPath { private: struct TSplit; public: TFsPath(); TFsPath(const TString& path); TFsPath(const TStringBuf path); TFsPath(const char* path); TFsPath(const std::string& path) : TFsPath(TStringBuf(path)) { } TFsPath(const TFsPath& that); TFsPath(TFsPath&& that); TFsPath& operator=(const TFsPath& that); TFsPath& operator=(TFsPath&& that); ~TFsPath() = default; void CheckDefined() const; inline bool IsDefined() const { return Path_.length() > 0; } inline explicit operator bool() const { return IsDefined(); } inline const char* c_str() const { return Path_.c_str(); } inline operator const TString&() const { return Path_; } inline bool operator==(const TFsPath& that) const { return Path_ == that.Path_; } TFsPath& operator/=(const TFsPath& that); friend TFsPath operator/(const TFsPath& s, const TFsPath& p) { TFsPath ret(s); return ret /= p; } const TPathSplit& PathSplit() const; TFsPath& Fix(); inline const TString& GetPath() const { return Path_; } /// last component of path, or "/" if root TString GetName() const; /** * "a.b.tmp" -> "tmp" * "a.tmp" -> "tmp" * ".tmp" -> "" */ TString GetExtension() const; bool IsAbsolute() const; bool IsRelative() const; /** * TFsPath("/a/b").IsSubpathOf("/a") -> true * * TFsPath("/a").IsSubpathOf("/a") -> false * * TFsPath("/a").IsSubpathOf("/other/path") -> false * @param that - presumable parent path of this * @return True if this is a subpath of that and false otherwise. */ bool IsSubpathOf(const TFsPath& that) const; /** * TFsPath("/a/b").IsNonStrictSubpathOf("/a") -> true * * TFsPath("/a").IsNonStrictSubpathOf("/a") -> true * * TFsPath("/a").IsNonStrictSubpathOf("/other/path") -> false * @param that - presumable parent path of this * @return True if this is a subpath of that or they are equivalent and false otherwise. */ bool IsNonStrictSubpathOf(const TFsPath& that) const; bool IsContainerOf(const TFsPath& that) const { return that.IsSubpathOf(*this); } TFsPath RelativeTo(const TFsPath& root) const; // must be subpath of root /** * @returns relative path or empty path if root equals to this. */ TFsPath RelativePath(const TFsPath& root) const; //..; for relative paths 1st component must be the same /** * Never fails. Returns this if already a root. */ TFsPath Parent() const; TString Basename() const { return GetName(); } TString Dirname() const { return Parent(); } TFsPath Child(const TString& name) const; /** * @brief create this directory * * @param mode specifies permissions to use as described in mkdir(2), makes sense only on Unix-like systems. * * Nothing to do if dir exists. */ void MkDir(const int mode = MODE0777) const; /** * @brief create this directory and all parent directories as needed * * @param mode specifies permissions to use as described in mkdir(2), makes sense only on Unix-like systems. */ void MkDirs(const int mode = MODE0777) const; // XXX: rewrite to return iterator void List(TVector& children) const; void ListNames(TVector& children) const; // Check, if path contains at least one component with a specific name. bool Contains(const TString& component) const; // fails to delete non-empty directory void DeleteIfExists() const; // delete recursively. Does nothing if not exists void ForceDelete() const; // XXX: ino inline bool Stat(TFileStat& stat) const { stat = TFileStat(Path_.data()); return stat.Mode; } bool Exists() const; /// false if not exists bool IsDirectory() const; /// false if not exists bool IsFile() const; /// false if not exists bool IsSymlink() const; /// throw TIoException if not exists void CheckExists() const; void RenameTo(const TString& newPath) const; void RenameTo(const char* newPath) const; void RenameTo(const TFsPath& newFile) const; void ForceRenameTo(const TString& newPath) const; void CopyTo(const TString& newPath, bool force) const; void Touch() const; TFsPath RealPath() const; TFsPath RealLocation() const; TFsPath ReadLink() const; /// always absolute static TFsPath Cwd(); inline void Swap(TFsPath& p) noexcept { DoSwap(Path_, p.Path_); Split_.Swap(p.Split_); } private: void InitSplit() const; TSplit& GetSplit() const; private: TString Path_; /// cache mutable TSimpleIntrusivePtr Split_; }; namespace NPrivate { inline void AppendToFsPath(TFsPath&) { } template void AppendToFsPath(TFsPath& fsPath, const T& arg, Ts&&... args) { fsPath /= TFsPath(arg); AppendToFsPath(fsPath, std::forward(args)...); } } template TString JoinFsPaths(Ts&&... args) { TFsPath fsPath; ::NPrivate::AppendToFsPath(fsPath, std::forward(args)...); return fsPath.GetPath(); }