Jean-Pierre MartineauandClaude Fable 5.1
c9f5a71ce7
Apache-2.0 does not require per-file headers, but a file lifted out of the tree carried no marking at all. One comment line, first (or right after a shebang), on every .py under meshterm/, tests/, packaging/ and scripts/, plus the extensionless SPI bridge; tests/test_spdx.py keeps a new file from landing without one. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
63 lines
3.5 KiB
Python
63 lines
3.5 KiB
Python
# SPDX-License-Identifier: Apache-2.0
|
||
"""The PicoCalc console font's codepoint inventory — the glyph contract.
|
||
|
||
The PicoCalc panel draws through the kernel console with one 512-glyph PSF font
|
||
(``meshterm.psf.gz``, built by ``scripts/calculinux-console-font.sh``): the stock
|
||
Terminus 6×12 base (a Cyrillic-coverage table — note there are **no accented Latin
|
||
letters**), the full braille block, MeshTerm's own marks drawn into donor slots, and a
|
||
few aliases. A character outside this set renders as a blank on the panel, so *nothing
|
||
outside it may ever be emitted* on the picocalc platform — the render boundary folds
|
||
text down to it (:func:`meshterm.ui.theme.fold_text`), and the dual-platform gallery
|
||
asserts the fold held.
|
||
|
||
This table is the **single source of truth** for that contract, shared by the runtime
|
||
fold and the tests. It mirrors the font actually installed on the device: the base
|
||
inventory was dumped live from the PSF's Unicode table (2026-08-01), minus the donor
|
||
codepoints the build script now repurposes, plus the marks it draws in their place.
|
||
If the build script's ``MARKS``/``DONORS``/``ALIASES`` change, this table must move in
|
||
the same commit — and vice versa.
|
||
"""
|
||
|
||
from __future__ import annotations
|
||
|
||
#: Inclusive ``(first, last)`` codepoint ranges present in the font. 519 codepoints over
|
||
#: 512 glyphs — aliases (the rounded corners onto the square ones, ``⋯`` onto ``…``) and
|
||
#: shared slots give a few glyphs more than one codepoint. Verified against a live table
|
||
#: dump of the installed font (2026-08-01, post-P3 build).
|
||
# fmt: off
|
||
FONT_RANGES: tuple[tuple[int, int], ...] = (
|
||
(0x0020, 0x007F), (0x00A0, 0x00A0), (0x00A7, 0x00A7), (0x00A9, 0x00A9),
|
||
(0x00B0, 0x00B0), (0x00B2, 0x00B2), (0x00B6, 0x00B7), (0x03C0, 0x03C0),
|
||
(0x0401, 0x0401),
|
||
(0x0404, 0x0404), (0x0406, 0x0407), (0x0410, 0x044F), (0x0451, 0x0451),
|
||
(0x0454, 0x0454), (0x0456, 0x0457), (0x0490, 0x0491), (0x2014, 0x2014),
|
||
(0x2022, 0x2022), (0x2026, 0x2026), (0x2190, 0x2195), (0x21A8, 0x21A8),
|
||
(0x21BB, 0x21BB), (0x21E7, 0x21E7), (0x221A, 0x221A), (0x221F, 0x221F),
|
||
(0x2248, 0x2248), (0x2264, 0x2265), (0x22EF, 0x22EF), (0x2302, 0x2302),
|
||
(0x2316, 0x2316), (0x232B, 0x232B), (0x2500, 0x2500), (0x2502, 0x2502),
|
||
(0x250C, 0x250C), (0x2510, 0x2510), (0x2514, 0x2514), (0x2518, 0x2518),
|
||
(0x251C, 0x251C), (0x2524, 0x2524), (0x252C, 0x252C), (0x2534, 0x2534),
|
||
(0x253C, 0x253C), (0x2550, 0x2551), (0x2554, 0x2554), (0x2557, 0x2557),
|
||
(0x2559, 0x255B),
|
||
(0x255D, 0x2561), (0x2563, 0x2563), (0x2566, 0x256A), (0x256C, 0x2570),
|
||
(0x2580, 0x2580), (0x2584, 0x2584), (0x2588, 0x2588), (0x258C, 0x258C),
|
||
(0x2590, 0x2593), (0x25A0, 0x25A0), (0x25AC, 0x25AC), (0x25B2, 0x25B2),
|
||
(0x25B6, 0x25B6), (0x25B8, 0x25B8), (0x25BA, 0x25BA), (0x25BC, 0x25BC),
|
||
(0x25C0, 0x25C0), (0x25C4, 0x25C4), (0x25C9, 0x25C9), (0x25CB, 0x25CB),
|
||
(0x25CF, 0x25CF), (0x25F7, 0x25F7), (0x2605, 0x2605), (0x263C, 0x263C),
|
||
(0x2699, 0x2699), (0x26A0, 0x26A0), (0x26BF, 0x26BF), (0x2713, 0x2713),
|
||
(0x2717, 0x2717), (0x276F, 0x276F), (0x2800, 0x28FF), (0xFFFD, 0xFFFD),
|
||
)
|
||
# fmt: on
|
||
|
||
#: Every codepoint the console font can draw, as one frozen set (built once at import;
|
||
#: 520 members, so the set is small and the per-character membership test is a dict hit).
|
||
FONT_CODEPOINTS: frozenset[int] = frozenset(
|
||
cp for first, last in FONT_RANGES for cp in range(first, last + 1)
|
||
)
|
||
|
||
|
||
def in_font(char: str) -> bool:
|
||
"""Whether the console font has a glyph for ``char``."""
|
||
return ord(char) in FONT_CODEPOINTS
|