CiRun class

A whole run: the stages it was asked for, into one timestamped log folder.

Constructors

CiRun({required String toolName, required String repositoryRoot, required String lockPath, required Map<String, String> stageDescriptions, required CiStageRunner runStage, required StringSink console, String? logRoot, String? runDir, String? flutter, String? dart, String? findFlutter() = ciFlutterExecutable})

Properties

console → StringSink
final
dart → String
final
flutter → String?
The flutter executable: the one given, else what the constructor's findFlutter found (by default ciFlutterExecutable); null when there is none, and then a step that needs it is red without running.
final
hashCode → int
The hash code for this object.
no setterinherited
lockPath → String
The lock directory every child process runs under.
final
outcomes → List<CiOutcome>
final
repositoryRoot → String
The repository the run verifies; paths are printed relative to it.
final
runDir → String
final
runner ↔ CiProcessRunner
latefinal
runStage → CiStageRunner
What each stage does.
final
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
stageDescriptions → Map<String, String>
One line per stage, printed as each begins.
final
toolName → String
The tool's name, the first line of the console output.
final

Methods

fail(String stage, String subject, String logName, String reason) → void
A step that is red without running anything; the reason is its log.
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
relative(String path) → String
path relative to repositoryRoot, as the output prints it.
run(List<String> stages) → Future<String>
Runs stages in order, past any red, and returns the summary line.
skip(String stage, String subject, String logName, String reason) → void
A step deliberately not run; the reason is its log. Counted apart from green and red.
step(String stage, String subject, String logName, List<CiCommand> commands, {bool needsFlutter = false, bool counts = false, String? produces}) → Future<void>
Runs commands as one step into the log logName, recording its outcome. counts reads the test counts of the last progress line into the detail; produces is a file the step must leave behind, so an exit code of 0 with nothing built is red.
tool(CiPackage pkg, List<String> args, {Map<String, String> env = const {}}) → CiCommand
The command that runs dart or flutter — whichever pkg needs — with args in its directory.
toString() → String
A string representation of this object.
inherited

Operators

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