core/dev.gmitch215.drift.triage/CleanRun

CleanRun

The clean-run check: run the report's own command in the official image of its toolchain, with nothing of the reporter's machine around it, and compare what it prints with the failure in the report. Drift prints the command and never runs it.

Properties

ERROR_TEXT

const val ERROR_TEXT: String

Asked when the report shows a command and no error: its output gives the failure.

FAMILY

const val FAMILY: String

KEY

const val KEY: String

The fact a reply leaves in the session: CleanMatch.id of the reading.

Functions

failure

fun failure(report: String): ReportFailure

The failure of the (already redacted) report text, as drift why --reply reads it.

isBinary

fun isBinary(output: String): Boolean

True when output is binary or mostly control characters, so no reading applies.

quote

fun quote(command: String): String?

command as one single-quoted shell word, or null when it is not safe to print: empty, over MAX_COMMAND characters, a control or non-ASCII character, a backtick, $(, a masked secret or a trailing backslash. An embedded single quote becomes '\''.

read

fun read(failure: ReportFailure, output: String): CleanRunReading

Compares the output of the clean run with failure: CleanMatch.SAME when a line of it (or a signal or transport symptom) is the report's failure, CleanMatch.DIFFERENT when it prints some other error, else CleanMatch.WORKS, which an empty output also is.