mirror of
https://github.com/kuhyx/testsAndMisc.git
synced 2026-11-10 20:47:03 +01:00
Krzysztof kuhy Rudnicki
6383bd7452
Some checks are pending
dependency freshness / dependencies on newest stable (push) Waiting to run
md-naming / markdown naming convention (push) Waiting to run
Pre-commit checks / pre-commit (${{ matrix.group }}) (mypy, mypy) (push) Waiting to run
Pre-commit checks / pre-commit (${{ matrix.group }}) (pylint, pylint) (push) Waiting to run
Pre-commit checks / pre-commit (${{ matrix.group }}) (rest, ) (push) Waiting to run
Pre-commit checks / pre-commit (${{ matrix.group }}) (shellcheck, shellcheck) (push) Waiting to run
Python tests / test (push) Waiting to run
repo-contract / repo contract (push) Waiting to run
Shell tests / shell-tests (push) Waiting to run
Shell tests / lib-tests (push) Waiting to run
Shell tests / arch-tests (push) Waiting to run
apps.py was one entry short of the 250-line cap, so tutor and the new tunedeck entry live in _apps_more.MORE_APPS, merged into APPS unchanged. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01CyiH5e86uaQzhXzVXTQiVc
127 lines
4.1 KiB
Python
127 lines
4.1 KiB
Python
"""Per-app glyph artwork for the shared icon family.
|
|
|
|
A glyph is a raw SVG fragment drawn in the 1024x1024 master canvas. It does not
|
|
need to be perfectly positioned: :mod:`python_pkg.app_icons.render` measures the
|
|
rendered ink and recentres the fragment, so every icon in the family sits at the
|
|
same optical height.
|
|
|
|
Fragments inherit ``fill="none"``, ``stroke``, ``stroke-width`` and round caps
|
|
from the wrapping group. A fragment that needs a filled silhouette instead
|
|
overrides those locally and uses :data:`~python_pkg.app_icons.style.ACCENT_MARKER`
|
|
for its colour.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from dataclasses import dataclass
|
|
from typing import Final
|
|
|
|
from python_pkg.app_icons._glyph_art import (
|
|
_ANVIL,
|
|
_BARBELL,
|
|
_CHAIN_LINK,
|
|
_CHECKLIST,
|
|
_CLOCK,
|
|
_CLOUD_DOWN,
|
|
_DECISION_TREE,
|
|
_QUILL_NIB,
|
|
_RECEIPT_SPLIT,
|
|
_SHIELD_CUTLERY,
|
|
_STORAGE_BOX,
|
|
)
|
|
from python_pkg.app_icons._glyph_art_extra import _HEADPHONES, _LIGHTBULB
|
|
from python_pkg.app_icons._glyph_art_more import (
|
|
_BOWL_STAR,
|
|
_HOURGLASS,
|
|
_HOUSE_TICK,
|
|
_NOTE_ASCENDER,
|
|
_OPEN_BOOK,
|
|
_PADLOCK_CLOSED,
|
|
_PUNCH_CARD,
|
|
_REMOTE_WAVE,
|
|
_TRACK_BARS,
|
|
_UMBRELLA,
|
|
)
|
|
|
|
|
|
@dataclass(frozen=True)
|
|
class Glyph:
|
|
"""One app's artwork.
|
|
|
|
Parameters:
|
|
name (str): Stable identifier, used as the ``--glyph`` CLI value.
|
|
description (str): What the glyph depicts, for ``--list`` output.
|
|
body (str): SVG fragment drawn in the 1024x1024 master canvas.
|
|
"""
|
|
|
|
name: str
|
|
description: str
|
|
body: str
|
|
|
|
|
|
GLYPHS: Final[dict[str, Glyph]] = {
|
|
glyph.name: glyph
|
|
for glyph in (
|
|
Glyph("cloud-down", "Cloud with a download arrow", _CLOUD_DOWN),
|
|
Glyph("barbell", "Barbell with plates and collars", _BARBELL),
|
|
Glyph("clock", "Clock face with hands", _CLOCK),
|
|
Glyph("punch-card", "Time card with punched holes", _PUNCH_CARD),
|
|
Glyph("shield-cutlery", "Shield guarding a fork and knife", _SHIELD_CUTLERY),
|
|
Glyph("checklist", "Two ticked-off list rows", _CHECKLIST),
|
|
Glyph("chain-link", "Two interlocking chain links", _CHAIN_LINK),
|
|
Glyph("storage-box", "Isometric storage carton", _STORAGE_BOX),
|
|
Glyph("receipt-split", "Torn receipt with a perforated split", _RECEIPT_SPLIT),
|
|
Glyph("quill-nib", "Dip-pen nib with vent hole and slit", _QUILL_NIB),
|
|
Glyph("anvil", "Blacksmith's anvil with horn and flared foot", _ANVIL),
|
|
Glyph(
|
|
"note-ascender",
|
|
"Eighth note whose stem doubles as a letterform ascender on a baseline",
|
|
_NOTE_ASCENDER,
|
|
),
|
|
Glyph("track-bars", "Rising log bars with a plotted trend point", _TRACK_BARS),
|
|
Glyph(
|
|
"decision-tree",
|
|
"Node branching into two levels of child nodes",
|
|
_DECISION_TREE,
|
|
),
|
|
Glyph(
|
|
"padlock-closed",
|
|
"Closed padlock with a punched-out keyhole",
|
|
_PADLOCK_CLOSED,
|
|
),
|
|
Glyph("bowl-star", "Filled star above an open bowl", _BOWL_STAR),
|
|
Glyph("house-tick", "House outline with a tick inside", _HOUSE_TICK),
|
|
Glyph("umbrella", "Filled umbrella canopy over a J-handle", _UMBRELLA),
|
|
Glyph("open-book", "Open book, two filled pages", _OPEN_BOOK),
|
|
Glyph("hourglass", "Capped hourglass with sand still in the top", _HOURGLASS),
|
|
Glyph(
|
|
"remote-wave",
|
|
"Handset with punched buttons under a broadcast arc",
|
|
_REMOTE_WAVE,
|
|
),
|
|
Glyph("lightbulb", "Filled lightbulb over a two-bar screw base", _LIGHTBULB),
|
|
Glyph("headphones", "Headband arc over two filled ear cups", _HEADPHONES),
|
|
)
|
|
}
|
|
|
|
|
|
def get_glyph(name: str) -> Glyph:
|
|
"""Look up a glyph by name.
|
|
|
|
Parameters:
|
|
name (str): Glyph identifier, e.g. ``"barbell"``.
|
|
|
|
Returns:
|
|
Glyph: The matching glyph.
|
|
|
|
Raises:
|
|
KeyError: If no glyph with that name exists. The message lists the
|
|
available names, since this is usually a CLI typo.
|
|
"""
|
|
try:
|
|
return GLYPHS[name]
|
|
except KeyError:
|
|
available = ", ".join(sorted(GLYPHS))
|
|
msg = f"unknown glyph {name!r}; available: {available}"
|
|
raise KeyError(msg) from None
|