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
findFlutterfound (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 -
pathrelative to repositoryRoot, as the output prints it. -
run(
List< String> stages) → Future<String> -
Runs
stagesin 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
commandsas one step into the loglogName, recording its outcome.countsreads the test counts of the last progress line into the detail;producesis 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
dartorflutter— whicheverpkgneeds — withargsin its directory. -
toString(
) → String -
A string representation of this object.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited