Struct K8sObjectRef 

pub struct K8sObjectRef {
    pub kind: String,
    pub name: String,
    pub namespace: String,
}

K8s cross-resource reference — the 3-slot { "kind", "name", "namespace" } pointer one K8s resource carries at a sourceRef / chartRef / equivalent nested slot to point at another K8s resource in the cluster.

The slot set is intentionally the 3-slot form (no apiVersion) used by FluxCD’s sourceRef + chartRef slots and the K8s TypedLocalObjectReference / TypedObjectReference shapes: the owning controller derives the apiVersion from kind (typically by dispatch through its own resource registry), so an emit site that hand-stamped an apiVersion here would either be ignored (adding a fourth slot no controller reads) or silently take precedence over the controller’s derivation and mis-route resolution. The composer at Self::as_json emits exactly the 3-slot shape — a regression that added or removed a slot would surface at this module’s byte-shape pins.

Fields

kind: String

K8s wire-form kind string of the referenced resource — the PascalCase identifier the owning controller matches against its resource registry to derive the apiVersion + REST route.

name: String

K8s metadata.name of the referenced resource — the API-path leaf segment.

namespace: String

K8s metadata.namespace of the referenced resource. The K8s cross-reference form treats this as a required slot even when the reference lives in the same namespace as the referrer (every pre-lift callsite in tatara-reconciler::render stamped it explicitly), so this primitive carries it unconditionally.

Implementations

impl K8sObjectRef

pub fn new( kind: impl Into<String>, name: impl Into<String>, namespace: impl Into<String>, ) -> Self

Construct a K8sObjectRef from the (kind, name, namespace) triple. Accepts any Into<String> at each slot so a caller with &str / String / Cow<'_, str> composes without a .to_string() per site.

pub fn as_json(&self) -> Value

Emit as a 3-slot { "kind": …, "name": …, "namespace": … } JSON object — the exact shape every pre-lift sourceRef / chartRef block in tatara-reconciler::render hand-authored by inlining three Value::String slot insertions. Slot count

• slot keys are pinned by [tests::as_json_emits_exactly_three_slots_named_kind_name_namespace] so a regression that added or removed a slot (or renamed one to camelCase drift) surfaces at the primitive rather than as silent wire-form skew at every emit site.

Trait Implementations

impl Clone for K8sObjectRef

fn clone(&self) -> K8sObjectRef

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for K8sObjectRef

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

Formats the value using the given formatter.

impl Eq for K8sObjectRef

impl Hash for K8sObjectRef

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for K8sObjectRef

fn eq(&self, other: &K8sObjectRef) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for K8sObjectRef