file_system.hpp

#pragma once
 
#include <filesystem>
#include <fstream>
#include <functional>
#include <regex>
#include <span>
#include <string>
#include <vector>
 
#include "plugify/types.hpp"
 
namespace plugify {
    struct FileInfo {
        std::filesystem::path path;
        std::uintmax_t size;
        std::filesystem::file_time_type last_write_time;
        std::filesystem::file_type type;
        std::filesystem::perms permissions;
 
        bool is_directory() const {
            return type == std::filesystem::file_type::directory;
        }
 
        bool is_regular_file() const {
            return type == std::filesystem::file_type::regular;
        }
 
        bool is_symlink() const {
            return type == std::filesystem::file_type::symlink;
        }
    };
 
    struct DirectoryIterationOptions {
        bool recursive = false;
        bool follow_symlinks = false;
        bool skip_permission_denied = true;
        std::optional<std::regex> filter_pattern;
        std::function<bool(const FileInfo&)> filter_predicate;
    };
 
    class IFileSystem {
    public:
        virtual ~IFileSystem() = default;
 
        // File Operations
        virtual Result<std::string> ReadTextFile(const std::filesystem::path& path) = 0;
 
        virtual Result<std::vector<uint8_t>> ReadBinaryFile(const std::filesystem::path& path) = 0;
 
        virtual Result<void>
        WriteTextFile(const std::filesystem::path& path, std::string_view content) = 0;
 
        virtual Result<void>
        WriteBinaryFile(const std::filesystem::path& path, std::span<const uint8_t> data) = 0;
 
        // Directory Operations
        virtual bool IsExists(const std::filesystem::path& path) = 0;
 
        virtual bool IsDirectory(const std::filesystem::path& path) = 0;
 
        virtual bool IsRegularFile(const std::filesystem::path& path) = 0;
 
        virtual Result<FileInfo> GetFileInfo(const std::filesystem::path& path) = 0;
 
        virtual Result<std::vector<FileInfo>>
        ListDirectory(const std::filesystem::path& directory) = 0;
 
        virtual Result<std::vector<FileInfo>> IterateDirectory(
            const std::filesystem::path& directory,
            const DirectoryIterationOptions& options = {}
        ) = 0;
 
        virtual Result<std::vector<std::filesystem::path>> FindFiles(
            const std::filesystem::path& directory,
            std::span<const std::string_view> patterns,  // e.g., {"*.json", "manifest.*"}
            bool recursive = true
        ) = 0;
 
        // Path Operations
        virtual Result<void> CreateDirectories(const std::filesystem::path& path) = 0;
 
        virtual Result<void> Remove(const std::filesystem::path& path) = 0;
 
        virtual Result<void> RemoveAll(const std::filesystem::path& path) = 0;
 
        virtual Result<void>
        Copy(const std::filesystem::path& from, const std::filesystem::path& to) = 0;
 
        virtual Result<void>
        Move(const std::filesystem::path& from, const std::filesystem::path& to) = 0;
 
        virtual Result<std::filesystem::path> GetAbsolutePath(const std::filesystem::path& path) = 0;
 
        virtual Result<std::filesystem::path> GetCanonicalPath(const std::filesystem::path& path) = 0;
 
        virtual Result<std::filesystem::path>
        GetRelativePath(const std::filesystem::path& path, const std::filesystem::path& base) = 0;
    };
}  // namespace plugify