Enum kube_core::params::Patch

source ·
#[non_exhaustive]
pub enum Patch<T: Serialize> { Apply(T), Json(Patch), Merge(T), Strategic(T), }
Expand description

Describes changes that should be applied to a resource

Takes arbitrary serializable data for all strategies except Json.

We recommend using (server-side) Apply patches on new kubernetes releases.

See kubernetes patch docs for the older patch types.

Note that patches have different effects on different fields depending on their merge strategies. These strategies are configurable when deriving your CustomResource.

§Creating a patch via serde_json

use kube::api::Patch;
let patch = serde_json::json!({
    "apiVersion": "v1",
    "kind": "Pod",
    "metadata": {
        "name": "blog"
    },
    "spec": {
        "activeDeadlineSeconds": 5
    }
});
let patch = Patch::Apply(&patch);

§Creating a patch from a type

use kube::api::Patch;
use k8s_openapi::api::rbac::v1::Role;
use k8s_openapi::apimachinery::pkg::apis::meta::v1::ObjectMeta;
let r = Role {
    metadata: ObjectMeta { name: Some("user".into()), ..ObjectMeta::default() },
    rules: Some(vec![])
};
let patch = Patch::Apply(&r);

Variants (Non-exhaustive)§

This enum is marked as non-exhaustive
Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.
§

Apply(T)

Server side apply

Requires kubernetes >= 1.16

§

Json(Patch)

JSON patch

Using this variant will require you to explicitly provide a type for T at the moment.

§Example

use kube::api::Patch;
let json_patch = json_patch::Patch(vec![]);
let patch = Patch::Json::<()>(json_patch);
§

Merge(T)

§

Strategic(T)

Trait Implementations§

source§

impl<T: Clone + Serialize> Clone for Patch<T>

source§

fn clone(&self) -> Patch<T>

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl<T: Debug + Serialize> Debug for Patch<T>

source§

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

Formats the value using the given formatter. Read more
source§

impl<T: PartialEq + Serialize> PartialEq for Patch<T>

source§

fn eq(&self, other: &Patch<T>) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 · source§

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

impl<T: Serialize> StructuralPartialEq for Patch<T>

Auto Trait Implementations§

§

impl<T> Freeze for Patch<T>
where T: Freeze,

§

impl<T> RefUnwindSafe for Patch<T>
where T: RefUnwindSafe,

§

impl<T> Send for Patch<T>
where T: Send,

§

impl<T> Sync for Patch<T>
where T: Sync,

§

impl<T> Unpin for Patch<T>
where T: Unpin,

§

impl<T> UnwindSafe for Patch<T>
where T: UnwindSafe,

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> CloneToUninit for T
where T: Clone,

source§

default unsafe fn clone_to_uninit(&self, dst: *mut T)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dst. Read more
source§

impl<T> DynClone for T
where T: Clone,

source§

fn __clone_box(&self, _: Private) -> *mut ()

source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.