Enum RunStatus 

pub enum RunStatus {
    Pending,
    Running,
    Completed,
    Failed,
    Retrying,
    Cancelled,
    AwaitingApproval,
    Warning,
    Sleeping,
    Paused,
}

Status of a workflow run, forming a finite state machine.

Valid transitions:

• Pending -> Running, Cancelled
• Running -> Pending (worker lease expired), Completed, Failed, Warning, Retrying, Cancelled, AwaitingApproval, Sleeping
• Retrying -> Running, Failed, Cancelled
• AwaitingApproval -> Running, Pending (requeued for a worker under ExecutionMode::Workers), Failed, Cancelled
• Sleeping -> Pending (wake-up timer elapsed), Cancelled
• Pending, Retrying, Sleeping, AwaitingApproval, Running -> Paused (operator pause)
• Paused -> Pending, Running, Retrying, Sleeping, AwaitingApproval (resume), Failed (rejection decided while paused), Cancelled

Terminal states (Completed, Failed, Warning, Cancelled) are idempotent: transitioning to the same terminal state is a no-op, not an error.

Examples

use ironflow_store::entities::RunStatus;

assert!(RunStatus::Pending.can_transition_to(&RunStatus::Running));
assert!(!RunStatus::Pending.can_transition_to(&RunStatus::Completed));
assert!(!RunStatus::Completed.can_transition_to(&RunStatus::Running));
assert!(RunStatus::Running.can_transition_to(&RunStatus::AwaitingApproval));
assert!(RunStatus::Running.can_transition_to(&RunStatus::Warning));
// A run whose worker lease expired goes back to the queue:
assert!(RunStatus::Running.can_transition_to(&RunStatus::Pending));
assert!(RunStatus::AwaitingApproval.can_transition_to(&RunStatus::Running));
assert!(RunStatus::AwaitingApproval.can_transition_to(&RunStatus::Pending));
assert!(RunStatus::Running.can_transition_to(&RunStatus::Sleeping));
assert!(RunStatus::Sleeping.can_transition_to(&RunStatus::Pending));
assert!(RunStatus::Sleeping.can_transition_to(&RunStatus::Cancelled));
assert!(RunStatus::Running.can_transition_to(&RunStatus::Paused));
assert!(RunStatus::Paused.can_transition_to(&RunStatus::Pending));
// Terminal-to-same is idempotent:
assert!(RunStatus::Failed.can_transition_to(&RunStatus::Failed));
assert!(RunStatus::Completed.can_transition_to(&RunStatus::Completed));
assert!(RunStatus::Warning.can_transition_to(&RunStatus::Warning));
assert!(RunStatus::Cancelled.can_transition_to(&RunStatus::Cancelled));

JSON schema

{
 "description": "Status of a workflow run, forming a finite state machine.\n\nValid transitions:\n- `Pending` -> `Running`, `Cancelled`\n- `Running` -> `Pending` (worker lease expired), `Completed`, `Failed`, `Warning`, `Retrying`, `Cancelled`, `AwaitingApproval`, `Sleeping`\n- `Retrying` -> `Running`, `Failed`, `Cancelled`\n- `AwaitingApproval` -> `Running`, `Pending` (requeued for a worker under `ExecutionMode::Workers`), `Failed`, `Cancelled`\n- `Sleeping` -> `Pending` (wake-up timer elapsed), `Cancelled`\n- `Pending`, `Retrying`, `Sleeping`, `AwaitingApproval`, `Running` -> `Paused` (operator pause)\n- `Paused` -> `Pending`, `Running`, `Retrying`, `Sleeping`, `AwaitingApproval` (resume),\n  `Failed` (rejection decided while paused), `Cancelled`\n\nTerminal states (`Completed`, `Failed`, `Warning`, `Cancelled`) are idempotent:\ntransitioning to the same terminal state is a no-op, not an error.\n\n# Examples\n\n```\nuse ironflow_store::entities::RunStatus;\n\nassert!(RunStatus::Pending.can_transition_to(&RunStatus::Running));\nassert!(!RunStatus::Pending.can_transition_to(&RunStatus::Completed));\nassert!(!RunStatus::Completed.can_transition_to(&RunStatus::Running));\nassert!(RunStatus::Running.can_transition_to(&RunStatus::AwaitingApproval));\nassert!(RunStatus::Running.can_transition_to(&RunStatus::Warning));\n// A run whose worker lease expired goes back to the queue:\nassert!(RunStatus::Running.can_transition_to(&RunStatus::Pending));\nassert!(RunStatus::AwaitingApproval.can_transition_to(&RunStatus::Running));\nassert!(RunStatus::AwaitingApproval.can_transition_to(&RunStatus::Pending));\nassert!(RunStatus::Running.can_transition_to(&RunStatus::Sleeping));\nassert!(RunStatus::Sleeping.can_transition_to(&RunStatus::Pending));\nassert!(RunStatus::Sleeping.can_transition_to(&RunStatus::Cancelled));\nassert!(RunStatus::Running.can_transition_to(&RunStatus::Paused));\nassert!(RunStatus::Paused.can_transition_to(&RunStatus::Pending));\n// Terminal-to-same is idempotent:\nassert!(RunStatus::Failed.can_transition_to(&RunStatus::Failed));\nassert!(RunStatus::Completed.can_transition_to(&RunStatus::Completed));\nassert!(RunStatus::Warning.can_transition_to(&RunStatus::Warning));\nassert!(RunStatus::Cancelled.can_transition_to(&RunStatus::Cancelled));\n```",
 "type": "string",
 "enum": [
   "pending",
   "running",
   "completed",
   "failed",
   "retrying",
   "cancelled",
   "awaiting_approval",
   "warning",
   "sleeping",
   "paused"
 ]
}
```ignore
</details>

Variants

Pending

Running

Completed

Failed

Retrying

Cancelled

AwaitingApproval

Warning

Sleeping

Paused

Trait Implementations

impl Clone for RunStatus

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for RunStatus

impl Debug for RunStatus

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RunStatus

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for RunStatus

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

Formats the value using the given formatter.

impl Eq for RunStatus

impl FromStr for RunStatus

type Err = ConversionError

The associated error which can be returned from parsing.

fn from_str(value: &str) -> Result<Self, ConversionError>

Parses a string s to return a value of this type.

impl Hash for RunStatus

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for RunStatus

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

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

Restrict a value to a certain range.

impl PartialEq for RunStatus

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for RunStatus

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for RunStatus

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for RunStatus

impl TryFrom<&String> for RunStatus

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: &String) -> Result<Self, ConversionError>

Performs the conversion.

impl TryFrom<&str> for RunStatus

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: &str) -> Result<Self, ConversionError>

Performs the conversion.

impl TryFrom<String> for RunStatus

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: String) -> Result<Self, ConversionError>

Performs the conversion.