filesystem

type DefaultFS struct{}

type Filesystem interface {
	// Stat returns a FileInfo describing the named file.
	// If there is an error, it will be of type *PathError.
	Stat(name string) (fs.FileInfo, error)

	// ReadDir reads the named directory and returns a list of directory entries
	// sorted by filename.
	ReadDir(name string) ([]fs.DirEntry, error)

	// Getwd returns a rooted path name corresponding to the current directory.
	// If the current directory can be reached via multiple paths (due to
	// symbolic links), Getwd may return any one of them.
	Getwd() (string, error)

	// Abs returns an absolute representation of path. If the path is not
	// absolute it will be joined with the current working directory to turn
	// it into an absolute path.
	Abs(path string) (string, error)

	// MkdirAll creates a directory named path, along with any necessary parents,
	// and returns nil, or else returns an error. The permission bits perm are
	// used for all directories that MkdirAll creates.
	MkdirAll(path string, perm fs.FileMode) error

	// Create creates or truncates the named file. If the file already exists,
	// it is truncated. If the file does not exist, it is created with mode 0666
	// (before umask). If successful, methods on the returned file can be used
	// for I/O; the associated file descriptor has mode O_RDWR.
	Create(path string) (io.WriteCloser, error)

	// Open opens the named file for reading. If successful, methods on the
	// returned file can be used for reading; the associated file descriptor
	// has mode O_RDONLY.
	Open(path string) (fs.File, error)

	// ReadFile reads the named file and returns the contents. A successful
	// call returns err == nil, not err == EOF.
	ReadFile(path string) ([]byte, error)

	// WriteFile writes data to the named file, creating it if necessary.
	// If the file does not exist, WriteFile creates it with permissions perm
	// (before umask); otherwise WriteFile truncates it before writing, without
	// changing permissions.
	WriteFile(path string, data []byte, perm fs.FileMode) error
}

type Platformer interface {
	// Platform returns a string identifier for the platform being simulated
	// (e.g., "windows", "linux", "darwin").
	Platform() string
}