FileSystemMap stores a map of filesystems the empty key will be overwritten to be the default key it includes a default filesystem, based off the os fs

Field name	Field type	Comment
m	sync.Map	No comment on field.

OsFS is a simple fs.FS implementation that uses the local file system. (We do not use os.DirFS because we do our own rooting or path prefixing without being constrained to a single root folder. The standard os.DirFS implementation is problematic since roots can be dynamic in our application.)

OsFS also implements fs.StatFS, fs.GlobFS, fs.ReadDirFS, and fs.ReadFileFS.

wrapperFs exists so can easily add to wrapperFs down the line

Field name	Field type	Comment
key	string	No comment on field.
	fs.FS	No comment on field.

Default will get the default filesystem in the filesystem map

Get will get a filesystem with a given key

Uses: fs.FS, strings.TrimSpace.

Register will add the filesystem with key to later be retrieved A call with a nil fs will call unregister, ensuring that a call to Default() will never be nil

Unregister will remove the filesystem with key from the filesystem map if the key is the default key, it will set the default to the osFS instead of deleting it modules should call this on cleanup to be safe

Uses: filepath.Glob.

Uses: os.Open.

Uses: os.ReadDir.

Uses: os.ReadFile.

Uses: os.Stat.