Enum RepositoryReplicationPhase 

pub enum RepositoryReplicationPhase {
    Pending,
    Replicating,
    Succeeded,
    Failed,
    Suspended,
    Unknown(String),
}

Lifecycle phase of a replication.

use kopiur_api::repository_replication::RepositoryReplicationPhase as P;

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

Variants

Pending

Admitted, not yet run (also the default).

Replicating

A replication mover Job is in flight.

Succeeded

The most recent replication completed successfully (idle until the next slot).

Failed

The most recent replication run failed; see conditions.

Suspended

Suspended via spec.suspend.

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 a success.

Implementations

impl RepositoryReplicationPhase

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”, never “unusual” or “not one I handle”. A canonical variant added to this enum later is by definition not the sentinel, which is why the match is written out exhaustively rather than left as a matches! — the compiler, not a reviewer, is what forces the new variant to answer.

The reconciler uses it for its entry-time version-skew warning (io::warn_unreadable_phase). Unlike the other drivers, it does not promptly overwrite what it cannot read: no branch reads this phase, and the terminal stamp comes from the mover at the end of a run, so an unreadable value simply persists — up to a whole schedule interval. The warning is therefore repeated every pass rather than emitted once: the log is where the skew is visible.

use kopiur_api::RepositoryReplicationPhase;

assert!(RepositoryReplicationPhase::Unknown("Verifying".into()).is_unknown());
assert!(!RepositoryReplicationPhase::Pending.is_unknown());
assert!(!RepositoryReplicationPhase::Replicating.is_unknown());
assert!(!RepositoryReplicationPhase::Suspended.is_unknown());

Trait Implementations

impl Clone for RepositoryReplicationPhase

fn clone(&self) -> RepositoryReplicationPhase

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RepositoryReplicationPhase

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

Formats the value using the given formatter.

impl Default for RepositoryReplicationPhase

fn default() -> RepositoryReplicationPhase

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for RepositoryReplicationPhase

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

Deserialize this value from the given Serde deserializer.

impl Eq for RepositoryReplicationPhase

impl JsonSchema for RepositoryReplicationPhase

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 RepositoryReplicationPhase

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

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 RepositoryReplicationPhase

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

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for RepositoryReplicationPhase