Struct RenderedResourceCoords 

pub struct RenderedResourceCoords {
    pub api_version: String,
    pub kind: String,
    pub name: String,
    pub namespace: Option<String>,
}

Identifying coordinates of a rendered K8s resource — the (apiVersion, kind, metadata.name, metadata.namespace) 4-tuple every consumer that walks a rendered serde_json::Value resource unwraps by hand pre-lift.

The three K8s API-path segments (apiVersion, kind, metadata.name) are REQUIRED — a rendered resource missing any of them cannot be applied via kube-rs’s dynamic API surface, so the extraction fails fast at the boundary rather than as a downstream Api::patch panic. metadata.namespace is intentionally kept as Option<String> because different consumers resolve the fallback differently: apply_owned uses the caller-supplied namespace: &str argument (the reconciler already resolved the target namespace upstream), while flux_ref_from_json records the K8s canonical "default" fallback into the persisted FluxResourceRef.namespace slot. The peer method Self::namespace_or_default applies the K8s canonical fallback (Process::DEFAULT_NAMESPACE = "default") for consumers wanting the same shape [FluxResourceRef.namespace] carries.

Pre-lift the 3+1 slot extraction was hand-authored at TWO sites past the ★★ PRIME-DIRECTIVE ≥ 2 duplication threshold across tatara-reconciler:

• tatara-reconciler::phase_machine::flux_ref_from_json — the post-SSA FluxResourceRef builder that persists into ProcessStatus.flux_resources; namespace half fallback- defaulted to "default".
• tatara-reconciler::ssapply::apply_owned — the SSA entry point that extracts (apiVersion, kind, name) for the kube::Api::patch call; namespace half discarded (the namespace: &str argument comes from the caller upstream).

Both callsites restated the same three .get(K).and_then(|v| v.as_str()).ok_or_else(|| anyhow!(...))? .to_string() incantations with subtly different error wording ("resource missing X" vs "rendered resource missing X"); post- lift both route through this ONE substrate owner with the canonical "rendered resource missing X" wording. A future addition (case-fold on the group, a rename of the namespace fallback, a stricter kind gate, a Unicode-safe collation step, support for metadata.generateName as a name fallback) lands at the primitive’s body on the substrate, not at 2 independent hand-writes across 2 reconciler files.

Namespace fallback const is shared with Process::DEFAULT_NAMESPACE — a rename of the K8s canonical default namespace lands at that ONE workspace-wide const, not at per-primitive local literals that would drift silently.

Fields

api_version: String

apiVersion — the group+version pair kube-rs uses to resolve the ApiResource for the SSA call.

kind: String

kind — the resource kind (Kustomization, HelmRelease, …).

name: String

metadata.name — the API-path leaf segment.

namespace: Option<String>

metadata.namespace — raw from the resource, None when the slot is absent (a cluster-scoped resource, or a namespaced resource whose namespace was left for the API server to substitute). Consumers apply their own fallback: Self::namespace_or_default applies the K8s canonical "default" (matching what [FluxResourceRef.namespace] records); other consumers substitute a caller-supplied string (see tatara-reconciler::ssapply::apply_owned).

Implementations

impl RenderedResourceCoords

pub fn from_json(res: &Value) -> Result<Self>

Extract the 4-tuple from a rendered K8s resource JSON Value.

Fails with a canonical "rendered resource missing X" message when any of the three required slots (apiVersion, kind, metadata.name) is absent or non-string; metadata.namespace is optional and captured as None when absent.

The error wording is pinned by [tests::rendered_resource_coords_error_wording_is_canonical] so a regression that reshaped the message surfaces at the test surface rather than as silent drift between the two pre-lift call sites (which used subtly different wording — "resource missing X" in apply_owned vs "rendered resource missing X" in flux_ref_from_json).

pub fn namespace_or_default(&self) -> &str

metadata.namespace slice with the K8s canonical "default" fallback applied — matching what Process::DEFAULT_NAMESPACE spells for the Process-borne coordinate primitive family and what [FluxResourceRef.namespace] records into ProcessStatus.flux_resources.

Trait Implementations

impl Clone for RenderedResourceCoords

fn clone(&self) -> RenderedResourceCoords

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RenderedResourceCoords

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

Formats the value using the given formatter.

impl Eq for RenderedResourceCoords

impl PartialEq for RenderedResourceCoords

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for RenderedResourceCoords