Skip to content

Configuration

Forgather configurations are YAML files preprocessed by Jinja2, parsed with custom YAML tags, and materialized into Python objects through a node graph. This section is a reference for the configuration language and the system that runs it.

For the conceptual overview (what a project is, how the pipeline works), start with Core Concepts.

Pages in this section

  • Syntax Reference — complete reference for line statements (-- extends, -- block, -- if, -- set) and YAML tags (!call, !factory, !partial, !singleton, !var).
  • Model Initialization — regex-based parameter initialization patterns.
  • Debugging — preprocessor walkthrough, common error patterns, and tools for diagnosing template-resolution issues.
  • Low-level API — the ConfigEnvironment and node-graph API the Project abstraction is built on.