Enum ExecutionDescription 

pub enum ExecutionDescription<'a, S: OutputSpec> {
    Success {
        single_status: &'a ExecuteStatus<S>,
    },
    Flaky {
        last_status: &'a ExecuteStatus<S>,
        prior_statuses: &'a [ExecuteStatus<S>],
        result: FlakyResult,
    },
    Failure {
        first_status: &'a ExecuteStatus<S>,
        last_status: &'a ExecuteStatus<S>,
        retries: &'a [ExecuteStatus<S>],
    },
}

A description of test executions obtained from ExecuteStatuses.

This can be used to quickly determine whether a test passed, failed or was flaky.

The type parameter S specifies how test output is stored (see OutputSpec).

Variants

Success

The test was run once and was successful.

Fields

single_status: &'a ExecuteStatus<S>

The status of the test.

Flaky

The test was run more than once. The final result was successful.

Fields

last_status: &'a ExecuteStatus<S>

The last, successful status.

prior_statuses: &'a [ExecuteStatus<S>]

Previous statuses, none of which are successes.

result: FlakyResult

Controls whether this flaky test is treated as a pass or a failure.

Failure

The test was run once, or possibly multiple times. All runs failed.

Fields

first_status: &'a ExecuteStatus<S>

The first, failing status.

last_status: &'a ExecuteStatus<S>

The last, failing status. Same as the first status if no retries were performed.

retries: &'a [ExecuteStatus<S>]

Any retries that were performed. All of these runs failed.

May be empty.

Implementations

impl<'a, S: OutputSpec> ExecutionDescription<'a, S>

pub fn status_level(&self) -> StatusLevel

Returns the status level for this ExecutionDescription.

pub fn final_status_level(&self) -> FinalStatusLevel

Returns the final status level for this ExecutionDescription.

pub fn is_success_for_output(&self) -> bool

Returns whether this test’s output should be treated as success output for display and storage purposes.

For flaky tests (both pass and fail variants), the last attempt succeeded, so its output is success output: it contains no panics or errors, and is generally not interesting. The failure information comes from the status line and from prior retry attempts’ output (shown via TestAttemptFailedWillRetry events, controlled by failure-output).

This means:

• The visibility is controlled by success-output.
• The styling is pass/green headers, no error extraction.
• JUnit storage is controlled by store-success-output (default: false).

The status line uses failure semantics independently (e.g. FLKY-FL in red for flaky-fail tests).

pub fn last_status(&self) -> &'a ExecuteStatus<S>

Returns the last run status.

Trait Implementations

impl<S: OutputSpec> Clone for ExecutionDescription<'_, S>

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a, S: OutputSpec> Debug for ExecutionDescription<'a, S>

where S::ChildOutputDesc: Debug,

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

Formats the value using the given formatter.

impl<S: OutputSpec> Copy for ExecutionDescription<'_, S>