Enum Origin 

pub enum Origin {
    Scheduled,
    Manual,
    Discovered,
    Adopted,
    Replicated,
}

How a Snapshot came to exist. Canonical value mirrored from the kopiur.home-operations.com/origin label. Origin drives the deletion-policy default: discovered backups are forced to Retain because the operator did not create those snapshots.

Variants

Scheduled

Created by a SnapshotSchedule; spec carries policyRef.

Manual

Created by kubectl create / external automation; spec carries policyRef.

Discovered

Materialized by the catalog scan for a snapshot kopiur didn’t produce.

Adopted

A discovered snapshot whose resolved identity matched a live SnapshotPolicy and was automatically (or explicitly) re-attached to it: it now carries that policy’s config label and is retention-governed like any produced row, even though the operator did not create the underlying kopia snapshot.

Replicated

A destination-side copy CR minted by a SnapshotReplication run: the kopia snapshot it represents was snapshot migrated from another repository, not produced by a backup run here. Like discovered/ adopted it is catalog history — it must never enter the backup-run machinery — but it is pruned only by its SnapshotReplication’s own pruning mode, never by any policy’s GFS retention.

Implementations

impl Origin

pub const ALL: &'static [Self]

Every variant, for the label-value ↔ parse round-trip tests and consumer-side variant-count guards (e.g. the CLI’s OriginFilter). A new variant added without extending this array fails the round-trip test (and label_value/parse’s exhaustive matches won’t compile until it is classified).

impl Origin

pub fn label_value(self) -> &'static str

The stable wire/label value (the serde camelCase encoding), for the kopiur.home-operations.com/origin label and status.origin — single definition so producers (controller, kubectl plugin) cannot drift.

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

Strict, TOTAL parse of an origin marker (the origin label / status.origin wire value): None for anything unrecognized.

The single inverse of label_value, so string matchers (the controller’s resolve_origin, the webhook’s backup_origin) can never silently classify an unknown origin as a known one. The pre-parse versions of both defaulted unknown strings to Manual — which would have routed a row written by a NEWER operator (e.g. replicated before this variant existed) into the backup-run machinery and minted a mover Job for a snapshot this build does not understand. Callers must treat None conservatively: warn + inert handling, never Manual.

Trait Implementations

impl Clone for Origin

fn clone(&self) -> Origin

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Origin

impl Debug for Origin

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

Formats the value using the given formatter.

impl Default for Origin

fn default() -> Origin

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Origin

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Origin

impl JsonSchema for Origin

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

The name of the generated JSON Schema.

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

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

fn json_schema(generator: &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.

impl PartialEq for Origin

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

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 Origin