Enum PreferenceValue 

#[non_exhaustive]
pub enum PreferenceValue {
    #[non_exhaustive]
    Timezone {
        value: String,
    },
    #[non_exhaustive]
    DateGrain {
        grain: DateGrain,
    },
    #[non_exhaustive]
    OutputStyle {
        style: OutputStyle,
    },
    #[non_exhaustive]
    DefaultProfile {
        name: String,
    },
}

A bounded user preference. Closed enums and shape-validated strings only; no free-text variant exists by design.

Deserialize is hand-rolled, not derived: the string-carrying variants run their shape validators on deserialization too, so a {"kind":"timezone", "value":"SELECT ..."} row is refused by the type, not only by the store’s admission gate. A derived Deserialize would populate the field directly and bypass the constructors — exactly the “validated constructor beside a publicly-constructible variant” the security standard warns about, and the spec’s “make it unrepresentable, not filtered” rule.

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.

#[non_exhaustive]

Timezone

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

value: String

#[non_exhaustive]

DateGrain

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

grain: DateGrain

#[non_exhaustive]

OutputStyle

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

style: OutputStyle

#[non_exhaustive]

DefaultProfile

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

name: String

Implementations

impl PreferenceValue

pub fn kind(&self) -> &'static str

The stable discriminator persisted as preference_kind, and used as part of the store’s primary key.

pub fn required_scope(&self) -> ScopeRequirement

The scope this value must be stored under. A value set at the wrong scope is a typed error, never a silent coercion.

pub fn matches_scope(&self, scope: &PreferenceScope) -> bool

True if scope is the one this value requires. Convenience over required_scope().matches(scope).

pub fn timezone(value: impl AsRef<str>) -> Result<Self, ContractError>

Construct a timezone preference. Validation is shape only: non-empty, ≤64 chars, ASCII alphanumeric plus /, _, + and -. A wrong-but- well-shaped timezone is a user error they can see and fix; bundling an IANA list to validate membership would be a maintenance burden that goes stale. A fictional-but-well-shaped name is accepted on purpose.

pub fn date_grain(grain: DateGrain) -> Self

pub fn output_style(style: OutputStyle) -> Self

pub fn default_profile(name: impl AsRef<str>) -> Result<Self, ContractError>

Construct a default-profile preference from a profile name. The name is validated by the same shape rules as a database object name: non-empty, bounded, no control characters. A name is not an identity — it never reaches the database bytes as p-…, and it is resolved against the live connections.toml at use time, not stored as a pointer to a profile.

pub fn timezone_value(&self) -> Option<&str>

The persisted string for a Timezone value, or None for other kinds. Used only by tests that assert a round-tripped value byte-for-byte.

pub fn default_profile_name(&self) -> Option<&str>

The persisted name for a DefaultProfile value, or None for other kinds.

Trait Implementations

impl Clone for PreferenceValue

fn clone(&self) -> PreferenceValue

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PreferenceValue

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PreferenceValue

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for PreferenceValue

impl PartialEq for PreferenceValue

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for PreferenceValue

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 PreferenceValue