mirror of
https://github.com/kuhyx/testsAndMisc.git
synced 2026-11-10 22:47:02 +01:00
Krzysztof kuhy Rudnicki
f70af95b61
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 (push) Waiting to run
Python tests / test (push) Waiting to run
Shell tests / shell-tests (push) Waiting to run
Shell tests / arch-tests (push) Waiting to run
A new app at ~/restaurant-rater rates restaurant dishes, so it needs a family icon. shield-cutlery is diet-guard's and the accent is shared fleet-wide, so the new glyph has to be distinguished by silhouette alone: a filled star above an open bowl -- a dish, and a verdict on it. The star is filled rather than stroked for the same reason as the nib and the anvil: at 72px weight its five interior notches close up well above MIN_NEGATIVE_SPACE and it renders as a pentagon at 48dp. The bowl went through two passes. The first used shallow walls stopping at y=736 and read unmistakably as a smiling mouth with the star for a nose -- two curves with a shape above them is a face unless the vessel is clearly deeper than it is wide at the base. The committed version drops to y=752 between narrower walls, which reads as a bowl. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012YDbT3ip2yeT18W3KCZdLq
113 lines
3.5 KiB
Python
113 lines
3.5 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_more import (
|
|
_BOWL_STAR,
|
|
_NOTE_ASCENDER,
|
|
_PADLOCK_CLOSED,
|
|
_PUNCH_CARD,
|
|
_TRACK_BARS,
|
|
)
|
|
|
|
|
|
@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
|
|
|
|
|
|
# A cloud silhouette outline with a download arrow underneath: a client that
|
|
# pulls files off a remote dufs server.
|
|
|
|
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),
|
|
)
|
|
}
|
|
|
|
|
|
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
|