dymokomi/luce-config
A small, reusable configuration reader for Luce applications.
A library written in luce. Latest release 0.5.1.
Install#
luc add dymokomi/luce-configDocumentation#
luce-config
A small, reusable configuration reader for Luce applications. It parses a scalar subset of TOML — tables, bare keys, quoted UTF-8 strings, decimal numbers and booleans — and validates a file against the settings an application declares, so a typo is a clear error rather than a silently ignored line.
It has no dependency on any UI: any Luce program that keeps user settings, a keymap, or a theme in a .toml file can read it the same way.
Model
Table(source) parses the text once. Read values with fallbacks:
from luce_config.toml import Table
let table = Table(text)
table.check_keys(["editor.font", "editor.size", "editor.wrap"])
let font = table.string("editor.font", "")
let size = table.number("editor.size", 14.0, 8.0, 40.0)
let wrap = table.boolean("editor.wrap", false)
A section can be left open-ended — a keymap binds arbitrary command names — while every other table is still checked against the schema:
table.check_within(["editor.font"], ["shortcuts"])
for name in table.keys("shortcuts"):
let chord = table.string("shortcuts." + name, "")
Reference
| Method | Purpose |
|---|---|
Table(source) | Parse configuration text, reporting malformed structure. |
check_keys(supported) | Reject unknown tables and settings against a fixed schema. |
check_within(supported, dynamic) | As above, but the dynamic sections accept any key. |
keys(section) | The bare keys present under a section. |
string / number / boolean(key, fallback, …) | Typed reads with a fallback for an absent key. |
Build and test
Keep luce-config, luce, and luce-base as sibling checkouts. The tested compiler revisions are recorded in bootstrap/. Build the compilers, then run the module's test blocks in every compiled mode:
(cd ../luce-base && ./build.sh)
(cd ../luce && LUCE_BASE_COMPILER=../luce-base/build/luce-base ./build.sh)
./test.sh
Licensed under either of Apache-2.0 or MIT at your option.
Dependencies#
| Package | Version |
|---|---|
| dymokomi/luce-std | newest |
Versions#
0.5.1
Browse source · pack · commit eb83cae0f515
SHA-256 716615019070ee81ffc26f582d7217ef33632bce3cad4f24f102fcc1d649896d
dependencies name no version