Authoring examples cover how users describe work before it runs: trusted YAML
composition, recipe expansion, interpolation, artifact-safe source records,
structured errors, project-owned config-arg adapters, and recursive _target_
construction.
| Example | Demonstrates |
|---|---|
config-composition.basic |
Base YAML plus overlay YAML, ordinary update/add overrides, and the resolved, unresolved, and redacted config views. |
config-composition.includes |
Local _include_ files, nested includes relative to the including file, user include replacement, brand-new include addition, and include source artifacts. |
config-composition.replacement-overlays |
Multi-overlay order and intentional mapping replacement with _replace_: true. |
config-composition.errors |
Structured config errors for missing includes, invalid include overrides, unsupported resolvers, and unsupported _copy_. |
recipes |
Trusted recipe registration, recipe expansion, overlays, ordinary overrides, interpolation, recipe manifest output, redaction, and fingerprints. |
artifact-safety |
Metadata-only source artifacts, provenance, redaction, resolver facts, artifact-safe fingerprint comparison, raw snapshot defaults, and raw snapshot opt-in. |
target-instantiation |
Explicit construction of trusted _target_ object graphs with nested targets, _args_, _partial_, and _inject_. |
project-cli-argv |
Project-owned config-arg adapter flow through compose_config_from_args and ConfigEntrypoint, including scoped overlays, passthrough args, resolver metadata, selected instantiation, migration diagnostics, and helper-local warnings. |
Run from the repository root:
uv run python examples/config-composition/basic/compose_basic.py
uv run python examples/config-composition/includes/compose_includes.py
uv run python examples/config-composition/replacement-overlays/replacement_overlays.py
uv run python examples/config-composition/errors/show_errors.py
uv run python examples/recipes/compose_config.py
uv run python examples/artifact-safety/artifact_safety.py
uv run python examples/target-instantiation/instantiate_targets.py
uv run python examples/project-cli-argv/project_cli_argv.py