Struct RepositoryRef 

pub struct RepositoryRef {
    pub kind: RepositoryKind,
    pub name: String,
    pub namespace: Option<String>,
}

Discriminated reference from a consumer CR (BackupConfig, Backup, Restore, Maintenance) to a Repository or ClusterRepository. ADR §3.2.

When kind == ClusterRepository, namespace MUST be absent — enforced by the admission webhook (api::validate), since the type system cannot express “this field is forbidden only for one variant of a sibling field”.

Fields

kind: RepositoryKind

Which repository CRD this points at; defaults to RepositoryKind::Repository.

name: String

Name of the referenced Repository/ClusterRepository.

namespace: Option<String>

Cross-namespace Repository reference; ignored/forbidden for ClusterRepository.

Implementations

impl RepositoryRef

pub fn resolves_to( &self, owner_namespace: &str, target_kind: RepositoryKind, target_name: &str, target_namespace: Option<&str>, ) -> bool

True if this reference points at the given repository.

owner_namespace is the namespace of the resource that holds the ref (e.g. the Maintenance CR’s own namespace), used to resolve a namespaced Repository reference that omits namespace. The match is exhaustive over RepositoryKind (ADR §5.5):

• RepositoryKind::Repository: kind+name must match AND the effective namespace (self.namespace or owner_namespace) must equal target_namespace.
• RepositoryKind::ClusterRepository: kind+name must match; namespace is ignored on both sides (cluster-scoped).

target_namespace is None for a ClusterRepository target.

use kopiur_api::common::{RepositoryKind, RepositoryRef};

// A namespaced ref that omits `namespace` resolves against the owner's namespace.
let r = RepositoryRef { kind: RepositoryKind::Repository, name: "nas".into(), namespace: None };
assert!(r.resolves_to("apps", RepositoryKind::Repository, "nas", Some("apps")));
assert!(!r.resolves_to("apps", RepositoryKind::Repository, "nas", Some("other")));

// A cluster-scoped target ignores namespace entirely.
let cr = RepositoryRef {
    kind: RepositoryKind::ClusterRepository,
    name: "hetzner".into(),
    namespace: None,
};
assert!(cr.resolves_to("apps", RepositoryKind::ClusterRepository, "hetzner", None));
// Kind must match even when names collide.
assert!(!r.resolves_to("apps", RepositoryKind::ClusterRepository, "nas", None));

Trait Implementations

impl Clone for RepositoryRef

fn clone(&self) -> RepositoryRef

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RepositoryRef

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RepositoryRef

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for RepositoryRef

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 RepositoryRef

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for RepositoryRef

impl StructuralPartialEq for RepositoryRef