Enum Audience 

pub enum Audience {
    Single(String),
    Multiple(Vec<String>),
}

The aud (audience) claim, per RFC 7519 §4.1.3: either a single case-sensitive string, or a JSON array of such strings.

#[serde(untagged)] tries variants in declaration order on deserialization, so a bare JSON string matches Audience::Single first, and only a JSON array falls through to Audience::Multiple. Serialization is not affected by declaration order — each variant serializes as its own shape — so a token minted with a single audience still serializes as a bare string, not a one-element array, matching every token this crate has ever issued.

Variants

Single(String)

Multiple(Vec<String>)

Implementations

impl Audience

pub fn contains(&self, value: &str) -> bool

True if value is present in this audience, whichever shape it was deserialized from. This is the “matches ANY” membership test that replaces exact-string-equality comparisons against aud.

Trait Implementations

impl Clone for Audience

fn clone(&self) -> Audience

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Audience

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Audience

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Audience

Renders the audience for logging and display: a single audience as the bare string, multiple as comma-separated values.

This exists so that code reading an aud claim has an ergonomic path back to a string. Without it, every format!("{}", claims.aud) and tracing::info!(aud = %claims.aud) at a call site that previously held a String is a hard compile error with no one-line replacement. Use Audience::contains for membership tests — do not parse this output back apart, since an audience value may itself contain a comma.

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

Formats the value using the given formatter.

impl Eq for Audience

impl From<&str> for Audience

fn from(value: &str) -> Self

Converts to this type from the input type.

impl From<String> for Audience

fn from(value: String) -> Self

Converts to this type from the input type.

impl PartialEq for Audience

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

Equality operator ==.

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

Inequality operator !=.

impl PartialEq<&str> for Audience

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

Equality operator ==.

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

Inequality operator !=.

impl PartialEq<String> for Audience

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

Equality operator ==.

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

Inequality operator !=.

impl PartialEq<str> for Audience

Compares against a single audience string, so claims.aud == "client" keeps compiling where aud used to be a String. Note this is exact equality against a single-valued audience, not membership — a Audience::Multiple never equals a bare str, even one it contains. Use Audience::contains when you mean “is this one of the audiences”.

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Audience

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Audience