Enum ReplicationManualRunPhase 

pub enum ReplicationManualRunPhase {
    Pending,
    Running,
    Succeeded,
    Failed,
    Unknown(String),
}

Lifecycle of an annotation-requested (on-demand) replication run, shared by RepositoryReplication and SnapshotReplication.

Closed on the wire, open on decode — the same contract every kopiur phase carries (see the phase_serde! macro): the CRD schema admits exactly Pending/Running/Succeeded/Failed, and Self::Unknown exists only so a value written by a NEWER kopiur decodes instead of failing the typed watch for the whole Kind.

It has a Pending variant that crate::ManualRunPhase does not: a replication can be suspend: true when the request lands, and a request that cannot start yet must be VISIBLE rather than silently queued.

use kopiur_api::common::ReplicationManualRunPhase;

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

Variants

Pending

The request is recorded but no Job can start yet (the replication is suspend: true); it runs when the block clears.

Running

The mover Job for this request is in flight.

Succeeded

The requested run completed successfully.

Failed

The requested run’s Job failed; conditions carry the detail.

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 counted as a finished run, so a re-run request is never deduped against it.

Implementations

impl ReplicationManualRunPhase

pub fn is_unknown(&self) -> bool

Whether this is the decode-compat Self::Unknown sentinel. The exhaustive match lives here so a variant added later cannot be silently classified by an if let … Unknown(_) probe elsewhere.

pub fn implies_job_launched(&self) -> bool

Whether this phase says a mover Job for the request EXISTS OR EXISTED.

The controller’s “the Job vanished before its outcome was observed” check: Running with no Job present means a TTL reap beat the reconcile, and re-running side-effectful work silently would be worse than reporting the lost outcome. Exhaustive rather than an equality so a phase added later must state whether it implies a Job was launched — under == the new variant would silently take the “no Job ever ran” branch.

pub fn answers_request(&self) -> bool

Whether this phase ANSWERS the request it is recorded against — i.e. the run reached a terminal outcome, so re-applying the same run-requested value is a no-op.

Exhaustive on purpose: this predicate decides whether a user’s run request is DROPPED, so a new phase must state whether it counts as an answer. Unknown is deliberately NOT an answer — re-driving is idempotent (the Job name is keyed on the request timestamp), whereas dropping the request loses the run.

Trait Implementations

impl Clone for ReplicationManualRunPhase

fn clone(&self) -> ReplicationManualRunPhase

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ReplicationManualRunPhase

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ReplicationManualRunPhase

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

Deserialize this value from the given Serde deserializer.

impl Eq for ReplicationManualRunPhase

impl JsonSchema for ReplicationManualRunPhase

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 ReplicationManualRunPhase

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

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 ReplicationManualRunPhase

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

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ReplicationManualRunPhase