Struct Step 

pub struct Step { /* private fields */ }

Times one named step of a reconciliation pass, reporting it to the controller’s ReconcileObserver when finished or dropped.

Created by TraceMetadata::step. A step dropped without being finished is reported as Outcome::Abandoned, so that ? propagating an error out of a step identifies the step the pass stopped in, without any bookkeeping at the early return. The flip side is that every path out of a step that does reach a conclusion must finish it explicitly:

let step = metadata.step("certificate");
if tls_enabled {
    create_certificate().await?;
    step.finish(Outcome::Completed);
} else {
    step.finish(Outcome::Skipped);
}

Implementations

impl Step

pub fn finish(self, outcome: Outcome)

Finishes the step with the given outcome.

pub fn finish_with<E>(self, result: &Result<Option<Action>, E>)

Finishes the step with the outcome classified from a reconciler-style result.

Prefer this to propagating an error out of the step with ? when the result is in hand, since that reports the step as abandoned rather than failed.

Trait Implementations

impl Drop for Step

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.