Source code for foundry.pipeline

"""Generic build pipeline: config in, files out.

Runs the :class:`~foundry.engine.Engine` over the full config
tree in a single pass, then assembles the build store into files
using foundry's shared registry and generic assembler.  Reads
:attr:`~foundry.config.FoundryConfig.package_prefix` directly from
the config and does not inspect any target-specific field.
"""

from __future__ import annotations

from pathlib import Path
from typing import TYPE_CHECKING

from foundry.assembler import assemble
from foundry.engine import Engine
from foundry.env import create_jinja_env
from foundry.errors import GenerationError
from foundry.render import RenderCtx, registry

if TYPE_CHECKING:
    from foundry.config import FoundryConfig
    from foundry.spec import GeneratedFile
    from foundry.target import Target

_FOUNDRY_TEMPLATES = Path(__file__).parent / "templates"




def generate(config: FoundryConfig, target: Target) -> list[GeneratedFile]:
    """Generate all files for a validated *config*.

    :class:`~foundry.engine.Engine` auto-discovers operations from
    the ``foundry.operations`` entry-point group, runs the
    hierarchical engine once over the full config tree, and hands
    the resulting build store to foundry's generic assembler.

    Args:
        config: Validated config model.
        target: The selected target; its ``template_dir`` is used
            to build the Jinja environment passed to renderers.

    Returns:
        Flat list of generated files.

    Raises:
        GenerationError: If config semantics are invalid (e.g. a
            resource references an unknown operation, or an
            operation's options fail introspection).

    """
    env = create_jinja_env(target.template_dir, _FOUNDRY_TEMPLATES)

    try:
        engine = Engine(package_prefix=config.package_prefix)
        store = engine.build(config)

        ctx = RenderCtx(
            env=env,
            config=config,
            package_prefix=config.package_prefix,
            language=target.language,
        )

        return assemble(store, registry, ctx)

    except ValueError as exc:
        raise GenerationError(str(exc)) from exc