Skip to content

v0.2

Latest
Latest

Choose a tag to compare

View all tags
@Cavanshirpro Cavanshirpro released this 22 Aug 13:33
v0.2
5e24773

YoungLion Terminal Releases

v0.2.0 — YoungLion v0.1 Integration & Terminal Expansion

YoungLion Terminal v0.2 is the first release designed directly around the new YoungLion v0.1 core API. The goal is not only compatibility: v0.2 turns the package from a small ANSI helper collection into a more complete lightweight terminal toolkit while preserving the existing v0.1 public behavior wherever possible.

Compatibility with YoungLion v0.1

  • The package now requires Python 3.10+, matching YoungLion v0.1.
  • The dependency is explicitly constrained to YoungLion>=0.1.0,<0.2.0 so incompatible future core changes are not silently accepted.
  • Removed the obsolete from YoungLion.DataModel import enable_ansi dependency.
  • ANSI support is now owned by YoungLion.terminal.ansi, including a best-effort Windows Virtual Terminal mode implementation.
  • Package metadata, CI and documentation now describe the actual YoungLion v0.1 compatibility line.

Logger / Debugger integration

YoungLion.terminal.Logger remains the same Terminal Logger concept and keeps its original methods:

  • debug()
  • info()
  • success()
  • warning()
  • error()
  • critical()
  • exception()
  • set_level()
  • color/file/stream configuration

The class is now also a real subclass of both YoungLion.Debugger and YoungLion.Logger.

This makes the following valid:

from YoungLion import Debugger, File, Logger as CoreLogger
from YoungLion.terminal import Logger

logger = Logger()
assert isinstance(logger, Debugger)
assert isinstance(logger, CoreLogger)

file = File(debug=True, debugger=logger)

Core method names do not replace the Terminal Logger implementation. They route back into it as aliases/wrappers:

  • log_debug() -> debug()
  • log_info() -> info()
  • log_warning() -> warning()
  • log_error() -> error()
  • log_critical() -> critical()
  • set_log_level() -> Terminal set_level()
  • Debugger custom() routes through the Terminal Logger output pipeline instead of using a second independent printer.

The original Terminal set_level(str) behavior is preserved exactly. Because YoungLion.Debugger.set_level(int) uses the same method name for a different purpose, Debugger indentation is exposed through set_debugger_level(int) instead of changing Terminal Logger semantics.

Structured context is available through Logger.bind(...), and core log_* aliases can accept keyword fields while preserving Terminal output/file handling.

ANSI system improvements

New terminal capability tools:

  • enable_ansi() — self-contained Windows VT compatibility shim.
  • supports_ansi() — detects TTY, NO_COLOR, FORCE_COLOR, TERM=dumb and Windows VT support.
  • strip_ansi() — removes ANSI CSI/OSC sequences.
  • TerminalCapabilities / detect_capabilities() — terminal dimensions and broad rendering capability information.
  • hidden_cursor() — safe cursor hide/show context manager.
  • alternate_buffer() — safe alternate-screen context manager.
  • hyperlink() — OSC-8 terminal hyperlinks.

Color.extended_256() and true-color helpers now validate channel ranges instead of emitting invalid ANSI sequences.

Progress system improvements

LoaderBar keeps its old arithmetic/comparison interface and gains:

  • ratio
  • remaining
  • completed
  • set()
  • advance()
  • reset()
  • complete()
  • float(bar) percentage conversion

TerminalLoader gains:

  • configurable output stream;
  • thread-safe writes;
  • advance() alias;
  • subtraction support;
  • context-manager support;
  • TerminalLoader.track(...) for automatic iterable progress;
  • ANSI stripping for redirected/non-TTY output.

Existing setStyle, upgrade, finish and setClearFinish behavior is retained.

Spinner improvements

Spinner is still usable exactly as before:

with Spinner("Working"):
    do_work()

v0.2 adds:

  • explicit start() / stop() lifecycle;
  • succeed() and fail() completion states;
  • custom frame sequences;
  • configurable output stream;
  • thread-safe output;
  • daemon worker thread;
  • validation for invalid delays/empty frame sets.

New terminal widgets

v0.2 adds a small dependency-free widget layer:

Table

  • Unicode bordered tables;
  • automatic column sizing;
  • headers and styled borders;
  • optional cell truncation;
  • sequence, mapping and YoungLion.DDM rows.

Panel

  • titled bordered content blocks;
  • configurable padding and styles;
  • string rendering or direct printing.

LiveLine

  • thread-safe single-line updates;
  • automatic overwrite padding;
  • context-manager support;
  • clear/finish lifecycle.

Targeted DDM support

DDM support was deliberately not added everywhere.

It is included only in APIs where structured models naturally become terminal presentation data:

  • print_dict(DDM(...))
  • Table(..., rows=[DDM(...)])

The ANSI engine, progress engine, spinner and logger do not require DDM for normal operation. This keeps the terminal package conceptually clean and prevents unnecessary coupling.

Quality and packaging

  • Added py.typed marker for inline type information.
  • Added pytest coverage for ANSI behavior, progress behavior, Logger inheritance/aliases, File debugger compatibility, widgets and DDM rendering.
  • CI now targets Python 3.10, 3.11, 3.12, 3.13 and 3.14.
  • CI installs the package with development extras and performs tests, Ruff checks, package build and Twine validation.
  • README was rewritten to remove duplicated/obsolete v0.1 text and document the real v0.2 API.
  • Every library class, function, property and class method now has detailed runtime docstrings.
  • Every callable parameter is documented and type-annotated so IDLE/IDE signature help can explain arguments while users write code.
  • Added tests/test_docstrings.py, which fails CI when a source callable is missing a docstring, parameter description or type annotation.

Migration from v0.1

Most existing code can remain unchanged.

Old:

from YoungLion.terminal import Logger, LoaderBar, TerminalLoader, Spinner

Still valid in v0.2.

The primary environment change is Python/YoungLion compatibility:

python -m pip install --upgrade "YoungLion>=0.1,<0.2" "YoungLion-terminal>=0.2,<0.3"

If application code previously imported enable_ansi from YoungLion.DataModel, use:

from YoungLion.terminal import enable_ansi

instead.

v0.1

Initial YoungLion Terminal release with ANSI constants, cursor/screen controls, loader/progress primitives, spinner, styled printing helpers and colored logging.

Assets 4
Loading