Sandbox.Filesystem

A filesystem that merges a bunch of other filesystems. This is read only.

A filesystem. Could be on disk, or in memory, or in the cloud. Could be writable or read only. Or it could be an aggregation of all those things, merged together and read only.

Returns true if this filesystem is read only

Get a list of directories

Unoptimal, for debugging purposes - don't expose

Get a list of files

Delete a folder and optionally all of its contents

Delete a file

Create a directory - or a tree of directories. Returns silently if the directory already exists.

Returns true if the file exists on this filesystem

Returns true if the directory exists on this filesystem

Returns the full physical path to a file or folder on disk, or null if it isn't on disk.

Returns the relative path

Write the contents to the path. The file will be over-written if the file exists

Given a filename, create a path to it

Read the contents of path and return it as a string. Returns null if file not found.

Read the contents of path and return it as a string

Create a sub-filesystem at the specified path

Open a file for write. If the file exists we'll overwrite it (by default)

Open a file for read. Will throw an exception if it doesn't exist.

Read Json from a file using System.Text.Json.JsonSerializer. This will throw exceptions if not valid json.

The same as ReadJson except will return a default value on missing/error.

Convert object to json and write it to the specified file

Gets the size in bytes of all the files in a directory

Returns CRC64 of the file contents.

File path to the file to get CRC of. The CRC64, or 0 if file is not found.

Returns CRC64 of the file contents.

File path to the file to get CRC of. The CRC64, or 0 if file is not found.

Returns file size of given file.

File path to the file to look up size of. File size, in bytes.

Mount this path on the filesystem

Mount this path on the filesystem, so it's accessible in Mount

Zio wants good paths to start with '/' - so we add it here if it isn't already on

Lowercase the filename and replace \ with /

A physical filesystem that resolves paths case-insensitively on Linux.

Real directory path -> case-insensitive name lookup (name -> actual on-disk name).

Input path (case-insensitive key) -> resolved path with correct on-disk casing.

Walk each component of and resolve it to the actual on-disk casing. Returns the original path if any component can't be matched, letting the OS produce a normal "file not found" error.

Returns a case-insensitive lookup of names in , mapping each name to its real on-disk casing. Returns null if the directory doesn't exist.

Remove resolved-path cache entries whose resolved value passes through .

Clear all caches (e.g. after external file changes).

Watch folders, dispatch events on changed files

Bit of a hack until we can do better. Don't trigger any watchers until this time.

Called once per batch of files changed

Called for each file changed

This is used for unit tests, to assure that a change is detected

A directory on a disk

A filesystem that only exists in memory