Enum RestorePhase 

pub enum RestorePhase {
    Pending,
    Resolving,
    Restoring,
    Completed,
    Failed,
    Unknown(String),
}

Lifecycle phase of a restore.

use kopiur_api::RestorePhase;

assert_eq!(serde_json::to_value(RestorePhase::Restoring).unwrap(), "Restoring");
// An unrecognized phase from a newer operator decodes instead of erroring.
let p: RestorePhase = serde_json::from_value(serde_json::json!("Staging")).unwrap();
assert_eq!(p, RestorePhase::Unknown("Staging".into()));
assert_eq!(serde_json::to_value(&p).unwrap(), "Staging");
assert!(!p.is_terminal());

Variants

Pending

Admitted but not yet acted on; the default initial phase.

Resolving

Resolving the source to a concrete snapshot and pinning it to status.

Restoring

The mover Job is actively writing data into the target.

Completed

The restore finished successfully.

Failed

The restore terminally failed; see conditions for the reason.

Unknown(String)

A phase string this build does not recognize (newer operator, or legacy stored data). Decode-compat only — hidden from the CRD schema, never produced by this build, never terminal.

Implementations

impl RestorePhase

pub fn is_terminal(&self) -> bool

Whether this phase is terminal: the restore reached an end state and the operator will do no further work on it of its own accord.

Pending, Resolving, and Restoring are all in-flight — including a Pending restore parked on a structural gate (see crate::gates::STRUCTURAL_GATES), which never progresses but is emphatically not finished. A Restore has no deletion phase of its own, so unlike SnapshotPhase there is no wedged-finalizer case to exclude.

Pure + exhaustive so the single definition lives in one tested place.

use kopiur_api::RestorePhase;

assert!(RestorePhase::Completed.is_terminal());
assert!(RestorePhase::Failed.is_terminal());
assert!(!RestorePhase::Pending.is_terminal());
assert!(!RestorePhase::Resolving.is_terminal());
assert!(!RestorePhase::Restoring.is_terminal());
assert!(!RestorePhase::Unknown("Staging".into()).is_terminal());

pub fn is_unknown(&self) -> bool

Whether this phase is the decode sentinel — a value the running build cannot interpret, kept verbatim by Unknown instead of failing the whole typed list()/watch (#359, defect 3).

Same narrow contract as SnapshotPhase::is_unknown: true means only “this string is not a phase this binary knows”. A canonical variant added later is not the sentinel, which is why the match is written out exhaustively rather than left as a matches!.

use kopiur_api::RestorePhase;

assert!(RestorePhase::Unknown("Staging".into()).is_unknown());
assert!(!RestorePhase::Completed.is_unknown());
assert!(!RestorePhase::Failed.is_unknown());

Trait Implementations

impl Clone for RestorePhase

fn clone(&self) -> RestorePhase

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RestorePhase

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

Formats the value using the given formatter.

impl Default for RestorePhase

fn default() -> RestorePhase

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for RestorePhase

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl Eq for RestorePhase

impl JsonSchema for RestorePhase

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn json_schema(_: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

impl PartialEq for RestorePhase

fn eq(&self, other: &RestorePhase) -> 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 PhaseLabel for RestorePhase

const ALL: &'static [Self]

Every canonical variant, in declaration order. Never contains Unknown.

fn label(&self) -> &str

The stable metric/wire label string for this variant (exhaustive match); the Unknown arm echoes the stored value verbatim so a read-modify-write never mutates a phase this build does not understand.

fn unknown(raw: String) -> Self

Build the decode-compat fallback for a non-canonical stored string. Implemented by the phase_serde! macro’s host enum.

fn parse(s: &str) -> Option<Self>

Parse a canonical label; None for anything else (including a value that would decode to Unknown). Derived from ALL + label() so a new variant is parseable the moment it is declared.

fn canonical() -> Vec<&'static str>

The canonical label set, for the CRD schema enum and “valid values” messages. One definition, derived from ALL.

impl Serialize for RestorePhase

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for RestorePhase