Struct ProviderName 

pub struct ProviderName(/* private fields */);

URL-facing identifier of a registered OAuth2/OIDC provider.

Wraps a &'static str that is either a compile-time literal (named providers, preset defaults) or a Box::leak-ed value produced from an operator-supplied env var at LazyLock init (custom slots). The value has been validated for shape via is_valid_custom_provider_name (see validate_custom_slots) before any ProviderName constructed from env input reaches callers.

The newtype is not a parser — it does not re-validate its input at construction. It exists so function signatures can carry “provider-identifier” as a distinct type from other &str parameters (display name, client secret, etc.), letting the compiler catch accidental argument swaps. Construction paths stay pub(crate) so the invariant holds at the crate boundary.

Implementations

impl ProviderName

pub const fn as_str(&self) -> &'static str

Borrow the underlying &'static str.

pub fn from_registered(s: &str) -> Option<Self>

Resolve a runtime string (URL path segment, DB-stored value) against the currently-enabled provider registry. Returns Some(ProviderName) only when the string matches an enabled provider’s name, so the ProviderName invariant is preserved — callers can treat the result as “validated, registered identifier” without further checks.

Returns None when the string is empty, does not match any enabled provider, or matches a named provider whose optional env vars are not configured.

Trait Implementations

impl AsRef<str> for ProviderName

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for ProviderName

fn clone(&self) -> ProviderName

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProviderName

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

Formats the value using the given formatter.

impl Display for ProviderName

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

Formats the value using the given formatter.

impl Hash for ProviderName

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ProviderName

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for ProviderName

impl Eq for ProviderName

impl StructuralPartialEq for ProviderName