Enum ValueKind 

pub enum ValueKind {
    Bool,
    Unsigned,
    Float,
    Tz,
    Url,
    Path,
    Text,
    LogDirective,
    OneOf(&'static [&'static str]),
}

Domain a setting value must belong to.

Deliberately coarse. The point is to reject what can never work, not to re-derive every consumer’s parsing: a u64 reader still clamps its own range, and this only guarantees it receives digits at all.

Variants

Bool

A boolean in any spelling the readers accept.

Deliberately wider than true|false. The readers are not uniform — tracing_init.rs takes 1|true|yes|on, lib.rs the same four, retry.rs only three — and the --low-memory help has always advertised config set ingest.low_memory 1. Validating against the narrowest spelling would reject a value the product documents and every reader honours, which is a regression dressed as a check.

The job here is to reject what NO reader accepts (talvez, maybe), not to impose a house style on values that already work.

Unsigned

A non-negative integer.

Float

A finite decimal number.

Tz

An IANA timezone name, e.g. America/Sao_Paulo.

Url

An absolute http/https URL.

Path

A filesystem path. Only emptiness is rejected: existence is the caller’s business, and a path that does not exist yet is legitimate.

Text

Free text with no checkable domain.

LogDirective

A tracing filter directive, e.g. warn or sqlite_graphrag=debug.

Not a closed set: the grammar accepts per-target directives, so listing the five level names would reject legitimate values. Validated by parsing with the same type tracing_init builds, because EnvFilter::new DISCARDS an unparseable directive instead of failing — which is how log.level NIVEL_X used to silence logging outright while config set reported success.

OneOf(&'static [&'static str])

One of a closed set of spellings.

Implementations

impl ValueKind

pub fn expectation(&self) -> Option<String>

Returns a LOCALIZED description of the accepted domain, for the error message.

Returns None when every string is acceptable, which is the signal to skip validation entirely rather than to accept with an empty reason.

Localized rather than hard-coded English because the message that carries it is translated, and half-translating a sentence is worse than not translating it: the operator reads Portuguese prose that ends in an English clause.

A closed set is NOT translated — those are literal spellings the operator must type, so true|false is the same string in every locale.

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

true when value belongs to this domain.

Trait Implementations

impl Clone for ValueKind

fn clone(&self) -> ValueKind

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ValueKind

impl Debug for ValueKind

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

Formats the value using the given formatter.

impl Eq for ValueKind

impl PartialEq for ValueKind

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ValueKind