Files
MeshTerm/tests/test_widgets.py
T
Jean-Pierre MartineauandClaude Opus 5 366719771f Chat: a sender label is a name inscribed in a chip
A name standing alone above its messages was a coloured word with nothing
to say it was a label — at a glance it read like something someone typed.
It now sits on a field: the node's own hue as ink on the neutral dark grey
pathline already fills our ★ chip with, closed at both ends by the rounded
caps a path line closes on, or by half blocks where the font has none.

Only the group header. An @mention inside a body is part of what was said,
and framing it would put a chip in the middle of a sentence.

The widget is ui/widgets.name_chip — the ink arrives as whatever style the
caller would have drawn the name in and is *added* to the fill as a Style,
because Rich silently drops "node.unknown on #3f3f46" and renders the name
bare. The console has no field to offer (its one dark grey is slot 8 and
backgrounds stop at 7), so the name draws unframed there, bound on
truecolor like the heat gradient. The specimen card grows a chips row so
both dresses are visible on the acceptance screen.

And the unknown sender takes node.unknown rather than muted: one hex apart
here, a whole slot apart on the console, and an unidentified sender is
content you can still act on, not chrome.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-12 17:46:10 -04:00

232 lines
10 KiB
Python

"""Shared-widget helper tests: the canonical formatting primitives every screen leans on.
Most widgets are exercised through their host screens' tests; what lives here are the
pure text helpers whose exact output *is* the app-wide convention — get these right once
and every caller inherits it.
"""
from __future__ import annotations
from meshterm.platforms import PICOCALC, REGULAR, set_platform
from meshterm.ui.widgets import (
_format_age,
format_ago,
name_chip,
path_text,
revisit_note,
)
def test_format_age_is_the_bare_column_form() -> None:
"""The lane form stays suffix-free at every magnitude, for aligned age columns."""
assert _format_age(None) == "never"
assert _format_age(5) == "now"
assert _format_age(90) == "1m"
assert _format_age(7200) == "2h"
assert _format_age(180000) == "2d"
assert _format_age(1300000) == "2w"
def test_format_ago_speaks_grammatical_prose() -> None:
"""The prose form says "5m ago" but bare "now"/"never" — never "now ago"."""
assert format_ago(5) == "now"
assert format_ago(None) == "never"
assert format_ago(90) == "1m ago"
assert format_ago(7200) == "2h ago"
def _resolve(hop: str) -> str:
return {"aa": "Alice", "3d": "YUL"}.get(hop, hop)
def test_path_text_names_hops_and_keeps_hashes_bare() -> None:
"""Named hops read as their name alone; unnamed ones as their bare hash."""
text = path_text(["aa", "77", "3d"], _resolve)
assert text.plain == "Alice → 77 → YUL" # no parenthesized hash after a name
def test_path_text_marks_us_white_and_names_in_their_hue() -> None:
"""Our own node takes the white ``you`` style; other names their palette hue."""
text = path_text(["aa", "3d"], _resolve, self_name="Alice")
styles = {text.plain[s.start : s.end]: str(s.style) for s in text.spans}
assert styles.get("Alice") == "you"
assert "YUL" in styles and styles["YUL"] != "you"
def test_path_text_empty_reads_as_direct() -> None:
"""No hops (or only empty tokens) renders the caller's empty word, muted."""
assert path_text([], _resolve).plain == "direct"
assert path_text(["", ""], _resolve).plain == "direct"
assert path_text([], _resolve, empty="direct — no relays").plain == "direct — no relays"
def test_path_text_greys_an_unnamed_hop_whole() -> None:
"""An unresolvable hop is an unknown node: its hash reads ``node.unknown`` whole,
the prefix never lit — colour marks an identified node, as in the path graph."""
from meshterm.ui.theme import node_style
text = path_text(["77bb"], _resolve, prefix_bytes=1)
styles = {text.plain[s.start : s.end]: str(s.style) for s in text.spans}
assert styles.get("77bb") == "node.unknown"
assert not any(str(s.style) == node_style("77bb") for s in text.spans)
def test_path_text_hash_as_name_shows_grey_identity_hash() -> None:
"""An unnamed hop stands in its own hash at the mode width, muted, plus its byte."""
text = path_text(
["e839f2ab"], _resolve, prefix_bytes=3,
show_hash=True, hash_bytes=1, hash_as_name=True,
)
assert text.plain == "e839f2 (e8)" # mode width identity, then the addressed byte
styles = {text.plain[s.start : s.end]: str(s.style) for s in text.spans}
assert styles.get("e839f2") == "node.unknown" # grey — colour is the "this is a name" cue
from meshterm.ui.theme import node_style
assert not any(str(s.style) == node_style("e839f2ab") for s in text.spans) # no prefix lit
def test_path_text_hash_as_name_drops_the_byte_when_it_is_the_whole_hash() -> None:
"""When the mode width is one byte, the identity already is the byte — no ``(e8)``."""
text = path_text(
["e839f2ab"], _resolve, prefix_bytes=1,
show_hash=True, hash_bytes=1, hash_as_name=True,
)
assert text.plain == "e8"
def test_path_text_trace_flavour_annotates_hashes_and_brackets_us() -> None:
"""show_hash appends the addressed hash to names; None hops are our device."""
text = path_text(
[None, "aa", "77bb", None], _resolve, self_name="Homestead",
show_hash=True, hash_bytes=1, device_hash="c0ffee",
)
assert text.plain == "Homestead (c0) → Alice (aa) → 77 → Homestead (c0)"
def test_path_text_dims_the_tail_from_dim_from() -> None:
"""The mirrored return leg (and the arrows into it) render faint."""
text = path_text(
[None, "aa", "3d", "aa", None], _resolve, self_name="us",
show_hash=True, dim_from=3,
)
styles = [(text.plain[s.start : s.end], str(s.style)) for s in text.spans]
assert ("us", "you") in styles # the departure keeps the white you
assert ("us", "faint") in styles # the landing back on us is faint
assert any(run.startswith("Alice") and style == "faint" for run, style in styles)
assert any(run.startswith("YUL") and style != "faint" for run, style in styles)
# --- the name→key resolver and the keyless-stays-muted rule --------------------------
def test_make_name_key_resolver_contacts_win_over_stored_names() -> None:
"""Contacts resolve first; stored advert names fill in strangers; misses are None."""
from meshterm.core.models import Contact
from meshterm.services.trace_runner import make_name_key_resolver
contacts = [Contact(name="Alice", public_key="d4" + "0" * 62)]
stored = {"60aabbccdd11": "Bob", "77ee00112233": "Alice"} # a stale stored Alice
key_of = make_name_key_resolver(contacts, stored)
assert key_of("Alice") == "d4" + "0" * 62 # the contact's key, not the stored id
assert key_of("alice") == "d4" + "0" * 62 # casefolded
assert key_of("Bob") == "60aabbccdd11" # a stored-name stranger still lands
assert key_of("Zed") is None # nobody carries the name
def test_name_style_without_a_key_is_the_unknown_grey() -> None:
"""A keyless name has no hue — colour is reserved for keyed identities."""
from meshterm.ui.theme import name_style, node_style
assert name_style("Stranger") == "node.unknown"
keyed = name_style("Alice", "d4" + "0" * 62)
assert keyed == node_style("d4" + "0" * 62) and keyed.startswith("bold #")
def test_name_rgb_keyless_lands_on_the_muted_grey() -> None:
"""The raster twin: a keyless name's RGB is the muted grey, never a crash."""
from meshterm.ui.widgets import name_rgb
assert name_rgb("Stranger") == (148, 163, 184)
assert name_rgb("Alice", "d4" + "0" * 62) != (148, 163, 184)
def test_route_graph_source_label_takes_its_resolved_keys_hue() -> None:
"""The graph's left endpoint hue rides key_of: resolved → the key's hue, else muted."""
from meshterm.ui.widgets import name_rgb, route_graph_style
_, _, rgb_known = route_graph_style(
resolve=lambda h: h, self_name="us", source="Alice",
key_of=lambda name: "d4" + "0" * 62 if name == "Alice" else None,
)
from meshterm.ui.pathgraph import SRC_NODE
assert rgb_known(SRC_NODE) == name_rgb("Alice", "d4" + "0" * 62)
_, _, rgb_unknown = route_graph_style(
resolve=lambda h: h, self_name="us", source="Alice",
)
assert rgb_unknown(SRC_NODE) == (148, 163, 184) # unresolvable origin stays muted
def test_revisit_note_names_the_repeats_and_refuses_to_guess_why() -> None:
"""The one line a graph drawing a node twice owes its reader — both readings, neither picked."""
note = revisit_note(["aa"], _resolve)
assert note is not None
assert note.plain == "⚠ Alice repeats — a loop, or two nodes sharing one hash"
styles = {note.plain[s.start : s.end]: str(s.style) for s in note.spans}
assert styles.get("⚠ ") == "warn" # the app's warn mark, themed
assert styles.get("Alice") not in (None, "warn") # the name keeps its own node hue
def test_revisit_note_lists_every_repeated_hop() -> None:
"""More than one hop repeated names them all, comma-joined, still one sentence."""
note = revisit_note(["aa", "3d"], _resolve)
assert note is not None
assert note.plain.startswith("⚠ Alice, YUL repeats — ")
assert len(note.plain) <= 72 # the footer/row budget every surface renders it inside
def test_revisit_note_is_absent_when_nothing_repeats() -> None:
"""No repeats, no line — the warning is evidence, never chrome."""
assert revisit_note([], _resolve) is None
assert revisit_note(()) is None
def test_name_chip_frames_the_name_without_recolouring_it() -> None:
"""The chip adds a field; the hue it fields is exactly the one it was handed."""
chip = name_chip("Alice", "bold #ff00aa")
assert chip.plain[1:-1] == "Alice" # a cap either side, the name untouched between
styles = {chip.plain[s.start : s.end]: s.style for s in chip.spans}
assert styles["Alice"].color.name == "#ff00aa" # its own hue, still
assert styles["Alice"].bgcolor is not None # now with something under it
# The caps are the fill drawn over the page — foreground only, so the half-cell that
# isn't chip keeps whatever the row behind it is.
for cap in (chip.plain[0], chip.plain[-1]):
assert styles[cap].bgcolor is None
assert styles[cap].color == styles["Alice"].bgcolor
def test_name_chip_takes_a_theme_name_as_readily_as_a_hex() -> None:
"""``node.unknown``/``you`` arrive as theme names — the fill must not flatten them.
Rich drops a style string that mixes a theme name with anything else, so a chip built
by concatenation renders the name unstyled. This is that regression, pinned.
"""
chip = name_chip("·", "node.unknown")
style = next(s.style for s in chip.spans if chip.plain[s.start : s.end] == "·")
assert style.color is not None and style.bgcolor is not None
assert style.color.name != style.bgcolor.name # not the invisible-on-itself case
def test_name_chip_draws_bare_where_the_console_has_no_field_for_it() -> None:
"""PicoCalc's greys stop at slot 7 as backgrounds — so the name goes unframed there."""
set_platform(PICOCALC)
try:
chip = name_chip("Alice", "bold #ff00aa")
finally:
set_platform(REGULAR)
assert chip.plain == "Alice" # no caps, no field — and no tofu on the console font