# This file is automatically generated by pyo3_stub_gen
# ruff: noqa: E501, F401, F403, F405

__all__ = [
    "parse_include_directive",
    "render_named",
    "resolve_path_vars",
]

def parse_include_directive(line: str) -> str | None:
    r"""
    Parse an ``@include(MacroName)`` directive.
    
    Returns the macro name (stripped of whitespace) or ``None`` if
    the line is not an include directive.
    """

def render_named(template: str, vars: dict[str, str]) -> str:
    r"""
    Resolve named substitution variables in a template string.
    
    Replaces ``{name}`` placeholders using the provided dict.
    Unknown placeholders (including path-style ``{machine.name}``)
    are left verbatim for a subsequent ``resolve_path_vars`` call.
    """

def resolve_path_vars(template: str, path_vars: dict[str, str]) -> str:
    r"""
    Resolve path-style placeholders using a flat dict.
    
    Replaces ``{machine.name}``, ``{job.extents[0]}`` etc. using
    the provided dict. Unresolved placeholders are left verbatim.
    """

