Struct RunLog 

pub struct RunLog { /* private fields */ }

All the log messages for a CI run.

The default version collects messages, but doesn’t write them. If the output is set later, the collected messages get written there.

Implementations

impl RunLog

pub fn stdout(&mut self)

Write messages to stdout. Flush any collected messages.

pub fn to_named_file( &mut self, filename: impl AsRef<Path>, ) -> Result<(), RunLogError>

Change RunLog so that further log messages are written to a named file.

pub fn msgs(&self) -> &[RunLogMessage]

All messages.

pub fn push(&mut self, msg: RunLogMessage)

Append a message to the run log.

pub fn write(&mut self, msg: &RunLogMessage)

Output a message to stderr.

pub fn read_raw(reader: impl Read) -> Result<Self, RunLogError>

Load run log file a reader. This reads the output from the “run log” serial port of QEMU and extracts the JSON lines from that for parsing.

pub fn from_raw(buf: Vec<u8>) -> Result<Self, RunLogError>

Load run log from in-memory raw data. This parses the output to extract JSON Lihes.

pub fn read_jsonl(reader: impl Read) -> Result<Self, RunLogError>

Load run log file a reader. This reads pure JSON Lines run log.

pub fn parse_jsonl(data: Vec<u8>) -> Result<Self, RunLogError>

Parse JSON run log from memory.

impl RunLog

pub fn debug(&mut self, source: RunLogSource, msg: impl Into<String>)

pub fn ambient_starts<N: Into<String>, V: Into<String>>( &mut self, source: RunLogSource, name: N, version: V, )

pub fn ambient_ends_successfully(&mut self, source: RunLogSource)

pub fn ambient_ends_in_failure(&mut self, source: RunLogSource)

pub fn ambient_runtime_config(&mut self, source: RunLogSource, config: &Config)

pub fn run_ci(&mut self, source: RunLogSource, project_name: impl Into<String>)

pub fn skip_ci(&mut self, source: RunLogSource, project_name: impl Into<String>)

pub fn executor_starts( &mut self, source: RunLogSource, name: impl Into<String>, version: impl Into<String>, )

pub fn executor_ends_successfully(&mut self, source: RunLogSource)

pub fn executor_ends_in_failure(&mut self, source: RunLogSource, exit_code: i32)

pub fn runnable_plan(&mut self, source: RunLogSource, plan: &RunnablePlan)

Log runnable plan at start of execution.

pub fn execute_action(&mut self, source: RunLogSource, action: &RunnableAction)

Execute an action.

pub fn action_succeeded( &mut self, source: RunLogSource, action: &RunnableAction, )

Action succeded.

pub fn action_failed(&mut self, source: RunLogSource, action: &RunnableAction)

Action failed.

pub fn deb_get(&mut self, source: RunLogSource, packages: &[Needed])

pub fn npm_get_succeeded(&mut self, source: RunLogSource)

npm_get action succeeded.

pub fn npm_get_failed(&mut self, log_source: RunLogSource, err: &NpmError)

npm_get action failed.

pub fn custom_action_starts( &mut self, log_source: RunLogSource, source: PathBuf, custom: Custom, exe: PathBuf, exe_exists: bool, )

Custom action starts.

pub fn custom_action_output( &mut self, source: RunLogSource, stdout: Vec<u8>, stderr: Vec<u8>, )

CUstom action succeeded.

pub fn plan_succeeded(&mut self, source: RunLogSource)

All actions in plan succeded.

pub fn start_program(&mut self, source: RunLogSource, cmd: &Command)

Start a program.

pub fn program_succeeded(&mut self, source: RunLogSource, output: &Output)

Program succeeded.

pub fn program_failed(&mut self, source: RunLogSource, err: &CommandError)

Program failed.

pub fn start_qemu(&mut self, source: RunLogSource, cmd: &Command)

Start a program.

pub fn qemu_succeeded(&mut self, source: RunLogSource, output: &Output)

Program succeeded.

pub fn qemu_failed(&mut self, source: RunLogSource, err: &CommandError)

Program failed.

Trait Implementations

impl Debug for RunLog

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for RunLog

fn default() -> RunLog

Returns the “default value” for a type.