Struct Config 

pub struct Config {
    pub line: Option<LineConfig>,
    pub theme: Option<String>,
    pub layout: LayoutMode,
    pub layout_options: Option<LayoutOptions>,
    pub segments: BTreeMap<String, SegmentOverride>,
    pub plugin_dirs: Vec<PathBuf>,
    pub preset: Option<String>,
    pub plugins: Option<BTreeMap<String, Value>>,
    pub schema_url: Option<String>,
}

Parsed config.toml. Serde ignores unknown keys so a file from a newer linesmith still parses on an older binary; fields this version doesn’t know are dropped rather than rejected. The schema-side additionalProperties: false tightens editor validation so typos like thme = "default" get flagged at the authoring layer; the runtime stays permissive (the unknown-key warning channel lives in from_str_validated).

Fields

line: Option<LineConfig>

theme: Option<String>

layout: LayoutMode

Top-level layout mode. Defaults to LayoutMode::SingleLine when the field is omitted, preserving pre-multi-line config behavior. LayoutMode::MultiLine triggers per-[line.N] rendering.

layout_options: Option<LayoutOptions>

segments: BTreeMap<String, SegmentOverride>

plugin_dirs: Vec<PathBuf>

Extra directories to scan for user plugin scripts (.rhai files). Scanned in list order before the default XDG directory. See docs/specs/config.md §Plugin directories and docs/specs/plugin-api.md §Plugin file location.

preset: Option<String>

Spec-listed forward-compat key. Parsed and runtime-ignored; surfacing it in the schema so editor tooling doesn’t flag user configs that include it. Allow-listed in KNOWN_TOP_LEVEL to suppress the unknown-key warning.

plugins: Option<BTreeMap<String, Value>>

Forward-compat [plugins.*] table. Typed as a string-keyed map so a non-table value (plugins = "oops") fails parse at load-time instead of silently dropping; per-plugin sub-table shape is open until the plugin-config spec lands. Schema mirror remaps toml::Value to serde_json::Value for the same reason as extra / numbered: toml::Value has no JsonSchema impl.

schema_url: Option<String>

Editor-tooling $schema directive. Some users put it as a top-level TOML key instead of (or alongside) the #:schema comment directive linesmith init writes. Must be quoted in TOML ("$schema" = "...") — $ is not legal in bare keys. Parsed and ignored at runtime; surfaced here so the schema validates configs using the alternate form.

Implementations

impl Config

pub fn load(path: &Path) -> Result<Option<Self>, ConfigError>

Read and parse the file at path. Returns Ok(None) when the file doesn’t exist (normal case for first-run users); other I/O errors propagate so callers can log them. Unknown keys are silently ignored — callers that want typo warnings use Config::load_validated instead.

pub fn load_validated( path: &Path, warn: impl FnMut(&str), ) -> Result<Option<Self>, ConfigError>

Same as Config::load but emits one warning per unknown key encountered (top-level, [layout_options], or [segments.<id>]). The allow-list tolerates every spec-documented key (see KNOWN_TOP_LEVEL and KNOWN_LAYOUT_OPTIONS), so forward-compat configs stay silent while typos surface.

pub fn from_str_validated( s: &str, warn: impl FnMut(&str), ) -> Result<Self, ConfigError>

FromStr-equivalent with unknown-key warnings. The plain FromStr impl remains the non-validating form; validation is opt-in so callers that don’t want the allow-list surface (unit tests, programmatic config construction) bypass it.

Trait Implementations

impl Clone for Config

fn clone(&self) -> Config

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Config

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

Formats the value using the given formatter.

impl Default for Config

fn default() -> Config

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Config

where Config: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl FromStr for Config

type Err = ConfigError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl JsonSchema for Config

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl PartialEq for Config

fn eq(&self, other: &Config) -> 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 StructuralPartialEq for Config