fontlabapp.proof.tabs.named · declarations 001
Back to fontlabapp.proof.tabs.named
RowItem
module-attribute
RowItem
open_layer_rows
open_layer_rows(rows: tuple[tuple[RowItem, ...], ...], *, expected_id: int, master: str, deadline: float | None = None) -> None
Open exact glyph/layer occurrences in rows, in ONE verified fresh native tab.
What: each row is a tuple of items. An item is (glyph name, exact
layer name), or SPACE ((None, "")) for one space. Rows are
separated by one line break; an empty row keeps its line, as in
open_named_tab. Use it for stacked or side-by-side layer
comparisons (Master Text Comparison).
How: the complete immutable request is validated first. Then every
requested layer must exist in the font expected_id (flPackage.id,
the current font). Only then are native symbols built: a layer item is an
fgSymbol with its own layerName; a space is the text symbol list
fgSymbolList(" ") and a line break fgSymbolList("\n"), the same
text form that open_named_tab uses for line breaks. The tab opens
through the shared fresh-tab fence (_open_symbols). master fences
the current source master; it does not overwrite the layer of an item.
Why: scripts must not build fgSymbol lists or call requestContent
themselves. Any failure before the tab opens opens no tab. Native
qualification (space text symbol, layer per symbol) remains open.
open_layer_tab
open_layer_tab(layers: tuple[tuple[str, str], ...], *, expected_id: int, master: str, deadline: float | None = None) -> None
Open exact glyph/layer occurrences in a verified fresh native tab.
Every pair is (glyph name, exact foreground layer name). Preserve auxiliary layers, mixed masters and repeated winners without Unicode/slash substitution. Validate the complete immutable request before native symbol allocation. The separate master argument fences the current source context; it does not overwrite each symbol's requested layer. Native qualification remains open.
open_named_tab
open_named_tab(lines: tuple[tuple[str, ...], ...], *, expected_id: int, master: str, deadline: float | None = None) -> None
Open a fresh empty native tab, verify its identity/font, then set names.
Keep the captured current master explicitly in every symbol layerName. No Unicode lookup, slash parsing, missing-name filtering or master switch. Any build failure opens no tab. Creation/populate failure can leave a new tab; no atomic UI rollback is claimed. Shared App preflight preserves captured activation flags and checks source-font identity.