tai/research/tui-framework-design/pytermgui-file-loaders.md

pytermgui file_loaders reference — YAML/JSON style files

Metadata

Field	Value
Institute	Molodetz Institute — Research & Retrieval Division
Subject	tui-framework-design
Document type	Source Dossier
Tier	1
Source title	pytermgui file_loaders reference — config, markup, and widget files
Source URL	https://ptg.bczsalba.com/reference/pytermgui/file_loaders/
Source publisher / author	bczsalba (pytermgui project)
Source type	vendor docs
Source date (published)	Unknown — not stated
Date researched	2026-10-11
Researched by	tai (agent), model: Muse Spark, on behalf of retoor
Research method	direct page fetch
Confidence	Medium
Status	Active

Summary

A thin source with one finding: pytermgui loads YAML/JSON config, markup, and widget files through its file_loaders module, runnable via ptg -f. It exists here as the file-based-override precedent tai explicitly defers.

Key findings

• YAML/JSON files define config, markup styles, and widget trees, loaded via the file_loaders module and runnable with ptg -f.

Pros / strengths

• Shows file-based style overrides composing with a palette system with no registry changes.

Cons / limitations / caveats

• Thin source: the merge semantics between file styles and the active palette were not part of the inspected evidence.

Relevance to tai

• Precedent behind the palette-role conclusion's deferred file-override design (a partial role dict from TOML/JSON merged over a named theme, if ever added).

Changelog

Date	Change
2026-10-11	Initial dossier created from 2026-10-11 research-pass evidence (body opened via web_fetch by researching agent).