Struct TaskRun 

pub struct TaskRun {
    pub attempt: u32,
    pub phase: TaskPhase,
    pub started_at: SystemTime,
    pub finished_at: Option<SystemTime>,
    pub error: Option<String>,
    pub exit_code: Option<i32>,
}

Record of a single task execution attempt.

Each time the supervisor starts a task, a new TaskRun is created. When the attempt finishes (success, failure, timeout, etc.), the run is closed with the terminal phase and timestamp.

Runs are associated with a Task via its TaskId and ordered by attempt number.

Also

• Task parent resource.
• TaskPhase phase values stored in phase field.

Lifecycle

  TaskStarting  ──►  TaskRun { phase: Running, finished_at: None }
       │
       ├──► TaskStopped   ──►  phase = Succeeded, finished_at = Some(now)
       ├──► TaskFailed    ──►  phase = Failed,    finished_at = Some(now)
       ├──► TimeoutHit    ──►  phase = Timeout,   finished_at = Some(now)
       └──► ActorExhausted ──► phase = Exhausted, finished_at = Some(now)

Fields

attempt: u32

Attempt number (1-based, matches the task’s attempt counter after increment).

phase: TaskPhase

Phase this run ended in (or Running if still active).

started_at: SystemTime

When the run started.

finished_at: Option<SystemTime>

When the run finished (None while still running).

error: Option<String>

Error message (present when phase is Failed/Timeout/Exhausted).

exit_code: Option<i32>

Process exit code (Subprocess/Container only).

Implementations

impl TaskRun

pub fn starting(attempt: u32) -> Self

Create a new run record for an attempt that just started.

pub fn finish( &mut self, phase: TaskPhase, error: Option<String>, exit_code: Option<i32>, )

Close the run with a terminal phase.

pub fn is_active(&self) -> bool

Whether this run is still in progress.

Trait Implementations

impl Clone for TaskRun

fn clone(&self) -> TaskRun

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TaskRun

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TaskRun

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for TaskRun

fn eq(&self, other: &TaskRun) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for TaskRun

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for TaskRun

impl StructuralPartialEq for TaskRun