Struct Operation 

pub struct Operation {
    pub id: String,
    pub method: HttpMethod,
    pub path: String,
    pub body: Option<Value>,
    pub content_type: Option<String>,
    pub verb_probe: Option<(Gvr, Verb)>,
    pub kind: OpKind,
    pub focus: Option<JsonPath>,
}

One authored operation.

Fields

id: String

Stable identifier (report + status-diff signature).

method: HttpMethod

The HTTP verb.

path: String

The REST path (already rendered, incl. any query string).

body: Option<Value>

Request body, if any.

content_type: Option<String>

Content-Type header, if any.

verb_probe: Option<(Gvr, Verb)>

When set, a status mismatch on this op is reported as a Divergence::MissingVerb (one side supports the verb, the other refuses) rather than a bare status-code diff.

kind: OpKind

The surface class.

focus: Option<JsonPath>

When set (for OpKind::Object), the differ restricts the object comparison to the subtree at this path — a FIELD-LEVEL probe. It isolates a targeted invariant (e.g. “a /status PUT left spec.containers[0].image unchanged”) from a kind’s unrelated server-side-defaulting divergence, so a Pod field-diff need not carry the whole (heavily-defaulted) PodSpec into the ratchet.

Implementations

impl Operation

pub fn with_focus(self, focus: JsonPath) -> Self

Restrict the object diff to the subtree at focus (a field-level probe). Builder style; see Operation::focus.

pub fn create_namespace(name: &str) -> Self

POST a new Namespace.

pub fn get_namespace(name: &str) -> Self

GET a Namespace (where server-side defaulting divergences surface).

pub fn create_configmap(ns: &str, name: &str, data: Value) -> Self

POST a new ConfigMap with the given data.

pub fn get_configmap(ns: &str, name: &str) -> Self

GET a ConfigMap.

pub fn create_labeled_configmap( ns: &str, name: &str, labels: &[(&str, &str)], ) -> Self

POST a ConfigMap carrying labels (the selector-test vehicle). The labels drive labelSelector matching; the trivial data keeps the object valid.

pub fn list_configmaps(ns: &str, name_filter: &str) -> Self

LIST ConfigMaps filtered to a single name via fieldSelector (isolates the diff from cluster-auto-created objects like kube-root-ca.crt). The = in the selector is percent-encoded.

pub fn merge_patch_configmap(ns: &str, name: &str, patch: Value) -> Self

PATCH a ConfigMap (JSON merge patch).

pub fn replace_configmap(ns: &str, name: &str, body: Value) -> Self

PUT (replace) a ConfigMap — the sharp verb probe. engenho’s router refuses PUT on the main object (400); k3s returns 200. A status mismatch here becomes MissingVerb{Update, present_on: K3s}.

pub fn delete_configmap(ns: &str, name: &str) -> Self

DELETE a ConfigMap.

pub fn delete_namespace(name: &str) -> Self

DELETE a Namespace (cleanup on the shared k3s cluster).

pub fn discovery_core_v1() -> Self

GET the core/v1 discovery index.

pub fn merge_patch(ns: &str, plural: &str, name: &str, patch: Value) -> Self

PATCH an object with an application/merge-patch+json body (RFC 7386).

pub fn strategic_patch(ns: &str, plural: &str, name: &str, patch: Value) -> Self

PATCH an object with an application/strategic-merge-patch+json body (K8s strategic merge — list-merge-by-key, $patch: delete, null-removes-key).

pub fn json_patch(ns: &str, plural: &str, name: &str, ops: Value) -> Self

PATCH an object with an application/json-patch+json body (RFC 6902 — an op array).

pub fn get(ns: &str, plural: &str, name: &str) -> Self

GET an object of any kind.

pub fn create_pod(ns: &str, name: &str, image: &str) -> Self

POST a minimal single-container Pod (container named c).

pub fn create_pod_containers( ns: &str, name: &str, containers: &[(&str, &str)], ) -> Self

POST a Pod with the given (container-name, image) list — the vehicle for the strategic list-merge-by-key probe (patch ONE container by name, prove the others survive).

pub fn delete_pod(ns: &str, name: &str) -> Self

DELETE a Pod (force, no grace, best-effort cleanup on the oracle).

pub fn get_status(ns: &str, plural: &str, name: &str) -> Self

GET the /status subresource of an object.

pub fn put_status(ns: &str, plural: &str, name: &str, body: Value) -> Self

PUT the /status subresource of an object.

pub fn replace(ns: &str, plural: &str, name: &str, body: Value) -> Self

PUT (replace) the MAIN object of any kind.

pub fn list_selector( ns: &str, plural: &str, id_tag: &str, label_selector: Option<&str>, field_selector: Option<&str>, ) -> Self

LIST a namespaced collection with an optional labelSelector and/or fieldSelector. Both selector strings are percent-encoded through the typed pct_encode (never a raw format!() of the query), so the full k8s selector grammar (in (a,b), !k, k!=v) round-trips on the wire.

pub fn body_bytes(&self) -> Option<Vec<u8>>

The body serialized to bytes, if present.

Trait Implementations

impl Clone for Operation

fn clone(&self) -> Operation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Operation

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

Formats the value using the given formatter.