Enum UpdateCategory 

#[non_exhaustive]
pub enum UpdateCategory {
    Security,
    Bugfix,
    Feature,
    Unknown,
    Other(String),
}

Classification of a software update by its nature.

Plugins that can determine the update type (e.g. APT can detect security updates from the repository URL) set the category on [UpstreamRelease]. Unknown is used when the plugin cannot classify.

Wire forward-compatibility

Other(String) is a catch-all variant for category strings received from a newer peer that this binary does not yet know about. Serde deserialization is infallible: an unknown string becomes Other(...) rather than a parse error, allowing older clients to survive rolling upgrades without dropping entire messages.

FromStr remains strict for URL parameters and DB lookups where callers need to distinguish known variants from unknown ones.

Variants (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.

Security

A security patch or vulnerability fix.

Bugfix

A bug fix that does not address a security vulnerability.

Feature

A new feature or enhancement.

Unknown

The update type could not be determined.

Other(String)

An unknown category received from a newer peer.

The inner string is the raw snake_case value as it appeared on the wire.

Implementations

impl UpdateCategory

pub fn as_str(&self) -> &str

Returns the string representation.

For UpdateCategory::Other, returns the inner string as-is.

Trait Implementations

impl Clone for UpdateCategory

fn clone(&self) -> UpdateCategory

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UpdateCategory

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

Formats the value using the given formatter.

impl Default for UpdateCategory

fn default() -> UpdateCategory

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for UpdateCategory

fn deserialize<D>( deserializer: D, ) -> Result<UpdateCategory, <D as Deserializer<'de>>::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for UpdateCategory

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

Formats the value using the given formatter.

impl Eq for UpdateCategory

impl From<String> for UpdateCategory

fn from(s: String) -> UpdateCategory

Converts a snake_case string to an update category.

Unknown strings map to UpdateCategory::Other rather than failing.

impl FromStr for UpdateCategory

type Err = ParseUpdateCategoryError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<UpdateCategory, <UpdateCategory as FromStr>::Err>

Parses a string s to return a value of this type.

impl PartialEq for UpdateCategory

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for UpdateCategory

fn serialize<S>( &self, serializer: S, ) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for UpdateCategory