ExecutionEnv class abstract interface

Filesystem and process execution environment used by the harness.

Ported from pi's ExecutionEnv (interface ExecutionEnv extends FileSystem, Shell). The dart:io-backed implementation is exported only from lib/io.dart; the core library exports MemoryExecutionEnv for tests and web consumers.

Implemented types

• FileSystem
• Shell

Implementers

• LocalExecutionEnv
• MemoryExecutionEnv
• SandboxedExecutionEnv
• SecretsExecutionEnv
• SessionVarsExecutionEnv

Properties

cwd → String

Current working directory for relative paths.

no setter, inherited

hashCode → int

The hash code for this object.

no setter, inherited

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

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.

inherited

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