Struct Lab 

pub struct Lab<'r> { /* private fields */ }

A run: a manifest under a name, on a runner.

Implementations

impl Lab<'_>

pub async fn down(&self, opts: &RunOptions, events: &dyn Events) -> Result<()>

Removes everything the run created (containers, networks, volumes).

Errors

Fails, after its error event, when the run is recorded elsewhere, a down step fails, or the run’s state can’t be locked or written.

pub async fn park(&self, mode: Park, events: &dyn Events) -> Result<()>

Stops the run, keeping what it created, with the manifest’s park steps for mode.

Errors

Fails with not_parkable when the manifest has no steps for mode, with not_running when nothing of the run is there, and as Lab::down does for a step or the state.

pub async fn resume( &self, opts: &RunOptions, events: &dyn Events, ) -> Result<Run>

Starts a parked run again, as it was: nothing is re-created, so inputs aren’t needed again.

Errors

Fails with nothing_to_resume when nothing is left (the parked mark is dropped), and as Lab::up does for a tool, a step, a ready condition or the state.

pub async fn check( &self, opts: &RunOptions, events: &dyn Events, ) -> Result<CheckReport>

Runs the lab’s checks against the running run.

Errors

Fails with not_running when no target machine runs, and when a setup or teardown step fails. A failing check isn’t an error: the report says it (ok: false).

pub async fn provision( &self, machine: Option<&str>, opts: &RunOptions, events: &dyn Events, ) -> Result<()>

Runs the lab’s set-up again on its running machines, every one or machine (a lab machine of the manifest), without rebuilding them: the manifest’s provision steps. The values given at launch aren’t kept by the runner: pass them again in opts.

Errors

Fails with machine_unknown for a machine the lab doesn’t have, not_running when no target machine runs, unsupported when the manifest has no provision steps, and as Lab::up does for a step or the state.

impl Lab<'_>

pub async fn up(&self, opts: &RunOptions, events: &dyn Events) -> Result<Run>

Starts the run: refused while it runs or runs elsewhere; a parked run is resumed (with Occupied::ResumeParked); leftovers are removed first.

Errors

Fails, after its error event, when the run is up already (already_running) or recorded elsewhere (running_elsewhere); when a param, secret or tool is missing or refused; when a host port is taken (port_in_use); when a step fails or runs out of time (tool_failed, tool_missing, timeout); when a ready condition doesn’t hold (not_ready); or when the run’s state can’t be locked or written (locked, io).

impl<'r> Lab<'r>

pub fn with_connection(self, secrets: Secrets) -> Lab<'r>

The lab with secrets, the values of its connection slots (an ESXi host’s password), delivered to every operation: status and park, which take no options, too. Kept in memory only, never stored; a value an operation’s options give wins.

pub fn manifest(&self) -> &Manifest

The manifest.

pub fn name(&self) -> &RunName

The run’s name.

pub fn path(&self) -> &Path

The manifest’s file.

pub async fn status(&self) -> Result<Status>

The run as it stands: read-only, never locked, and never an event.

Errors

Fails when the engine can’t be asked (the status step fails or runs out of time) or the run’s record can’t be read.

pub async fn outputs(&self) -> Result<Vec<OutputValue>>

The run’s outputs, read live.

Errors

Fails as Lab::status does.

Trait Implementations

impl Debug for Lab<'_>

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

Formats the value using the given formatter.