config-core

Shared TOML config primitives for the curator, warden, lector and flotilla apps, which share the same window → group → tab config shape and house style.

It is not a generic config framework: each app keeps its own leaf tab type (curator: url/session; warden: dir/shell/probe; lector: dir; flotilla: url), validation, and the rules for how window and group settings pass down to each tab. config-core provides the leaf-agnostic pieces:

• model — the leaf-free config-model primitives: Density (whole-app chrome sizing), TabDigitKeys (the ⌘1/⌘2 jump-vs-cycle keybinding mode) and the non-fatal Warning. It also holds the shared serde defaults (default_true, default_window_width/_height).
• window — the [[window]] / [[window.group]] container, Window<T, X, G> and Group<T, G>: the common keys (title, width, height, colour, open_on_start, group; a group's name, tab), each app's leaf tab T, and its own window/group extras X/G (NoExtras when it has none). Any key outside the common set goes to the extras, so an unknown key is reported by name, inside the window, group and tab it sits in. validate_windows checks the shared keys (titles, sizes, colours, group names); retitle_window carries an in-place rename into a loaded config ahead of its reload.
• fmt — a house-style TOML formatter (format_str, format_file) wrapping taplo with a fixed style: nested-table indentation, aligned = and trailing comments, preserved key order, a blank line between window/group tables but none between the tab tables nested inside them. format_file rewrites atomically and only when bytes change, preserving symlinks and file mode. fmt_cli is the fmt CLI subcommand behind warden fmt, curator fmt, and lector fmt.
• colour — #rgb / #rrggbb hex parsing for the per-window accent colour (Colour::parse, Colour::hex).
• edit — leaf-agnostic structural add/remove/set/move edits of windows, groups and tabs: add_window / edit_window (title and colour), add_group, add_tab, remove, set_field and move_tab (the last three addressed by an At), plus set_key / remove_key (one root key) and toggle_tab_digit_keys. Atomic and comment-preserving via toml_edit; groups and tabs take an ordered field list for any leaf shape. An unknown window, group or tab is an error. Field values are config_core::toml_edit::Value (toml_edit is re-exported; callers need no dependency of their own on it).
• paths — config-path resolution (resolve_config_path, default_config_path). The environment variable the app names (e.g. WARDEN_CONFIG) wins when set and non-empty; otherwise the path is the default (~/.config/<app_dir>/config.toml).
• seed — a starter config, on request only. write_default_config(path, template) writes template to path atomically if nothing is there yet, and never clobbers an existing file. The caller supplies the template.
• roots — project-tree discovery for a [[window.root]] block (warden and lector): scan_root walks a dir for git repos, resolve_root_dir validates a root's {name, dir, depth}, and discover_projects flattens roots into DiscoveredProjects the app maps onto its own tab.

Use

It's consumed as a git dependency pinned to a commit rev (no tags, no crates.io releases):

[dependencies]
config-core = { git = "https://github.com/Lockyc/config-core", rev = "<commit>" }

Develop

just gate     # cargo fmt --check, clippy -D warnings, tests
cargo test    # the quick loop: unit + golden formatter tests

License

MIT © Lachlan Collins