Struct KeyFilter 

#[non_exhaustive]
pub struct KeyFilter<'a> {
    pub op: Option<KeyOperation>,
    pub alg: Option<Algorithm>,
    pub kid: Option<&'a str>,
    pub kty: Option<KeyType>,
    pub key_use: Option<KeyUse>,
}

Discovery filter criteria.

Construction

This type is #[non_exhaustive]. External callers must use KeyFilter::new plus builder methods, or convenience constructors such as KeyFilter::for_alg. Struct-literal syntax will not compile outside this crate.

Public fields remain readable for inspection/pattern-matching, but builder methods are the only supported external construction path.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

op: Option<KeyOperation>

Optional operation-intent filter.

alg: Option<Algorithm>

Optional algorithm filter (exact alg match only).

kid: Option<&'a str>

Optional key identifier filter.

kty: Option<KeyType>

Optional key-type filter.

key_use: Option<KeyUse>

Optional key-use filter.

Implementations

impl<'a> KeyFilter<'a>

pub fn new() -> Self

Creates an empty discovery filter.

pub fn for_alg(alg: Algorithm) -> Self

Creates a filter for an exact algorithm match.

pub fn for_use(key_use: KeyUse) -> Self

Creates a filter for a specific key use.

pub fn for_kty(kty: KeyType) -> Self

Creates a filter for a specific key type.

pub fn for_op(op: KeyOperation) -> Self

Creates a filter for a specific operation intent.

pub fn for_use_alg(key_use: KeyUse, alg: Algorithm) -> Self

Creates a filter for key use + exact algorithm.

pub fn for_op_alg(op: KeyOperation, alg: Algorithm) -> Self

Creates a filter for operation intent + exact algorithm.

pub fn with_op(self, op: KeyOperation) -> Self

Sets an operation filter.

pub fn with_alg(self, alg: Algorithm) -> Self

Sets an exact algorithm filter.

pub fn with_kid(self, kid: &'a str) -> Self

Sets a key identifier (kid) filter.

pub fn with_kty(self, kty: KeyType) -> Self

Sets a key type filter.

pub fn with_key_use(self, key_use: KeyUse) -> Self

Sets a key use filter.

Trait Implementations

impl<'a> Clone for KeyFilter<'a>

fn clone(&self) -> KeyFilter<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for KeyFilter<'a>

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

Formats the value using the given formatter.

impl<'a> Default for KeyFilter<'a>

fn default() -> KeyFilter<'a>

Returns the “default value” for a type.