#
k8s_openapi/v1_35/api/resource/v1/
device_class_spec.rs

    1// Generated from definition io.k8s.api.resource.v1.DeviceClassSpec
    2
    3/// DeviceClassSpec is used in a \[DeviceClass\] to define what can be allocated and how to configure it.
    4#[derive(Clone, Debug, Default, PartialEq)]
    5pub struct DeviceClassSpec {
    6    /// Config defines configuration parameters that apply to each device that is claimed via this class. Some classses may potentially be satisfied by multiple drivers, so each instance of a vendor configuration applies to exactly one driver.
    7    ///
    8    /// They are passed to the driver, but are not considered while allocating the claim.
    9    pub config: Option<std::vec::Vec<crate::api::resource::v1::DeviceClassConfiguration>>,
    10
    11    /// ExtendedResourceName is the extended resource name for the devices of this class. The devices of this class can be used to satisfy a pod's extended resource requests. It has the same format as the name of a pod's extended resource. It should be unique among all the device classes in a cluster. If two device classes have the same name, then the class created later is picked to satisfy a pod's extended resource requests. If two classes are created at the same time, then the name of the class lexicographically sorted first is picked.
    12    ///
    13    /// This is an alpha field.
    14    pub extended_resource_name: Option<std::string::String>,
    15
    16    /// Each selector must be satisfied by a device which is claimed via this class.
    17    pub selectors: Option<std::vec::Vec<crate::api::resource::v1::DeviceSelector>>,
    18}
    19
    20impl crate::DeepMerge for DeviceClassSpec {
    21    fn merge_from(&mut self, other: Self) {
    22        crate::merge_strategies::list::atomic(&mut self.config, other.config);
    23        crate::DeepMerge::merge_from(&mut self.extended_resource_name, other.extended_resource_name);
    24        crate::merge_strategies::list::atomic(&mut self.selectors, other.selectors);
    25    }
    26}
    27
    28impl<'de> crate::serde::Deserialize<'de> for DeviceClassSpec {
    29    fn deserialize<D>(deserializer: D) -> Result<Self, D::Error> where D: crate::serde::Deserializer<'de> {
    30        #[allow(non_camel_case_types)]
    31        enum Field {
    32            Key_config,
    33            Key_extended_resource_name,
    34            Key_selectors,
    35            Other,
    36        }
    37
    38        impl<'de> crate::serde::Deserialize<'de> for Field {
    39            fn deserialize<D>(deserializer: D) -> Result<Self, D::Error> where D: crate::serde::Deserializer<'de> {
    40                struct Visitor;
    41
    42                impl crate::serde::de::Visitor<'_> for Visitor {
    43                    type Value = Field;
    44
    45                    fn expecting(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result {
    46                        f.write_str("field identifier")
    47                    }
    48
    49                    fn visit_str<E>(self, v: &str) -> Result<Self::Value, E> where E: crate::serde::de::Error {
    50                        Ok(match v {
    51                            "config" => Field::Key_config,
    52                            "extendedResourceName" => Field::Key_extended_resource_name,
    53                            "selectors" => Field::Key_selectors,
    54                            _ => Field::Other,
    55                        })
    56                    }
    57                }
    58
    59                deserializer.deserialize_identifier(Visitor)
    60            }
    61        }
    62
    63        struct Visitor;
    64
    65        impl<'de> crate::serde::de::Visitor<'de> for Visitor {
    66            type Value = DeviceClassSpec;
    67
    68            fn expecting(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result {
    69                f.write_str("DeviceClassSpec")
    70            }
    71
    72            fn visit_map<A>(self, mut map: A) -> Result<Self::Value, A::Error> where A: crate::serde::de::MapAccess<'de> {
    73                let mut value_config: Option<std::vec::Vec<crate::api::resource::v1::DeviceClassConfiguration>> = None;
    74                let mut value_extended_resource_name: Option<std::string::String> = None;
    75                let mut value_selectors: Option<std::vec::Vec<crate::api::resource::v1::DeviceSelector>> = None;
    76
    77                while let Some(key) = crate::serde::de::MapAccess::next_key::<Field>(&mut map)? {
    78                    match key {
    79                        Field::Key_config => value_config = crate::serde::de::MapAccess::next_value(&mut map)?,
    80                        Field::Key_extended_resource_name => value_extended_resource_name = crate::serde::de::MapAccess::next_value(&mut map)?,
    81                        Field::Key_selectors => value_selectors = crate::serde::de::MapAccess::next_value(&mut map)?,
    82                        Field::Other => { let _: crate::serde::de::IgnoredAny = crate::serde::de::MapAccess::next_value(&mut map)?; },
    83                    }
    84                }
    85
    86                Ok(DeviceClassSpec {
    87                    config: value_config,
    88                    extended_resource_name: value_extended_resource_name,
    89                    selectors: value_selectors,
    90                })
    91            }
    92        }
    93
    94        deserializer.deserialize_struct(
    95            "DeviceClassSpec",
    96            &[
    97                "config",
    98                "extendedResourceName",
    99                "selectors",
    100            ],
    101            Visitor,
    102        )
    103    }
    104}
    105
    106impl crate::serde::Serialize for DeviceClassSpec {
    107    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error> where S: crate::serde::Serializer {
    108        let mut state = serializer.serialize_struct(
    109            "DeviceClassSpec",
    110            self.config.as_ref().map_or(0, |_| 1) +
    111            self.extended_resource_name.as_ref().map_or(0, |_| 1) +
    112            self.selectors.as_ref().map_or(0, |_| 1),
    113        )?;
    114        if let Some(value) = &self.config {
    115            crate::serde::ser::SerializeStruct::serialize_field(&mut state, "config", value)?;
    116        }
    117        if let Some(value) = &self.extended_resource_name {
    118            crate::serde::ser::SerializeStruct::serialize_field(&mut state, "extendedResourceName", value)?;
    119        }
    120        if let Some(value) = &self.selectors {
    121            crate::serde::ser::SerializeStruct::serialize_field(&mut state, "selectors", value)?;
    122        }
    123        crate::serde::ser::SerializeStruct::end(state)
    124    }
    125}
    126
    127#[cfg(feature = "schemars")]
    128impl crate::schemars::JsonSchema for DeviceClassSpec {
    129    fn schema_name() -> std::borrow::Cow<'static, str> {
    130        "io.k8s.api.resource.v1.DeviceClassSpec".into()
    131    }
    132
    133    fn json_schema(__gen: &mut crate::schemars::SchemaGenerator) -> crate::schemars::Schema {
    134        crate::schemars::json_schema!({
    135            "description": "DeviceClassSpec is used in a [DeviceClass] to define what can be allocated and how to configure it.",
    136            "type": "object",
    137            "properties": {
    138                "config": {
    139                    "description": "Config defines configuration parameters that apply to each device that is claimed via this class. Some classses may potentially be satisfied by multiple drivers, so each instance of a vendor configuration applies to exactly one driver.\n\nThey are passed to the driver, but are not considered while allocating the claim.",
    140                    "type": "array",
    141                    "items": (__gen.subschema_for::<crate::api::resource::v1::DeviceClassConfiguration>()),
    142                },
    143                "extendedResourceName": {
    144                    "description": "ExtendedResourceName is the extended resource name for the devices of this class. The devices of this class can be used to satisfy a pod's extended resource requests. It has the same format as the name of a pod's extended resource. It should be unique among all the device classes in a cluster. If two device classes have the same name, then the class created later is picked to satisfy a pod's extended resource requests. If two classes are created at the same time, then the name of the class lexicographically sorted first is picked.\n\nThis is an alpha field.",
    145                    "type": "string",
    146                },
    147                "selectors": {
    148                    "description": "Each selector must be satisfied by a device which is claimed via this class.",
    149                    "type": "array",
    150                    "items": (__gen.subschema_for::<crate::api::resource::v1::DeviceSelector>()),
    151                },
    152            },
    153        })
    154    }
    155}