Skip to content

lang_tools.llm._common

Helpers shared by the per-chain factories.

Each build_*_chain factory loads a versioned Jinja template from base_prompt_fol / <prompt_name> / vN.jinja via llm-core's PromptLoader and wires it into a StructuredLLMChain. default_prompts_fol returns the in-package prompt directory (used when callers omit the explicit folder).

Functions:

default_prompts_fol 

default_prompts_fol() -> Path

Return the in-package prompts/ directory.

The folder ships alongside the source tree so that the chains work without requiring callers to copy templates into their own project.

Source code in src/lang_tools/llm/_common.py 
19
20
21
22
23
24
25
def default_prompts_fol() -> Path:
    """Return the in-package ``prompts/`` directory.

    The folder ships alongside the source tree so that the chains work without
    requiring callers to copy templates into their own project.
    """
    return Path(lang_tools.__file__).parent / "prompts"

load_prompt 

load_prompt(
    prompt_name: str,
    *,
    base_prompt_fol: Path | None = None,
    version: str = "auto",
) -> str

Load a versioned Jinja prompt by name.

Parameters:

  • prompt_name (str) –

    Subfolder name under base_prompt_fol.

  • base_prompt_fol (Path | None, default: None ) –

    Root prompts folder; defaults to default_prompts_fol().

  • version (str, default: 'auto' ) –

    Explicit version ("1") or "auto" for the highest.

Returns:

  • str –

    The template string.

Source code in src/lang_tools/llm/_common.py 
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
def load_prompt(
    prompt_name: str,
    *,
    base_prompt_fol: Path | None = None,
    version: str = "auto",
) -> str:
    """Load a versioned Jinja prompt by name.

    Args:
        prompt_name: Subfolder name under `base_prompt_fol`.
        base_prompt_fol: Root prompts folder; defaults to `default_prompts_fol()`.
        version: Explicit version (``"1"``) or ``"auto"`` for the highest.

    Returns:
        The template string.
    """
    base_fol = base_prompt_fol if base_prompt_fol is not None else default_prompts_fol()
    config = PromptLoaderConfig(
        base_prompt_fol=base_fol,
        prompt_name=prompt_name,
        version=version,
    )
    return PromptLoader(config).load_prompt()