filesystem.h

#pragma once
 
#include "pixelbullet/filesystem/virtual_path.h"
 
#include "tools/cpp/runfiles/runfiles.h"
 
#include <filesystem>
#include <memory>
#include <optional>
#include <string>
#include <string_view>
 
namespace pixelbullet
{
class Filesystem
{
public:
    static constexpr std::string_view assets_alias = "assets";
    static constexpr std::string_view shared_alias = "shared";
 
    struct Config
    {
        std::string workspace = "pixelbullet";
        std::filesystem::path asset_base_path;
        std::filesystem::path workspace_root;
        std::filesystem::path packaged_runtime_root;
    };
 
    explicit Filesystem(std::unique_ptr<bazel::tools::cpp::runfiles::Runfiles> runfiles);
    explicit Filesystem(std::unique_ptr<bazel::tools::cpp::runfiles::Runfiles> runfiles, Config config);
    ~Filesystem() = default;
 
    Filesystem(const Filesystem&) = delete;
    Filesystem& operator=(const Filesystem&) = delete;
    Filesystem(Filesystem&&) = delete;
    Filesystem& operator=(Filesystem&&) = delete;
 
    [[nodiscard]] std::optional<std::filesystem::path> TryResolve(const VirtualPath& path) const;
    [[nodiscard]] std::filesystem::path Resolve(const VirtualPath& path) const;
    [[nodiscard]] std::filesystem::path ResolveWritable(const VirtualPath& path) const;
    [[nodiscard]] bool Exists(const VirtualPath& path) const;
 
    [[nodiscard]] const std::filesystem::path& GetAssetBasePath() const noexcept
    {
        return asset_base_path_;
    }
 
    [[nodiscard]] const std::filesystem::path& GetWorkspaceRoot() const noexcept
    {
        return workspace_root_;
    }
 
    [[nodiscard]] const std::filesystem::path& GetPackagedRuntimeRoot() const noexcept
    {
        return packaged_runtime_root_;
    }
 
private:
    enum class VirtualRoot
    {
        Direct,
        Assets,
        Shared,
    };
 
    struct ExpandedPath
    {
        std::filesystem::path path;
        VirtualRoot root = VirtualRoot::Direct;
    };
 
    [[nodiscard]] std::optional<ExpandedPath> ExpandPath(const VirtualPath& path) const;
    [[nodiscard]] std::filesystem::path BuildRuntimeRelativePath(const std::filesystem::path& logicalPath, VirtualRoot root) const;
    [[nodiscard]] std::filesystem::path BuildRunfilesLookup(const std::filesystem::path& logicalPath, VirtualRoot root) const;
    [[nodiscard]] std::filesystem::path BuildPackagedLookup(const std::filesystem::path& logicalPath, VirtualRoot root) const;
    [[nodiscard]] static std::filesystem::path DetectWorkspaceRoot(const std::filesystem::path& startPath);
 
private:
    std::unique_ptr<bazel::tools::cpp::runfiles::Runfiles> runfiles_;
    std::string workspace_name_;
    std::filesystem::path asset_base_path_;
    std::filesystem::path workspace_root_;
    std::filesystem::path packaged_runtime_root_;
};
} // namespace pixelbullet