MemoryExecutionEnv class final

In-memory ExecutionEnv: MemoryFileSystem plus a Shell.

The default shell is UnavailableShell; pass a custom shell to test shell-consuming code without spawning real processes.

Inheritance
Implemented types

Constructors

MemoryExecutionEnv({String cwd = '/', Shell shell = const UnavailableShell()})
Creates a MemoryExecutionEnv rooted at cwd.

Properties

cwd String
Current working directory for relative paths.
finalinherited
hashCode int
The hash code for this object.
no setterinherited
runtimeType Type
A representation of the runtime type of the object.
no setterinherited

Methods

absolutePath(String path) Future<Result<String, FileError>>
Returns an absolute addressed path without requiring it to exist and without resolving symlinks.
inherited
appendFile(String path, String content) Future<Result<void, FileError>>
Creates or appends to a file, creating parent directories.
inherited
createDir(String path, {bool recursive = true}) Future<Result<void, FileError>>
Creates a directory. When recursive is true (the default), missing parents are created too.
inherited
exec(String command, {ShellExecOptions? options}) Future<Result<ShellExecResult, ExecutionError>>
Executes a shell command. Must never throw: all failures are encoded in the returned Result.
override
exists(String path) Future<Result<bool, FileError>>
Returns false for missing paths; other errors surface as Err.
inherited
fileInfo(String path) Future<Result<FileInfo, FileError>>
Returns metadata for the addressed path without following symlinks.
inherited
joinPath(List<String> parts) Future<Result<String, FileError>>
Joins path segments in the filesystem namespace without requiring the result to exist.
inherited
listDir(String path) Future<Result<List<FileInfo>, FileError>>
Lists the direct children of a directory.
inherited
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
readBinaryFile(String path) Future<Result<Uint8List, FileError>>
Reads the file as raw bytes.
inherited
readTextFile(String path) Future<Result<String, FileError>>
Reads a UTF-8 text file.
inherited
readTextLines(String path, {int? maxLines}) Future<Result<List<String>, FileError>>
Reads UTF-8 text lines. Implementations should stop once maxLines lines have been read.
inherited
remove(String path, {bool recursive = false, bool force = false}) Future<Result<void, FileError>>
Removes a file or directory. With force, a missing path is not an error.
inherited
toString() String
A string representation of this object.
inherited
writeBinaryFile(String path, Uint8List content) Future<Result<void, FileError>>
Writes raw bytes to a file, creating parent directories.
inherited
writeFile(String path, String content) Future<Result<void, FileError>>
Creates or overwrites a file, creating parent directories.
inherited

Operators

operator ==(Object other) bool
The equality operator.
inherited