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
-
- Object
- MemoryFileSystem
- MemoryExecutionEnv
- Implemented types
Constructors
- MemoryExecutionEnv({String cwd = '/', Shell shell = const UnavailableShell()})
-
Creates a MemoryExecutionEnv rooted at
cwd.
Properties
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
recursiveis 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
falsefor 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
maxLineslines 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