Enum Serde

pub(super) enum Serde {
    Bool(bool),
    Str(String),
    Num(u32),
    Name {
        name: String,
    },
    Raw {
        raw_name: OsString,
    },
    Special {
        special: String,
    },
    Id {
        id: u32,
    },
}

Available on target_family="unix" and non-iOS and non-Android and non-tvOS and crate feature serde only.

Helper type: when encoding or decoding a group or user, we do so as one of these.

It’s an untagged enumeration, so every case must be uniquely identifiable by type or by keywords.

Variants

Bool(bool)

A boolean value.

“false” means “no user”, and is the same as “none”.

“true” is not allowed.

Str(String)

A string given in quotes.

If this starts with “:” it will be interpreted as a special entity (e.g. “:current” or “:username”). Otherwise, it will be interpreted as a name.

Num(u32)

An integer provided without any identification.

This will be interpreted as a UID or GID.

Name

A name, explicitly qualified as such.

Fields

name: String

The name in question.

Even if this begins with “:”, it is still interpreted as a name.

Raw

A username that cannot be represented as a String.

Fields

raw_name: OsString

The username in question.

Special

A special entity.

Fields

special: String

The name of the special entity. Starts with “:”.

Id

A UID or GID, explicitly qualified as such.

Fields

id: u32

The UID or GID.

Implementations

impl Serde

fn disambiguate(self) -> Self

Convert this Serde into a less ambiguous form.

Removes all Num and Str cases from the output, replacing them with Special/Name/Id as appropriate.

Trait Implementations

impl Clone for Serde

fn clone(&self) -> Serde

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Serde

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Serde

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<TrustedGroup> for Serde

fn from(value: TrustedGroup) -> Self

Converts to this type from the input type.

impl From<TrustedUser> for Serde

fn from(value: TrustedUser) -> Self

Converts to this type from the input type.

impl Serialize for Serde

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<Serde> for TrustedGroup

type Error = Error

The type returned in the event of a conversion error.

fn try_from(ent: Serde) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Serde> for TrustedUser

type Error = Error

The type returned in the event of a conversion error.

fn try_from(ent: Serde) -> Result<Self, Self::Error>

Performs the conversion.