Crate sentry_options_validation 

Schema validation library for sentry-options.

Schemas are loaded once into a SchemaRegistry and shared via Arc. Values are validated against schemas as complete objects.

Refresh-on-read scheme

Values are held in a ValuesStore that wraps an ArcSwap for lock-free reads. There is no background thread — every load() decides whether the cached snapshot is stale and, if so, the calling thread refreshes it.

Each load() does:

1. Read now and last_updated (an AtomicU64 of nanoseconds since a monotonic baseline) with Acquire.
2. Compute a per-call jitter in [0, 1s) from the address of a stack local — different threads have different stack bases, so the value differs across threads. No thread_local is involved.
3. If now - last_updated < threshold + jitter, return the current snapshot. Otherwise: a. Read all values files from disk and build the new map. b. On success, publish the new map into the ArcSwap (last-writer-wins under contention). c. compare_exchange last_updated from the previously-observed value to now with AcqRel. The Release on the timestamp publishes the prior ArcSwap::store: any reader that Acquire-loads the bumped timestamp and short-circuits the refresh is guaranteed to subsequently load the new snapshot. d. On a parse/validation failure, leave the old map in place — the bumped timestamp makes other threads back off until the next window.

Multiple threads racing through the stale window will redundantly read files and publish; the last ArcSwap::store wins. The jitter spreads the threshold boundary so that the herd doesn’t cross it together. On error the timestamp is still bumped so a broken values directory does not turn into an I/O storm.

Structs

NamespaceSchema

Schema for a namespace, containing validator and option metadata

OptionMetadata

Metadata for a single option in a namespace schema

SchemaRegistry

Registry for loading and storing schemas

ValuesStore

Lazily reloads values from disk when reads detect they are stale.

Enums

ValidationError

Errors that can occur during schema and value validation

Constants

LOCAL_OPTIONS_DIR

Local fallback path for development

OPTIONS_DIR_ENV

Environment variable to override options directory

OPTIONS_SUPPRESS_MISSING_DIR_ENV

Environment variable to suppress missing directory errors

PRODUCTION_OPTIONS_DIR

Production path where options are deployed via config map

Functions

resolve_options_dir

Resolve options directory using fallback chain:

validate_k8s_name_component

Validate a name component is valid for K8s (lowercase alphanumeric, ‘-’, ‘.’)

Type Aliases

ValidationResult

Result type for validation operations

ValuesByNamespace

A map of option values keyed by their namespace