You signed in with another tab or window.Reload to refresh your session.You signed out in another tab or window.Reload to refresh your session.You switched accounts on another tab or window.Reload to refresh your session.Dismiss alert
Virtual File System that provides interface ofstd::filesystem.
Example
#include<cassert>#include<memory>#include<string>#include<vfs.hpp>voidwork(vfs::Fs& fs) {fs.create_directories("foo/bar");fs.create_symlink("foo/bar","baz");*fs.open_write("baz/food") <<"Royale with cheese";}intmain(int argc,char* argv[]) {auto sandbox =vfs::make_vfs();work(*sandbox);std::string line;std::getline(*sandbox->open_read("foo/bar/food"), line);assert(line =="Royale with cheese");return0;}
Features
File Systems
vfs::make_os_fs Proxy ofstd::filesystem.
vfs::make_vfs Basic file system.
vfs::make_mem_fs Files are stored on the memory.
vfs::make_union_fs Provides a single coherent file system over multiple file systems.
vfs::make_read_only_fs Makes the given file system read-only.
Utilities
vfs::Fs::change_root Changes the root directory.
vfs::Fs::mount Mounts different file system.
vfs::Fs::copy Copies a file between file systems.
About Current Working Directory
#include<cassert>#include<filesystem>#include<vfs.hpp>intmain(int argc,char* argv[]) {// Assume a directory "/tmp/foo/" and a regular file "/tmp/bar/foo" exist.{namespacefs= std::filesystem;fs::current_path("/tmp");assert(fs::is_directory("foo"));// References "/tmp/foo/".fs::current_path("/tmp/bar");assert(notfs::is_directory("foo"));// References "/tmp/bar/foo".}{autoconst fs =vfs::make_os_fs();autoconst tmp = fs->current_path("/tmp");assert(tmp->is_directory("foo"));// References "/tmp/foo/".autoconst bar = fs->current_path("/tmp/bar");assert(not bar->is_directory("foo"));// References "/tmp/bar/foo".assert(tmp->is_directory("foo"));// References "/tmp/foo/".}return0;}
Standardstd::filesystem::current_path(std::filesystem::path const& p) changes the Current Working Directory (CWD), which can have an impact on any code in the current process that relies on relative paths, potentially causing unintended results.
Invfs, since the file system is an object, eachvfs::Fs holds its own CWD.vfs::Fs::current_path(...) returns a new instance that references the same file system but has a different CWD, instead of replacing the CWD of the existing instance.
Mount
#include<cassert>#include<filesystem>#include<fstream>#include<string>#include<vfs.hpp>intmain(int argc,char* argv[]) {namespacefs= std::filesystem;autoconst sandbox =vfs::make_vfs();sandbox->create_directories("foo/bar");sandbox->mount("foo/bar", *vfs::make_os_fs(),"/tmp");*sandbox->open_write("foo/bar/food") <<"Royale with cheese";asser(sandbox->exists("foo/bar/food"));asser(fs::exists("/tmp/food"));{std::string line;std::getline(*sandbox->open_read("foo/bar/food"), line);asser(line =="Royale with cheese");}{std::ifstreamfood("/tmp/food");std::string line;std::getline(food, line);asser(line =="Royale with cheese");}sandbox->unmount("foo/bar");asser(not sandbox->exists("foo/bar/food"));asser(fs::exists("/tmp/food"));return0;}
Fs::mount is similar to a bind mount.It allows you to mount a file from a filesystem to a different path or mount a file from a different filesystem.
