load_config()

Load and merge the full config stack.

Usage

Source

load_config(
    *,
    project_dir=None,
    global_path=None,
)

Resolution order (last wins): 1. Built-in defaults (TalkBoxConfig() with no arguments) 2. Global config (~/.config/talk-box/config.yml) 3. Project config (./talk-box.yml, searched upward from project_dir)

Layers 4–6 (profile, env vars, CLI flags) are applied later via TalkBoxConfig.resolve().

Parameters

project_dir: Path | None = None

Directory to start searching for talk-box.yml. Defaults to cwd.

global_path: Path | None = None

Override the global config path (useful for testing).