skit-cli 0.0.1__py3-none-any.whl

skit/tui_health.py

@@ -0,0 +1,150 @@
+"""Health check (D): the checklist that can also act.
+
+Every ⚠ row is selectable — Enter jumps the Library to that script; R rebuilds the
+index in place. Checks only what existing capabilities can actually verify (uv, the
+registry↔meta correspondence, missing targets, the one deliberate whole-library drift
+sweep, mirror state). Nothing invented.
+"""
+
+from __future__ import annotations
+
+from typing import override
+
+from rich.markup import escape
+from textual import on
+from textual.app import ComposeResult
+from textual.binding import Binding
+from textual.containers import VerticalScroll
+from textual.screen import Screen
+from textual.widgets import OptionList, Static
+from textual.widgets.option_list import Option
+
+from . import config, flows, launcher, store, tui_footer
+from .i18n import gettext, ngettext
+from .paths import scripts_dir
+
+
+class HealthScreen(Screen[str | None]):
+    """Dismisses with a slug to select in the Library, or None."""
+
+    BINDINGS = [
+        Binding("escape", "close", gettext("Back")),
+        Binding("R", "rebuild", gettext("Rebuild index")),
+    ]
+    DEFAULT_CSS = """
+    HealthScreen #hc-body {
+        padding: 0 1;
+        border: round $skit-box-green;
+        border-title-color: ansi_bright_white;
+        border-title-style: bold;
+    }
+    HealthScreen #hc-issues { height: auto; border: none; }
+    HealthScreen .ok { color: $success; }
+    HealthScreen .warn { color: $warning; }
+    HealthScreen .bad { color: $error; }
+    HealthScreen .hint { color: $text-muted; }
+    HealthScreen #hc-keys { dock: bottom; height: 1; color: $text-muted; padding: 0 1; }
+    """
+
+    def on_mount(self) -> None:
+        self.query_one("#hc-body").border_title = gettext("Health check")
+
+    @override
+    def compose(self) -> ComposeResult:
+        with VerticalScroll(id="hc-body"):
+            uv = launcher.find_uv()
+            if uv:
+                yield Static(f"✓ {gettext('uv: %(path)s') % {'path': escape(uv)}}", classes="ok")
+            else:
+                yield Static(
+                    f"✗ {gettext('uv: not found. Install it from https://docs.astral.sh/uv/getting-started/installation/')}",
+                    classes="bad",
+                )
+            entries = store.list_entries()
+            yield Static(
+                "✓ "
+                + ngettext(
+                    "%(count)s script registered", "%(count)s scripts registered", len(entries)
+                )
+                % {"count": len(entries)},
+                classes="ok",
+            )
+            issues: list[Option] = [
+                Option(
+                    f"⚠ {escape(e.meta.name)} — " + gettext("the launch target is gone from disk"),
+                    id=e.slug,
+                )
+                for e in entries
+                if launcher.target_missing(e)
+            ]
+            for e in entries:
+                if e.meta.kind != "python" or not e.script_path.exists():
+                    continue
+                if flows.plan_for_entry(e).drift_lines:
+                    issues.append(
+                        Option(
+                            f"⚠ {escape(e.meta.name)} — "
+                            + gettext(
+                                "form definitions are out of sync (open Script settings → Resync)"
+                            ),
+                            id=e.slug,
+                        )
+                    )
+            if issues:
+                yield Static(gettext("Issues (Enter jumps to the script):"), classes="warn")
+                yield OptionList(*issues, id="hc-issues")
+            mirror = config.load_mirror()
+            if mirror.enabled:
+                yield Static(
+                    "✓ " + gettext("Mirror: on (%(pypi)s)") % {"pypi": escape(mirror.pypi)},
+                    classes="ok",
+                )
+            else:
+                yield Static("✓ " + gettext("Mirror: off"), classes="ok")
+            location = scripts_dir()
+            yield Static(
+                gettext("Library: %(path)s (%(count)s · %(size)s)")
+                % {
+                    "path": escape(str(location)),
+                    "count": len(entries),
+                    "size": store.human_size(store.dir_size(location)),
+                },
+                classes="hint",
+            )
+            yield Static("", id="hc-rebuilt", classes="ok")
+        yield Static(
+            tui_footer.bar(
+                tui_footer.chip("screen.jump", "Enter", gettext("Jump to script")),
+                tui_footer.chip("screen.rebuild", "R", gettext("Rebuild index")),
+                tui_footer.chip("screen.close", "Esc", gettext("Back")),
+            ),
+            id="hc-keys",
+            markup=True,
+        )
+
+    @on(OptionList.OptionSelected, "#hc-issues")
+    def _jump(self, event: OptionList.OptionSelected) -> None:
+        self.dismiss(str(event.option.id))
+
+    def action_jump(self) -> None:
+        """Footer/Enter twin of clicking an issue line: dismiss to the highlighted
+        script. A no-op when the store is healthy (there is no issue list to jump into)."""
+        issues = self.query("#hc-issues")
+        if not issues:
+            return
+        option_list = issues.first(OptionList)
+        if option_list.highlighted is not None:
+            self.dismiss(str(option_list.get_option_at_index(option_list.highlighted).id))
+
+    def action_rebuild(self) -> None:
+        count, problems = store.doctor_rebuild()
+        report = self.query_one("#hc-rebuilt", Static)
+        lines = [
+            ngettext("Index rebuilt: %(count)s entry", "Index rebuilt: %(count)s entries", count)
+            % {"count": count}
+        ]
+        lines += [escape(p) for p in problems]
+        report.update("\n".join(lines))
+
+    def action_close(self) -> None:
+        self.dismiss(None)

skit/tui_prefs.py

@@ -0,0 +1,175 @@
+"""Preferences (,): skit's global settings, one screen, everything visible.
+
+Every setting shows what is ACTUALLY in effect right now (the most common question a
+settings screen gets is "what happens if I leave this empty"). Language is a dropdown
+(the locale list will grow); the form style governs every interactive flow; the custom
+mirror enforces https for the uv binary inline (downloaded-and-executed ⇒ MITM→RCE).
+"""
+
+from __future__ import annotations
+
+import os
+from typing import override
+
+from rich.markup import escape
+from textual import on
+from textual.app import ComposeResult
+from textual.binding import Binding
+from textual.containers import VerticalScroll
+from textual.screen import Screen
+from textual.widgets import Input, RadioButton, RadioSet, Select, Static
+
+from . import config, i18n, tui_footer
+from .i18n import gettext
+
+_MIRROR_CHOICES = [*config.PYPI_PRESETS, "custom", "off"]
+
+
+class PreferencesScreen(Screen[bool]):
+    BINDINGS = [
+        Binding("escape", "close", gettext("Back")),
+        Binding("ctrl+a", "save", gettext("Save"), priority=True),
+    ]
+    DEFAULT_CSS = """
+    PreferencesScreen #pf-body {
+        padding: 0 1;
+        border: round $skit-box-indigo;
+        border-title-color: ansi_bright_white;
+        border-title-style: bold;
+    }
+    PreferencesScreen .section { color: $accent; margin: 1 0 0 0; }
+    PreferencesScreen .hint { color: $text-muted; }
+    PreferencesScreen .error { color: $error; }
+    PreferencesScreen RadioSet { layout: horizontal; height: auto; border: none; }
+    PreferencesScreen RadioSet > RadioButton { width: auto; margin: 0 3 0 0; }
+    PreferencesScreen #pf-keys { dock: bottom; height: 1; color: $text-muted; padding: 0 1; }
+    """
+
+    def on_mount(self) -> None:
+        self.query_one("#pf-body").border_title = gettext("Preferences")
+        self._toggle_custom()
+
+    @override
+    def compose(self) -> ComposeResult:
+        with VerticalScroll(id="pf-body"):
+            yield Static(gettext("Interface language"), classes="section")
+            current = config.load_config().get("language", "")
+            options = [(gettext("Automatic (follow the system)"), "auto")]
+            options += [(locale, locale) for locale in i18n.available_locales()]
+            yield Select(
+                options, value=current if current else "auto", allow_blank=False, id="pf-lang"
+            )
+            yield Static(
+                gettext("Currently in effect: %(locale)s") % {"locale": i18n.current_locale()},
+                classes="hint",
+            )
+
+            yield Static(gettext("Editor"), classes="section")
+            yield Input(
+                value=config.load_editor(),
+                placeholder=gettext("e.g. code --wait (empty = use $VISUAL / $EDITOR)"),
+                id="pf-editor",
+            )
+            fallback = os.environ.get("VISUAL") or os.environ.get("EDITOR") or ""
+            if fallback:
+                yield Static(
+                    gettext("Empty means: %(cmd)s (from $VISUAL / $EDITOR)")
+                    % {"cmd": escape(fallback)},
+                    classes="hint",
+                )
+
+            yield Static(gettext("Interactive form"), classes="section")
+            with RadioSet(id="pf-form"):
+                yield RadioButton(
+                    gettext("Mini form — opens in place, fully clickable"),
+                    value=config.load_form() == "tui",
+                )
+                yield RadioButton(
+                    gettext("Line-by-line prompts — plainest, best over slow terminals"),
+                    value=config.load_form() == "plain",
+                )
+
+            yield Static(
+                gettext("Download mirror (mainland-China acceleration)"), classes="section"
+            )
+            mirror = config.load_mirror()
+            if not mirror.enabled:
+                selected = "off"
+            else:
+                selected = next(
+                    (k for k, v in config.PYPI_PRESETS.items() if v == mirror.pypi), "custom"
+                )
+            with RadioSet(id="pf-mirror"):
+                for choice in _MIRROR_CHOICES:
+                    yield RadioButton(choice, value=(choice == selected))
+            yield Static(
+                gettext("Affects where dependencies and Python itself are downloaded from."),
+                classes="hint",
+            )
+            yield Input(value=mirror.pypi, placeholder=gettext("PyPI index URL"), id="pf-pypi")
+            yield Input(
+                value=mirror.python_install,
+                placeholder=gettext("Python-install mirror URL"),
+                id="pf-pyinstall",
+            )
+            yield Input(
+                value=mirror.uv_binary, placeholder=gettext("uv binary mirror URL"), id="pf-uv"
+            )
+            yield Static("", id="pf-uv-error", classes="error")
+        yield Static(
+            tui_footer.bar(
+                tui_footer.chip("screen.save", "Ctrl+A", gettext("Save")),
+                tui_footer.chip("screen.close", "Esc", gettext("Back")),
+            ),
+            id="pf-keys",
+            markup=True,
+        )
+
+    @on(RadioSet.Changed, "#pf-mirror")
+    def _mirror_changed(self, event: RadioSet.Changed) -> None:
+        self._toggle_custom()
+
+    def _mirror_choice(self) -> str:
+        index = self.query_one("#pf-mirror", RadioSet).pressed_index
+        return _MIRROR_CHOICES[index] if 0 <= index < len(_MIRROR_CHOICES) else "off"
+
+    def _toggle_custom(self) -> None:
+        custom = self._mirror_choice() == "custom"
+        for wid in ("#pf-pypi", "#pf-pyinstall", "#pf-uv"):
+            self.query_one(wid, Input).display = custom
+        self.query_one("#pf-uv-error", Static).display = custom
+
+    def action_save(self) -> None:
+        lang_value = self.query_one("#pf-lang", Select).value
+        i18n.set_language("" if lang_value in ("auto", Select.BLANK) else str(lang_value))
+        config.save_editor(self.query_one("#pf-editor", Input).value)
+        form_index = self.query_one("#pf-form", RadioSet).pressed_index
+        config.save_form("plain" if form_index == 1 else "tui")
+        choice = self._mirror_choice()
+        if choice == "off":
+            config.disable()
+        elif choice == "custom":
+            uv_url = self.query_one("#pf-uv", Input).value.strip()
+            if uv_url and not uv_url.startswith("https://"):
+                self.query_one("#pf-uv-error", Static).update(
+                    gettext(
+                        "The uv binary is downloaded and executed, so its mirror URL must "
+                        "use https:// (got: %(url)s)."
+                    )
+                    % {"url": escape(uv_url)}
+                )
+                return
+            config.save_mirror(
+                config.MirrorConfig(
+                    enabled=True,
+                    pypi=self.query_one("#pf-pypi", Input).value.strip(),
+                    python_install=self.query_one("#pf-pyinstall", Input).value.strip(),
+                    uv_binary=uv_url,
+                )
+            )
+        else:
+            config.save_mirror(config.preset(choice))
+        self.dismiss(True)
+
+    def action_close(self) -> None:
+        self.dismiss(False)