Improvements to Utilities

AnonymouX47 commented 9 months ago

Moves utility definitions into ._utils and exports only public ones from .utils.
Query results are now cached globally, not locally.
- Adds ._utils.query_cache
- Adds @._utils.cached_query
Query results are now cached only when queries are enabled.
Removes defunct (and unlikely to be used) utilities.
Tidies up active terminal derivation.
- Adds NoActiveTerminalWarning, get_active_terminal().
- NoActiveTerminalWarning is now issued instead of the more generic TermImageUserWarning, when there's no active terminal.
- The active terminal is no longer determined at package load time.
Tidies up multi-process TTY access and cell size synchronization.
- Adds TTYSyncProcess, NoMultiProcessSyncWarning.
Improves cell size computations
- Adds CellSize.
- Introduces fractional cell dimensions.
- get_cell_size() no longer uses CSI 16 t to avoid premature rounding.
- get_cell_size() now returns CellSize instead of .geometry.Size.
Tidies up terminal name & version derivation.
- Adds NameVersion.
- get_terminal_name_version() now returns NameVersion instead of a mere tuple.
Tidies up terminal FG & BG color derivation.
- Adds .utils.get_fg_bg_colors() (to the public API).
- get_fg_bg_colors() now returns Color instead of tuple | str.
- Removes typing overloads.

github-actions[bot] commented 6 months ago

Coverage report

Click to see where and how coverage changed