printerxpl-forge 6.2.0__py3-none-any.whl

src/ui/spinner.py

@@ -0,0 +1,112 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+PrinterXPL-Forge — Terminal Spinner
+==================================
+Thread-based spinner for long-running operations.
+Works on Windows, Linux and macOS without external deps.
+"""
+# Author    : Andre Henrique (@mrhenrike)
+# GitHub    : https://github.com/mrhenrike
+# LinkedIn  : https://linkedin.com/in/mrhenrike
+# X/Twitter : https://x.com/mrhenrike
+
+from __future__ import annotations
+
+import sys
+import threading
+import time
+from contextlib import contextmanager
+from typing import Optional
+
+_CYN = '\033[1;36m'
+_GRN = '\033[1;32m'
+_YEL = '\033[1;33m'
+_RED = '\033[1;31m'
+_DIM = '\033[2;37m'
+_RST = '\033[0m'
+_CLR = '\r\033[K'   # carriage return + clear line
+
+_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏']
+_FRAMES_ASCII = ['|', '/', '-', '\\']   # fallback for terminals without unicode
+
+
+def _supports_unicode() -> bool:
+    try:
+        '⠋'.encode(sys.stdout.encoding or 'utf-8')
+        return True
+    except (UnicodeEncodeError, LookupError, AttributeError):
+        return False
+
+
+class Spinner:
+    """
+    Context-manager spinner that shows animated activity during slow operations.
+
+    Usage:
+        with Spinner("Scanning...") as sp:
+            do_slow_thing()
+            sp.update("Still scanning...")
+        # On exit: shows [DONE] or [FAIL] automatically
+    """
+
+    def __init__(self, message: str = '', color: str = _CYN,
+                 interval: float = 0.08) -> None:
+        self.message  = message
+        self.color    = color
+        self.interval = interval
+        self._stop    = threading.Event()
+        self._thread: Optional[threading.Thread] = None
+        self._frames  = _FRAMES if _supports_unicode() else _FRAMES_ASCII
+        self._done    = False
+        self._failed  = False
+
+    def _spin(self) -> None:
+        i = 0
+        while not self._stop.is_set():
+            frame = self._frames[i % len(self._frames)]
+            sys.stdout.write(
+                f'{_CLR}  {self.color}{frame}{_RST} {_DIM}{self.message}{_RST}'
+            )
+            sys.stdout.flush()
+            time.sleep(self.interval)
+            i += 1
+
+    def start(self) -> 'Spinner':
+        self._stop.clear()
+        self._thread = threading.Thread(target=self._spin, daemon=True)
+        self._thread.start()
+        return self
+
+    def update(self, message: str) -> None:
+        """Update the spinner message while running."""
+        self.message = message
+
+    def stop(self, success: bool = True, final_msg: str = '') -> None:
+        self._stop.set()
+        if self._thread:
+            self._thread.join(timeout=0.5)
+        icon  = f'{_GRN}✔{_RST}' if success else f'{_RED}✘{_RST}'
+        label = final_msg or self.message
+        sys.stdout.write(f'{_CLR}  {icon} {label}\n')
+        sys.stdout.flush()
+
+    def __enter__(self) -> 'Spinner':
+        return self.start()
+
+    def __exit__(self, exc_type, exc_val, exc_tb) -> None:
+        self.stop(success=(exc_type is None))
+        return False   # re-raise exceptions
+
+
+@contextmanager
+def spinning(message: str, color: str = _CYN, done_msg: str = ''):
+    """Convenience context manager."""
+    sp = Spinner(message, color)
+    sp.start()
+    try:
+        yield sp
+        sp.stop(True, done_msg or message)
+    except Exception:
+        sp.stop(False, f'{message} — failed')
+        raise

src/ui/tables.py

@@ -0,0 +1,132 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+PrinterXPL-Forge — Terminal Table Renderer
+========================================
+Simple, dependency-free table rendering for CLI output.
+"""
+# Author    : Andre Henrique (@mrhenrike)
+# GitHub    : https://github.com/mrhenrike
+# LinkedIn  : https://linkedin.com/in/mrhenrike
+# X/Twitter : https://x.com/mrhenrike
+
+from __future__ import annotations
+
+import shutil
+from typing import Any, List, Optional, Tuple
+
+_RST = '\033[0m'
+_DIM = '\033[2;37m'
+_BLD = '\033[1m'
+_CYN = '\033[1;36m'
+_GRN = '\033[1;32m'
+_YEL = '\033[1;33m'
+_RED = '\033[1;31m'
+
+
+def _strip_ansi(s: str) -> str:
+    """Return string length ignoring ANSI escape sequences."""
+    import re
+    return re.sub(r'\033\[[0-9;]*m', '', s)
+
+
+def _vis_len(s: str) -> int:
+    return len(_strip_ansi(s))
+
+
+def box(title: str = '', lines: List[str] = None,
+        width: Optional[int] = None, color: str = _CYN) -> str:
+    """
+    Render a bordered box with optional title and content lines.
+
+    Example:
+        ╔══════════════════════╗
+        ║  Title               ║
+        ╠══════════════════════╣
+        ║  Line 1              ║
+        ╚══════════════════════╝
+    """
+    term_w = shutil.get_terminal_size((80, 24)).columns
+    w = min(width or 66, term_w - 2)
+    inner = w - 2
+
+    top     = f"  {color}╔{'═' * inner}╗{_RST}"
+    div     = f"  {color}╠{'═' * inner}╣{_RST}"
+    bot     = f"  {color}╚{'═' * inner}╝{_RST}"
+    side    = lambda s: f"  {color}║{_RST} {s:<{inner - 1}}{color}║{_RST}"
+
+    parts = [top]
+    if title:
+        parts.append(side(f'{_BLD}{title}{_RST}'))
+        if lines:
+            parts.append(div)
+    for line in (lines or []):
+        # Handle long lines
+        visible = _strip_ansi(line)
+        if len(visible) <= inner - 1:
+            parts.append(side(line))
+        else:
+            # Truncate with ellipsis
+            parts.append(side(line[:inner - 4] + '...'))
+    parts.append(bot)
+    return '\n'.join(parts)
+
+
+def table(headers: List[str], rows: List[List[Any]],
+          col_colors: List[str] = None,
+          header_color: str = _CYN,
+          indent: str = '  ') -> str:
+    """
+    Render a simple aligned table.
+
+    Args:
+        headers:     Column header labels.
+        rows:        List of row data (each row is a list of values).
+        col_colors:  Per-column ANSI color codes.
+        header_color: Color for header row.
+    """
+    if not rows and not headers:
+        return ''
+
+    num_cols = len(headers)
+    col_widths = [_vis_len(str(h)) for h in headers]
+    for row in rows:
+        for i, cell in enumerate(row[:num_cols]):
+            col_widths[i] = max(col_widths[i], _vis_len(str(cell)))
+
+    def fmt_row(cells: List[Any], colors: List[str] = None) -> str:
+        parts = []
+        for i, cell in enumerate(cells[:num_cols]):
+            w   = col_widths[i]
+            s   = str(cell)
+            vis = _vis_len(s)
+            pad = ' ' * max(0, w - vis)
+            clr = (colors[i] if colors and i < len(colors) else '') if colors else ''
+            rst = _RST if clr else ''
+            parts.append(f"{clr}{s}{rst}{pad}")
+        return f"{indent}  " + '  '.join(parts)
+
+    sep_line = indent + '  ' + '  '.join('─' * w for w in col_widths)
+
+    lines = []
+    lines.append(fmt_row(
+        [f"{header_color}{h}{_RST}" for h in headers],
+    ))
+    lines.append(sep_line)
+    for row in rows:
+        lines.append(fmt_row(row, col_colors))
+    return '\n'.join(lines)
+
+
+def section(title: str, color: str = _CYN, width: int = 60) -> str:
+    """Render a section header line."""
+    term_w = shutil.get_terminal_size((80, 24)).columns
+    w = min(width, term_w - 4)
+    bar = '─' * w
+    return f"\n  {color}┌{'─' * 2} {title} {'─' * max(0, w - len(title) - 4)}┐{_RST}"
+
+
+def summary_line(label: str, value: str, label_color: str = _DIM,
+                 value_color: str = _RST) -> str:
+    """Render a key-value summary line."""
+    return f"  {label_color}{label:<18}{_RST} {value_color}{value}{_RST}"