CharmPkk 0.4.0__py3-none-any.whl

charmpkk/__init__.py

@@ -0,0 +1,12 @@
+"""CharmPkk — красивые интерфейсы для Python: консоль и окно."""
+from .version import __version__
+from . import console
+
+__all__ = ["console", "__version__"]
+
+try:
+    from . import window  # noqa: F401
+    __all__.append("window")
+except Exception:
+    # tkinter может отсутствовать (например, headless-сервер)
+    pass

charmpkk/console/__init__.py

@@ -0,0 +1,95 @@
+from . import colors, text, boxes, layout, widgets, charts, menu
+from . import anim, particles, effects, live as _live_mod
+from . import terminal as terminal_mod
+from . import themes as console_themes
+from . import banner as banner_mod
+from . import forms as forms_mod
+from . import wizard as wizard_mod
+from . import markdown as markdown_mod
+from . import progress_ext
+from .colors import (
+    colorize, fg_rgb, bg_rgb, fg_hex, bg_hex, fg_256, bg_256,
+    gradient_text, rainbow_text, Style,
+    enable, disable, is_enabled, strip_ansi,
+    BOLD, DIM, ITALIC, UNDERLINE, BLINK, REVERSE, HIDDEN, STRIKE, RESET,
+    BLACK, RED, GREEN, YELLOW, BLUE, MAGENTA, CYAN, WHITE,
+    BRIGHT_BLACK, BRIGHT_RED, BRIGHT_GREEN, BRIGHT_YELLOW,
+    BRIGHT_BLUE, BRIGHT_MAGENTA, BRIGHT_CYAN, BRIGHT_WHITE,
+)
+from .text import wrap, align, center, pad, truncate, typewriter, indent, visible_len
+from .boxes import box, rule, section, panel, banner, STYLES
+from .layout import columns, rows, grid, sidebar
+from .widgets import (
+    ProgressBar, MultiProgress, Spinner, Table,
+    bullet_list, numbered_list, key_value, badge, statusline, tree,
+    notify, info, success, warning, error, Log,
+    ask, ask_password, ask_number, confirm, ask_choice,
+)
+from .charts import sparkline, bar_chart, gauge, histogram, heatmap
+from .menu import select, multiselect, tabs
+
+from .anim import (
+    ease, tween, lerp, lerp_color, Transition, EASINGS,
+    ease_in_quad, ease_out_quad, ease_in_out_quad,
+    ease_in_cubic, ease_out_cubic, ease_in_out_cubic,
+    ease_in_quart, ease_out_quart, ease_in_out_sine,
+    ease_in_expo, ease_out_expo,
+    ease_out_back, ease_out_elastic, ease_out_bounce,
+)
+from .particles import (
+    Canvas as ParticleCanvas, ParticleSystem,
+    Rain, Snow, Stars, Dust, Matrix, Bubbles, Fireflies,
+    play as play_particles, play_preset, PRESETS as PARTICLE_PRESETS,
+)
+from .effects import (
+    typewriter as typewriter_fx, fade_in, wave, shimmer,
+    glitch, marquee, neon,
+)
+from .live import Live, animate_to
+
+from .terminal import Terminal, terminal
+from .themes import Palette, REGISTRY as THEMES, get as get_theme, list_names as list_themes
+from .banner import big as big_text
+from .forms import Form, Field
+from .wizard import Wizard, Step
+from .markdown import render as render_markdown, print_md
+from .progress_ext import FancyProgressBar, AnimatedProgressBar, TaskList
+
+__all__ = [
+    "colors", "colorize", "fg_rgb", "bg_rgb", "fg_hex", "bg_hex", "fg_256", "bg_256",
+    "gradient_text", "rainbow_text", "Style", "enable", "disable", "is_enabled",
+    "strip_ansi",
+    "BOLD", "DIM", "ITALIC", "UNDERLINE", "BLINK", "REVERSE", "HIDDEN", "STRIKE", "RESET",
+    "BLACK", "RED", "GREEN", "YELLOW", "BLUE", "MAGENTA", "CYAN", "WHITE",
+    "BRIGHT_BLACK", "BRIGHT_RED", "BRIGHT_GREEN", "BRIGHT_YELLOW",
+    "BRIGHT_BLUE", "BRIGHT_MAGENTA", "BRIGHT_CYAN", "BRIGHT_WHITE",
+    "text", "wrap", "align", "center", "pad", "truncate", "typewriter", "indent", "visible_len",
+    "boxes", "box", "rule", "section", "panel", "banner", "STYLES",
+    "layout", "columns", "rows", "grid", "sidebar",
+    "widgets", "ProgressBar", "MultiProgress", "Spinner", "Table",
+    "bullet_list", "numbered_list", "key_value", "badge", "statusline", "tree",
+    "notify", "info", "success", "warning", "error", "Log",
+    "ask", "ask_password", "ask_number", "confirm", "ask_choice",
+    "charts", "sparkline", "bar_chart", "gauge", "histogram", "heatmap",
+    "menu", "select", "multiselect", "tabs",
+    "anim", "ease", "tween", "lerp", "lerp_color", "Transition", "EASINGS",
+    "ease_in_quad", "ease_out_quad", "ease_in_out_quad",
+    "ease_in_cubic", "ease_out_cubic", "ease_in_out_cubic",
+    "ease_in_quart", "ease_out_quart", "ease_in_out_sine",
+    "ease_in_expo", "ease_out_expo",
+    "ease_out_back", "ease_out_elastic", "ease_out_bounce",
+    "particles", "ParticleCanvas", "ParticleSystem",
+    "Rain", "Snow", "Stars", "Dust", "Matrix", "Bubbles", "Fireflies",
+    "play_particles", "play_preset", "PARTICLE_PRESETS",
+    "effects", "typewriter_fx", "fade_in", "wave", "shimmer",
+    "glitch", "marquee", "neon",
+    "Live", "animate_to",
+    # 0.4.0
+    "terminal_mod", "Terminal", "terminal",
+    "console_themes", "Palette", "THEMES", "get_theme", "list_themes",
+    "banner_mod", "big_text",
+    "forms_mod", "Form", "Field",
+    "wizard_mod", "Wizard", "Step",
+    "markdown_mod", "render_markdown", "print_md",
+    "progress_ext", "FancyProgressBar", "AnimatedProgressBar", "TaskList",
+]

charmpkk/console/anim.py

@@ -0,0 +1,120 @@
+"""Easing, tween, интерполяция — для плавных консольных анимаций."""
+import math
+
+
+# ---------- easing ----------
+
+def linear(t): return t
+def ease_in_quad(t): return t * t
+def ease_out_quad(t): return 1 - (1 - t) ** 2
+def ease_in_out_quad(t): return 2 * t * t if t < 0.5 else 1 - (-2 * t + 2) ** 2 / 2
+def ease_in_cubic(t): return t ** 3
+def ease_out_cubic(t): return 1 - (1 - t) ** 3
+def ease_in_out_cubic(t): return 4 * t ** 3 if t < 0.5 else 1 - (-2 * t + 2) ** 3 / 2
+def ease_in_quart(t): return t ** 4
+def ease_out_quart(t): return 1 - (1 - t) ** 4
+def ease_in_out_sine(t): return -(math.cos(math.pi * t) - 1) / 2
+def ease_in_expo(t): return 0 if t == 0 else 2 ** (10 * t - 10)
+def ease_out_expo(t): return 1 if t == 1 else 1 - 2 ** (-10 * t)
+
+
+def ease_out_back(t):
+    c1, c3 = 1.70158, 2.70158
+    return 1 + c3 * (t - 1) ** 3 + c1 * (t - 1) ** 2
+
+
+def ease_out_elastic(t):
+    if t in (0.0, 1.0):
+        return t
+    c4 = (2 * math.pi) / 3
+    return 2 ** (-10 * t) * math.sin((t * 10 - 0.75) * c4) + 1
+
+
+def ease_out_bounce(t):
+    n1, d1 = 7.5625, 2.75
+    if t < 1 / d1:
+        return n1 * t * t
+    if t < 2 / d1:
+        t -= 1.5 / d1
+        return n1 * t * t + 0.75
+    if t < 2.5 / d1:
+        t -= 2.25 / d1
+        return n1 * t * t + 0.9375
+    t -= 2.625 / d1
+    return n1 * t * t + 0.984375
+
+
+EASINGS = {
+    "linear": linear,
+    "in_quad": ease_in_quad, "out_quad": ease_out_quad, "in_out_quad": ease_in_out_quad,
+    "in_cubic": ease_in_cubic, "out_cubic": ease_out_cubic, "in_out_cubic": ease_in_out_cubic,
+    "in_quart": ease_in_quart, "out_quart": ease_out_quart,
+    "in_out_sine": ease_in_out_sine,
+    "in_expo": ease_in_expo, "out_expo": ease_out_expo,
+    "out_back": ease_out_back, "out_elastic": ease_out_elastic, "out_bounce": ease_out_bounce,
+}
+
+
+def ease(t, kind="out_cubic"):
+    return EASINGS.get(kind, ease_out_cubic)(max(0.0, min(1.0, t)))
+
+
+def tween(duration=1.0, fps=30, kind="out_cubic"):
+    """Генератор значений 0..1 (с плавным easing)."""
+    n = max(int(duration * fps), 1)
+    for i in range(n + 1):
+        yield ease(i / n, kind)
+
+
+def lerp(a, b, t):
+    return a + (b - a) * t
+
+
+def _hex_to_rgb(h):
+    h = h.lstrip("#")
+    if len(h) == 3:
+        h = "".join(c * 2 for c in h)
+    return tuple(int(h[i:i + 2], 16) for i in (0, 2, 4))
+
+
+def _rgb_to_hex(rgb):
+    return "#{:02x}{:02x}{:02x}".format(*(max(0, min(255, int(c))) for c in rgb))
+
+
+def lerp_color(c1, c2, t):
+    """c1, c2 — hex-строки, возвращает hex."""
+    a, b = _hex_to_rgb(c1), _hex_to_rgb(c2)
+    return _rgb_to_hex((a[i] + (b[i] - a[i]) * t for i in range(3)))
+
+
+class Transition:
+    """Плавно переводит число из текущего значения в целевое."""
+
+    def __init__(self, value=0.0, kind="out_cubic"):
+        self.value = value
+        self.target = value
+        self.start = value
+        self.kind = kind
+        self._t = 0.0
+        self._duration = 0.0
+
+    def to(self, target, duration=0.5, kind=None):
+        self.start = self.value
+        self.target = target
+        self._duration = max(duration, 1e-6)
+        self._t = 0.0
+        if kind:
+            self.kind = kind
+        return self
+
+    def step(self, dt):
+        if self._duration <= 0:
+            self.value = self.target
+            return self.value
+        self._t = min(self._t + dt / self._duration, 1.0)
+        self.value = lerp(self.start, self.target, ease(self._t, self.kind))
+        return self.value
+
+    @property
+    def done(self):
+        return self._t >= 1.0

charmpkk/console/banner.py

@@ -0,0 +1,80 @@
+"""Большие ASCII-заголовки (минимальный FIGlet-подобный рендер)."""
+from .colors import colorize, gradient_text
+
+# 5-строчные глифы (только заглавные + цифры + базовые знаки).
+_FONT = {
+    "A": ["  ▄▀█  ", " █▀█  ", " ▀ ▀  "],
+    "B": [" █▀▄  ", " █▀▄  ", " ▀▀   "],
+    "C": [" █▀▀  ", " █    ", " ▀▀▀  "],
+    "D": [" █▀▄  ", " █ █  ", " ▀▀   "],
+    "E": [" █▀▀  ", " █▀   ", " ▀▀▀  "],
+    "F": [" █▀▀  ", " █▀   ", " ▀    "],
+    "G": [" █▀▀  ", " █ █  ", " ▀▀▀  "],
+    "H": [" █ █  ", " █▀█  ", " ▀ ▀  "],
+    "I": [" █  ", " █  ", " ▀  "],
+    "J": ["   █  ", "   █  ", " ▀▀   "],
+    "K": [" █ █  ", " █▀▄  ", " ▀ ▀  "],
+    "L": [" █    ", " █    ", " ▀▀▀  "],
+    "M": [" █▀▄▀█  ", " █ ▀ █  ", " ▀   ▀  "],
+    "N": [" █▄ █  ", " █ ▀█  ", " ▀  ▀  "],
+    "O": [" █▀█  ", " █ █  ", " ▀▀▀  "],
+    "P": [" █▀█  ", " █▀▀  ", " ▀    "],
+    "Q": [" █▀█  ", " █ █  ", " ▀▀▀▄ "],
+    "R": [" █▀▄  ", " █▀▄  ", " ▀ ▀  "],
+    "S": [" █▀▀  ", " ▀▀█  ", " ▀▀▀  "],
+    "T": [" █▀█  ", "  █   ", "  ▀   "],
+    "U": [" █ █  ", " █ █  ", " ▀▀▀  "],
+    "V": [" █ █  ", " █ █  ", "  ▀   "],
+    "W": [" █ █ █  ", " █ █ █  ", "  ▀ ▀   "],
+    "X": [" █ █  ", "  █   ", " ▀ ▀  "],
+    "Y": [" █ █  ", "  █   ", "  ▀   "],
+    "Z": [" ▀▀█  ", " ▄▀   ", " ▀▀▀  "],
+    "0": [" █▀█  ", " █ █  ", " ▀▀▀  "],
+    "1": [" ▄█  ", "  █  ", " ▀▀▀ "],
+    "2": [" █▀█  ", " ▄▀   ", " ▀▀▀  "],
+    "3": [" ▀▀█  ", " ▀▀█  ", " ▀▀▀  "],
+    "4": [" █ █  ", " ▀▀█  ", "   ▀  "],
+    "5": [" █▀▀  ", " ▀▀▄  ", " ▀▀▀  "],
+    "6": [" █▀▀  ", " █▀▄  ", " ▀▀▀  "],
+    "7": [" ▀▀█  ", "   █  ", "   ▀  "],
+    "8": [" █▀█  ", " █▀█  ", " ▀▀▀  "],
+    "9": [" █▀█  ", " ▀▀█  ", " ▀▀▀  "],
+    " ": ["     ", "     ", "     "],
+    "!": [" █  ", " █  ", " ▀  "],
+    "?": [" █▀█  ", "  ▄▀  ", "  ▀   "],
+    ".": ["    ", "    ", " ▀  "],
+    ",": ["    ", "    ", " ▀  "],
+    "-": ["      ", " ▀▀▀  ", "      "],
+    "_": ["      ", "      ", " ▀▀▀  "],
+    ":": ["    ", " ▀  ", " ▀  "],
+}
+
+_TEMPLATES = {
+    "block": ["▄▀█", "█▀█", "▀ ▀"],   # не используется напрямую, но идея та же
+}
+
+
+def _render(text):
+    text = text.upper()
+    lines = ["", "", ""]
+    for ch in text:
+        glyph = _FONT.get(ch, _FONT["?"])
+        w = max(len(g) for g in glyph)
+        for i, g in enumerate(glyph):
+            lines[i] += g.ljust(w) + " "
+    return [l.rstrip() for l in lines]
+
+
+def big(text, fg=None, gradient=None, align="left", width=None):
+    """Крупный заголовок. Если передан gradient=(start_hex, end_hex) —
+    каждая строка окрашивается градиентом."""
+    lines = _render(text)
+    if width:
+        from .text import align as _a
+        lines = [_a(l, width, align) for l in lines]
+    if gradient:
+        return "\n".join(gradient_text(l, gradient[0], gradient[1])
+                         for l in lines)
+    if fg:
+        return "\n".join(colorize(l, fg=fg) for l in lines)
+    return "\n".join(lines)

charmpkk/console/boxes.py

@@ -0,0 +1,116 @@
+"""Рамки, панели, секции, баннеры."""
+from .colors import colorize
+from .text import align, wrap, visible_len
+
+STYLES = {
+    "single": ("┌", "─", "┐", "│", "└", "┘"),
+    "double": ("╔", "═", "╗", "║", "╚", "╝"),
+    "round":  ("╭", "─", "╮", "│", "╰", "╯"),
+    "heavy":  ("┏", "━", "┓", "┃", "┗", "┛"),
+    "dashed": ("┌", "╌", "┐", "╎", "└", "┘"),
+    "dotted": ("┌", "┄", "┐", "┆", "└", "┘"),
+    "ascii":  ("+", "-", "+", "|", "+", "+"),
+    "none":   ("", "", "", "", "", ""),
+    "shadow": ("┌", "─", "┐", "│", "└", "┘"),
+}
+
+
+def box(content, title=None, style="round", padding=1, width=None,
+        border_fg=None, bg=None, align_mode="left",
+        title_align="left", subtitle=None) -> str:
+    """Рамка вокруг текста. content — строка или список строк."""
+    if isinstance(content, str):
+        lines = content.split("\n")
+    else:
+        lines = [str(x) for x in content]
+
+    if width:
+        content_w = max(width - 2 - padding * 2, 1)
+        new_lines = []
+        for line in lines:
+            new_lines.extend(wrap(line, content_w))
+        lines = new_lines
+
+    inner = max((visible_len(l) for l in lines), default=0)
+    if title:
+        inner = max(inner, visible_len(title) + 2)
+    if subtitle:
+        inner = max(inner, visible_len(subtitle) + 2)
+    inner += padding * 2
+
+    tl, h, tr, v, bl, br = STYLES.get(style, STYLES["round"])
+    pad = " " * padding
+
+    if style == "none":
+        return "\n".join(pad + align(l, inner - padding * 2, align_mode) + pad
+                         for l in lines)
+
+    if title:
+        t = f" {title} "
+        if title_align == "center":
+            side = max((inner - visible_len(t)) // 2, 0)
+            top = tl + h * side + t + h * max(inner - side - visible_len(t), 0) + tr
+        elif title_align == "right":
+            top = tl + h * max(inner - visible_len(t), 0) + t + tr
+        else:
+            top = tl + h + t + h * max(inner - visible_len(t) - 1, 0) + tr
+    else:
+        top = tl + h * inner + tr
+
+    out = [top]
+    for line in lines:
+        content_aligned = align(line, inner - padding * 2, align_mode)
+        out.append(v + pad + content_aligned + pad + v)
+
+    if subtitle:
+        s = f" {subtitle} "
+        bot = bl + h * max(inner - visible_len(s), 0) + s + br
+    else:
+        bot = bl + h * inner + br
+    out.append(bot)
+
+    if border_fg:
+        out = [colorize(x, fg=border_fg, bg=bg) for x in out]
+    elif bg:
+        out = [colorize(x, bg=bg) for x in out]
+    return "\n".join(out)
+
+
+def rule(width=60, char="─", fg=None, title=None, title_align="center",
+         bg=None) -> str:
+    """Горизонтальный разделитель."""
+    if title:
+        t = f" {title} "
+        tw = visible_len(t)
+        if title_align == "left":
+            line = char * 2 + t + char * max(width - tw - 2, 0)
+        elif title_align == "right":
+            line = char * max(width - tw - 2, 0) + t + char * 2
+        else:
+            side = max((width - tw) // 2, 0)
+            line = char * side + t + char * max(width - side - tw, 0)
+    else:
+        line = char * width
+    return colorize(line, fg=fg, bg=bg)
+
+
+def section(title, width=60, style="round", fg=None, bg=None) -> str:
+    """Заголовок секции."""
+    return rule(width=width, title=title, fg=fg, bg=bg, title_align="left")
+
+
+def panel(title, content, style="round", border_fg=None, bg=None,
+          width=None, padding=1) -> str:
+    """Панель с заголовком."""
+    return box(content, title=title, style=style, border_fg=border_fg,
+               bg=bg, width=width, padding=padding)
+
+
+def banner(text, subtitle=None, style="double", fg=None, bg=None,
+           width=None) -> str:
+    """Крупный центрированный заголовок."""
+    lines = [text]
+    if subtitle:
+        lines.append(subtitle)
+    return box(lines, style=style, border_fg=fg, bg=bg, padding=2,
+               width=width, align_mode="center")

charmpkk/console/charts.py

@@ -0,0 +1,95 @@
+"""Простые ASCII-графики."""
+from .colors import colorize
+
+
+def sparkline(values, chars="▁▂▃▄▅▆▇█", fg=None):
+    if not values:
+        return ""
+    lo, hi = min(values), max(values)
+    rng = (hi - lo) or 1
+    out = []
+    for v in values:
+        i = int((v - lo) / rng * (len(chars) - 1))
+        ch = chars[i]
+        out.append(colorize(ch, fg=fg) if fg else ch)
+    return "".join(out)
+
+
+def bar_chart(data, width=40, char="█", fg=None, show_values=True,
+              value_fmt="{:.0f}"):
+    items = list(data.items()) if isinstance(data, dict) else list(data)
+    if not items:
+        return ""
+    maxv = max(v for _, v in items) or 1
+    max_label = max(len(str(k)) for k, _ in items)
+    lines = []
+    for label, value in items:
+        n = int(value / maxv * width)
+        bar = char * n
+        if fg:
+            bar = colorize(bar, fg=fg)
+        lbl = str(label).ljust(max_label)
+        suffix = f" {value_fmt.format(value)}" if show_values else ""
+        lines.append(f"{lbl} │ {bar}{suffix}")
+    return "\n".join(lines)
+
+
+def gauge(value, total=100, width=30, fg=None, bg=None, label=""):
+    ratio = max(0, min(value / (total or 1), 1))
+    n = int(ratio * width)
+    filled = "█" * n
+    empty = "░" * (width - n)
+    if fg:
+        filled = colorize(filled, fg=fg)
+    if bg:
+        empty = colorize(empty, fg=bg)
+    pre = f"{label} " if label else ""
+    return f"{pre}[{filled}{empty}] {ratio * 100:5.1f}%"
+
+
+def histogram(values, bins=10, width=40, char="█", fg=None,
+              show_labels=True):
+    if not values:
+        return ""
+    lo, hi = min(values), max(values)
+    if hi == lo:
+        hi = lo + 1
+    step = (hi - lo) / bins
+    counts = [0] * bins
+    for v in values:
+        i = min(int((v - lo) / step), bins - 1)
+        counts[i] += 1
+    maxc = max(counts) or 1
+    lines = []
+    for i, c in enumerate(counts):
+        n = int(c / maxc * width)
+        bar = char * n
+        if fg:
+            bar = colorize(bar, fg=fg)
+        if show_labels:
+            lbl = f"{lo + i * step:>7.2f}"
+            lines.append(f"{lbl} │ {bar} {c}")
+        else:
+            lines.append(bar)
+    return "\n".join(lines)
+
+
+def heatmap(values, rows, cols, char_ramp=" ░▒▓█", fg=None):
+    """Простая heatmap из 2D-списка (по строкам)."""
+    if not values:
+        return ""
+    flat = [v for row in values for v in row]
+    lo, hi = min(flat), max(flat)
+    rng = (hi - lo) or 1
+    n = len(char_ramp) - 1
+    out = []
+    for r in range(rows):
+        row = values[r] if r < len(values) else []
+        line = []
+        for c in range(cols):
+            v = row[c] if c < len(row) else lo
+            i = int((v - lo) / rng * n)
+            ch = char_ramp[i]
+            line.append(colorize(ch, fg=fg) if fg else ch)
+        out.append("".join(line))
+    return "\n".join(out)