clash-controller 0.2.2__tar.gz → 0.2.3__tar.gz

{clash_controller-0.2.2 → clash_controller-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clash_controller
-Version: 0.2.2
+Version: 0.2.3
 Summary: A Textual TUI for managing Clash proxy instances
 Author-email: Moha-Master <hongkongreporter@outlook.com>
 License-Expression: MIT

{clash_controller-0.2.2 → clash_controller-0.2.3}/clash_controller/__init__.py

@@ -2,4 +2,4 @@
 Clash Controller - A Textual TUI for managing Clash proxy instances.
 """
 
-__version__ = "0.2.2"
+__version__ = "0.2.3"

{clash_controller-0.2.2 → clash_controller-0.2.3}/clash_controller/app.py

@@ -2,16 +2,63 @@
 from datetime import datetime
 from pathlib import Path
 
+from rich.spinner import SPINNERS
+from rich.text import Text
 from textual import work
 from textual.app import App, ComposeResult
 from textual.binding import Binding
+from textual.widget import Widget
 from textual.widgets import Static
 
 from .api import ClashAPI
+from .widgets import ProgressCover
+
+_DOTS = SPINNERS["dots"]
 
 
 class StatusBar(Static):
-    """底部状态栏：展示最近一次操作结果 / 进行中提示。"""
+    """底部状态栏：展示最近一次操作结果 / 进行中提示；spinner=True 时显示点阵转圈。"""
+
+    def __init__(self, *args, **kwargs) -> None:
+        super().__init__(*args, **kwargs)
+        self._text = ""
+        self._busy = False
+        self._frame = 0
+        self._timer = None
+
+    def render(self) -> Text:
+        if self._busy:
+            glyph = _DOTS["frames"][self._frame % len(_DOTS["frames"])]
+            return Text.assemble((glyph, "bold"), " ", self._text)
+        return Text(self._text)
+
+    def set_status(self, text: str) -> None:
+        self._busy = False
+        self._text = text
+        self._stop_timer()
+        self.refresh()
+
+    def set_spinner(self, text: str) -> None:
+        self._busy = True
+        self._text = text
+        self._ensure_timer()
+        self.refresh()
+
+    def _ensure_timer(self) -> None:
+        if self._timer is None and self.is_mounted:
+            self._timer = self.set_interval(_DOTS["interval"] / 1000, self._tick)
+
+    def _stop_timer(self) -> None:
+        if self._timer is not None:
+            self._timer.stop()
+            self._timer = None
+
+    def _tick(self) -> None:
+        self._frame += 1
+        self.refresh()
+
+    def on_mount(self) -> None:
+        self._ensure_timer()
 
 
 class ClashControllerApp(App):
@@ -67,13 +114,29 @@ class ClashControllerApp(App):
     def compose(self) -> ComposeResult:
         yield StatusBar("", id="status")
 
+    def get_loading_widget(self) -> Widget:
+        """全局默认：任意控件 .loading=True 时用 indeterminate 进度条覆盖其区域。"""
+        return ProgressCover()
+
     def status(self, message: str, kind: str = "") -> None:
         try:
             bar = self.query_one("#status", StatusBar)
-        except Exception:
+        except Exception:  # noqa: BLE001
             return
         bar.update_classes({"ok": kind == "ok", "warn": kind == "warn", "err": kind == "err"})
-        bar.update(message)
+        bar.set_status(message)
+
+    def spinner(self, on: bool, message: str = "加载中…") -> None:
+        """状态栏点阵 spinner（无遮罩、不阻断输入）：适合轻量、即时的后台动作。"""
+        try:
+            bar = self.query_one("#status", StatusBar)
+        except Exception:  # noqa: BLE001
+            return
+        bar.update_classes({})
+        if on:
+            bar.set_spinner(message)
+        else:
+            bar.set_status("")
 
     def notify_ok(self, message: str) -> None:
         self.status(message, "ok")

{clash_controller-0.2.2 → clash_controller-0.2.3}/clash_controller/screens/config.py

@@ -11,7 +11,7 @@ from ..config import load_config_providers, save_config_providers
 from ..deploy import compute_sha256, evaluate_update, fetch_remote_config, read_current_config
 from ..ssh import apply_local_config_file, apply_remote_config_via_ssh
 from ..ui import PageScreen
-from ..widgets import ConfirmModal, FormField, FormModal, fit_table_columns, load_rows, make_table, shorten
+from ..widgets import ConfirmModal, FormField, FormModal, busy, fit_table_columns, load_rows, make_table, shorten
 
 COLUMN_WEIGHTS = [2, 7]
 
@@ -176,61 +176,62 @@ class ConfigScreen(PageScreen):
         debug = self.app.debug_mode or bool(profile.get("debug_ssh"))
         url = provider.get("url", "")
 
-        self.app.status(f"正在从 {url} 拉取配置…")
-        self.app.add_log(f"Fetching config from {url}...")
-        try:
-            remote_payload, remote_hash, remote_mod_time = await asyncio.to_thread(fetch_remote_config, url)
-            local_mtime, local_bytes = await asyncio.to_thread(
-                read_current_config, profile, self.app.add_log, debug
-            )
-        except Exception as e:  # noqa: BLE001
-            self.app.notify_err(f"拉取或读取配置失败: {type(e).__name__}: {e}")
-            return
+        async with busy(self.app, "正在拉取远程配置…", mode="bar") as ov:
+            self.app.add_log(f"Fetching config from {url}...")
+            try:
+                remote_payload, remote_hash, remote_mod_time = await asyncio.to_thread(fetch_remote_config, url)
+                ov.set_message("正在读取目标配置…")
+                local_mtime, local_bytes = await asyncio.to_thread(
+                    read_current_config, profile, self.app.add_log, debug
+                )
+            except Exception as e:  # noqa: BLE001
+                self.app.notify_err(f"拉取或读取配置失败: {type(e).__name__}: {e}")
+                return
 
-        local_hash = compute_sha256(local_bytes)
-        decision = evaluate_update(remote_hash, remote_mod_time, local_hash, local_mtime)
-
-        proceed = True
-        if decision == "auto":
-            self.app.add_log("Remote config newer with different hash. Proceeding without prompt.")
-        elif decision == "confirm_older":
-            proceed = await self.app.push_screen_wait(
-                ConfirmModal("远程配置可能比本地更旧，仍要覆盖目标配置吗？", default_yes=False)
-            )
-        elif decision == "confirm_unknown":
-            proceed = await self.app.push_screen_wait(
-                ConfirmModal("远程配置内容不同，但无法获取更新时间。是否继续覆盖目标配置？", default_yes=True)
-            )
-        else:  # confirm_same
-            proceed = await self.app.push_screen_wait(
-                ConfirmModal("远程配置与目标配置内容相同，仍要覆盖吗？", default_yes=False)
-            )
-
-        if not proceed:
-            self.app.status("已取消更新", "warn")
-            self.app.add_log("Config update cancelled by user after comparison.")
-            return
+            local_hash = compute_sha256(local_bytes)
+            decision = evaluate_update(remote_hash, remote_mod_time, local_hash, local_mtime)
 
-        self.app.status("正在部署配置…")
-        try:
-            if profile.get("endpoint_type") == "remote":
-                self.app.add_log("Deploying config to remote endpoint via SSH.")
-                await asyncio.to_thread(
-                    apply_remote_config_via_ssh, profile, remote_payload, self.app.add_log, debug
+            proceed = True
+            if decision == "auto":
+                self.app.add_log("Remote config newer with different hash. Proceeding without prompt.")
+            elif decision == "confirm_older":
+                proceed = await self.app.push_screen_wait(
+                    ConfirmModal("远程配置可能比本地更旧，仍要覆盖目标配置吗？", default_yes=False)
+                )
+            elif decision == "confirm_unknown":
+                proceed = await self.app.push_screen_wait(
+                    ConfirmModal("远程配置内容不同，但无法获取更新时间。是否继续覆盖目标配置？", default_yes=True)
+                )
+            else:  # confirm_same
+                proceed = await self.app.push_screen_wait(
+                    ConfirmModal("远程配置与目标配置内容相同，仍要覆盖吗？", default_yes=False)
                 )
-            else:
-                self.app.add_log("Deploying config to local endpoint file.")
-                await asyncio.to_thread(apply_local_config_file, profile, remote_payload)
-        except Exception as e:  # noqa: BLE001
-            self.app.notify_err(f"部署配置失败: {type(e).__name__}: {e}")
-            return
 
-        self.app.status("正在通过 Clash API 重载配置…")
-        try:
-            result, error = await asyncio.to_thread(self.app.get_api().reload_configs)
-        except Exception as e:  # noqa: BLE001
-            self.app.notify_err(f"重载配置失败: {type(e).__name__}: {e}")
-            return
+            if not proceed:
+                self.app.status("已取消更新", "warn")
+                self.app.add_log("Config update cancelled by user after comparison.")
+                return
+
+            ov.set_message("正在部署配置…")
+            try:
+                if profile.get("endpoint_type") == "remote":
+                    self.app.add_log("Deploying config to remote endpoint via SSH.")
+                    await asyncio.to_thread(
+                        apply_remote_config_via_ssh, profile, remote_payload, self.app.add_log, debug
+                    )
+                else:
+                    self.app.add_log("Deploying config to local endpoint file.")
+                    await asyncio.to_thread(apply_local_config_file, profile, remote_payload)
+            except Exception as e:  # noqa: BLE001
+                self.app.notify_err(f"部署配置失败: {type(e).__name__}: {e}")
+                return
+
+            ov.set_message("正在通过 Clash API 重载配置…")
+            try:
+                result, error = await asyncio.to_thread(self.app.get_api().reload_configs)
+            except Exception as e:  # noqa: BLE001
+                self.app.notify_err(f"重载配置失败: {type(e).__name__}: {e}")
+                return
         self.app.report("重载配置", result, error)
 
     @on(Button.Pressed, "#reload-api")

{clash_controller-0.2.2 → clash_controller-0.2.3}/clash_controller/screens/overview.py

@@ -1,6 +1,7 @@
 """概览屏：版本 + 实时流量 / 内存（流式接口）+ 当前活动连接表（每秒轮询）。"""
 import asyncio
 import json
+import time
 from collections.abc import Callable
 from datetime import datetime
 
@@ -10,7 +11,7 @@ from textual.containers import Horizontal, Vertical
 from textual.widgets import DataTable, Static
 
 from ..ui import PageScreen
-from ..widgets import fit_table_columns, load_rows, make_table, shorten
+from ..widgets import fit_table_columns, hold_busy, load_rows, make_table, shorten
 
 COLUMN_WEIGHTS = [4, 1.5, 1.5, 3, 3]
 
@@ -55,7 +56,7 @@ class OverviewScreen(PageScreen):
         self._consume("内存", api.get_memory_stream, self._on_memory)
         self.query_one(DataTable).focus()
         self._timer = self.set_interval(1.0, self._refresh_connections)
-        self._refresh_connections()
+        self._refresh_connections(show_overlay=True)
 
     def on_unmount(self) -> None:
         self._stop = True
@@ -72,7 +73,7 @@ class OverviewScreen(PageScreen):
 
     def reload_page(self) -> None:
         self._fetch_version()
-        self._refresh_connections()
+        self._refresh_connections(show_overlay=True)
 
     # ------------------------------------------------------------ 后台线程
 
@@ -130,50 +131,64 @@ class OverviewScreen(PageScreen):
         fit_table_columns(self.query_one("#cn-table", DataTable), COLUMN_WEIGHTS, rows=self._count)
 
     @work(exclusive=False)
-    async def _refresh_connections(self) -> None:
-        if self._busy or not self.is_mounted:
+    async def _refresh_connections(self, show_overlay: bool = False) -> None:
+        if self._busy:
             return
         self._busy = True
+        started = time.monotonic()
+        table = self.query_one("#cn-table", DataTable)
+        if show_overlay:
+            table.loading = True
         try:
-            data, error = await asyncio.to_thread(self.app.get_api().get_connections)
-        except Exception as e:  # noqa: BLE001
-            self._busy = False
-            self.app.notify_err(f"获取连接失败: {type(e).__name__}: {e}")
-            return
-        self._busy = False
-        if not self.is_mounted:
-            return
-
-        if error:
-            self.app.notify_err(f"获取连接失败: {error}")
-            return
-
-        data = data if isinstance(data, dict) else {}
-        connections = data.get("connections", []) or []
-        total_dl = data.get("downloadTotal", 0) / (1024 * 1024)
-        total_ul = data.get("uploadTotal", 0) / (1024 * 1024)
-
-        rows = []
-        for conn in connections:
-            metadata = conn.get("metadata", {}) or {}
-            host = metadata.get("host") or metadata.get("destinationIP", "未知")
-            rows.append([
-                Text(shorten(str(host), 40)),
-                Text(str(metadata.get("network", "?"))),
-                Text(str(metadata.get("type", "?"))),
-                Text(shorten(str(conn.get("rule", "?")), 30)),
-                Text(shorten(" -> ".join(conn.get("chains", []) or []), 30)),
-            ])
-        self._count = len(rows)
-        load_rows(self.query_one("#cn-table", DataTable), rows)
-        self._refit()
-        self.query_one("#cn-summary", Static).update(
-            Text(
-                f"{len(connections)} 条 · 上传 {total_ul:.2f} MB / 下载 {total_dl:.2f} MB"
-                f" · 更新于 {datetime.now():%H:%M:%S}"
+            try:
+                data, error = await asyncio.to_thread(self.app.get_api().get_connections)
+            except Exception as e:  # noqa: BLE001
+                self.app.notify_err(f"获取连接失败: {type(e).__name__}: {e}")
+                return
+            if not self.is_mounted:
+                return
+            if error:
+                self.app.notify_err(f"获取连接失败: {error}")
+                return
+
+            data = data if isinstance(data, dict) else {}
+            connections = data.get("connections", []) or []
+            total_dl = data.get("downloadTotal", 0) / (1024 * 1024)
+            total_ul = data.get("uploadTotal", 0) / (1024 * 1024)
+
+            rows = []
+            for conn in connections:
+                metadata = conn.get("metadata", {}) or {}
+                host = metadata.get("host") or metadata.get("destinationIP", "未知")
+                rows.append([
+                    Text(shorten(str(host), 40)),
+                    Text(str(metadata.get("network", "?"))),
+                    Text(str(metadata.get("type", "?"))),
+                    Text(shorten(str(conn.get("rule", "?")), 30)),
+                    Text(shorten(" -> ".join(conn.get("chains", []) or []), 30)),
+                ])
+            self._count = len(rows)
+            load_rows(table, rows)
+            self._refit()
+            self.query_one("#cn-summary", Static).update(
+                Text(
+                    f"{len(connections)} 条 · 上传 {total_ul:.2f} MB / 下载 {total_dl:.2f} MB"
+                    f" · 更新于 {datetime.now():%H:%M:%S}"
+                )
             )
-        )
-        self.app.status(f"连接总数 {len(connections)}")
+            self.app.status(f"连接总数 {len(connections)}")
+        finally:
+            self._busy = False
+            if show_overlay:
+                # 无论正常/异常/取消，覆盖层都必须撤下
+                try:
+                    if self.is_mounted:
+                        await hold_busy(started)
+                finally:
+                    table.loading = False
+                if self.is_mounted:
+                    self.call_after_refresh(self._refit)  # 覆盖层撤下后区域宽可能变化，按最终宽度重排
+                    table.focus()
 
     # ------------------------------------------------------------ UI 更新
 

{clash_controller-0.2.2 → clash_controller-0.2.3}/clash_controller/screens/settings.py

@@ -1,12 +1,13 @@
 """设置屏：TUN / 模式即时生效控件（无保存动作）、重载与升级操作；日志入口在顶栏折叠菜单。"""
 import asyncio
+import time
 
 from textual import on, work
 from textual.containers import Horizontal, Vertical
 from textual.widgets import Button, Select, Static, Switch
 
 from ..ui import PageScreen
-from ..widgets import ConfirmModal
+from ..widgets import ConfirmModal, ControlBusy, hold_busy
 
 MODES = [("规则", "rule"), ("全局", "global"), ("直连", "direct")]
 
@@ -19,6 +20,7 @@ class SettingsScreen(PageScreen):
         super().__init__()
         self._tun = False
         self._mode = "rule"
+        self._busy = ControlBusy(self)
         self.menu = [("查看应用日志", self._open_logs, False)]
 
     def compose_page(self):
@@ -83,7 +85,7 @@ class SettingsScreen(PageScreen):
         if bool(event.value) == self._tun:
             return
         self._tun = bool(event.value)
-        self._call("toggle_tun", f"{'启用' if self._tun else '禁用'} TUN", self._tun)
+        self._call("toggle_tun", f"{'启用' if self._tun else '禁用'} TUN", self._tun, control_id="st-tun")
 
     @on(Select.Changed, "#st-mode")
     def _on_mode_changed(self, event: Select.Changed) -> None:
@@ -94,45 +96,60 @@ class SettingsScreen(PageScreen):
             return
         self._mode = mode
         labels = dict(MODES)
-        self._call("set_mode", f"切换模式为 {labels.get(mode, mode)}", mode)
+        self._call(
+            "set_mode", f"切换模式为 {labels.get(mode, mode)}", mode, control_id="st-mode"
+        )
 
     @on(Button.Pressed, "#reload-geo")
     def _on_reload_geo(self) -> None:
-        self._call("reload_geo_databases", "重载 GEO 数据库")
+        self._call("reload_geo_databases", "重载 GEO 数据库", control_id="reload-geo")
 
     @on(Button.Pressed, "#restart")
     def _on_restart(self) -> None:
-        self._confirm_then("确定要重启 Clash Core 吗？", "restart", "重启 Clash Core")
+        self._confirm_then("确定要重启 Clash Core 吗？", "restart", "重启 Clash Core", "restart")
 
     @on(Button.Pressed, "#up-kernel")
     def _on_up_kernel(self) -> None:
-        self._confirm_then("确定要请求升级内核吗？", "upgrade_kernel", "升级内核")
+        self._confirm_then("确定要请求升级内核吗？", "upgrade_kernel", "升级内核", "up-kernel")
 
     @on(Button.Pressed, "#up-ui")
     def _on_up_ui(self) -> None:
-        self._confirm_then("确定要请求升级 UI 吗？", "upgrade_ui", "升级 UI")
+        self._confirm_then("确定要请求升级 UI 吗？", "upgrade_ui", "升级 UI", "up-ui")
 
     @on(Button.Pressed, "#up-geo")
     def _on_up_geo(self) -> None:
-        self._confirm_then("确定要请求升级 GEO 数据库吗？", "upgrade_geo_databases", "升级 GEO 数据库")
+        self._confirm_then("确定要请求升级 GEO 数据库吗？", "upgrade_geo_databases", "升级 GEO 数据库", "up-geo")
 
-    def _confirm_then(self, message: str, method_name: str, desc: str) -> None:
+    def _confirm_then(self, message: str, method_name: str, desc: str, control_id: str) -> None:
         def confirm(ok: bool) -> None:
             if ok:
-                self._call(method_name, desc)
+                self._call(method_name, desc, control_id=control_id)
 
         self.app.push_screen(ConfirmModal(message, default_yes=False), confirm)
 
     @work(exclusive=True)
-    async def _call(self, method_name: str, desc: str, *args) -> None:
+    async def _call(self, method_name: str, desc: str, *args, control_id: str | None = None) -> None:
         api = self.app.get_api()
         method = getattr(api, method_name)
-        self.app.status(f"正在{desc}…")
+        started = time.monotonic()
+        control = self.query_one(f"#{control_id}") if control_id else None
+        if control is not None:
+            # 就地反馈：禁用触发控件并把文本换成点阵 spinner（比顶栏更直观）
+            self._busy.start(control)
+        else:
+            self.app.spinner(True, f"正在{desc}…")
         try:
             result, error = await asyncio.to_thread(method, *args)
+            await hold_busy(started)
         except Exception as e:  # noqa: BLE001
+            await hold_busy(started)
             self.app.notify_err(f"{desc}失败: {type(e).__name__}: {e}")
             self._load_configs()  # 失败回滚控件到服务端真实状态
             return
+        finally:
+            if control is not None:
+                self._busy.stop()
+            else:
+                self.app.spinner(False)
         self.app.report(desc, result, error)
         self._load_configs()  # 以服务端状态为准回写控件（失败时即回滚）

{clash_controller-0.2.2 → clash_controller-0.2.3}/clash_controller/widgets.py

@@ -3,18 +3,40 @@
 所有模态均为 ModalScreen 泛型返回值，配合 push_screen_wait / 回调消费；
 数据展示统一使用 DataTable（ClickTable 单击执行），不构造字符串伪表格。
 """
+from __future__ import annotations
+
+import asyncio
+import contextlib
+import time
 from collections.abc import Callable
 from dataclasses import dataclass, field
 from typing import Any
 
 from rich.cells import cell_len
+from rich.spinner import SPINNERS
+from rich.style import Style
 from rich.text import Text
 from textual import events
 from textual.binding import Binding
+from textual.clock import Clock
 from textual.containers import Horizontal, ScrollableContainer, Vertical, VerticalScroll
 from textual.coordinate import Coordinate
+from textual.css.query import NoMatches
 from textual.screen import ModalScreen
-from textual.widgets import Button, DataTable, Input, Label, OptionList, Select, Static, Switch, TextArea
+from textual.widget import Widget
+from textual.widgets import (
+    Button,
+    DataTable,
+    Input,
+    Label,
+    LoadingIndicator,
+    OptionList,
+    ProgressBar,
+    Select,
+    Static,
+    Switch,
+    TextArea,
+)
 
 try:  # textual 各版本 Option 导出位置不同
     from textual.widgets.option_list import Option
@@ -340,7 +362,7 @@ class FormModal(ModalScreen["dict | None"]):
             text = HINT_FORM
         self.query_one("#frm-hint", HintBar).update(text)
 
-    def _collect(self) -> "dict | None":
+    def _collect(self) -> dict | None:
         """收集表单值；校验失败时写入错误信息并返回 None。可在子类扩展。"""
         err_box = self.query_one("#frm-error", Static)
         err_box.update(Text(""))
@@ -699,10 +721,268 @@ def fit_table_columns(table: DataTable, weights: list[float], rows: int | None =
     return visible
 
 
+# ---------------------------------------------------------------- 加载指示器
+
+class _IndeterminateBar:
+    """自渲染不定进度条：按**绘制时**的区域宽度取景并居中。
+
+    不依赖 ``Widget.size``：覆盖层是交给合成器临时绘制的，首帧 ``_size`` 可能
+    尚未由 ``_size_updated`` 写入，若在 ``render()`` 里读 ``self.size`` 会拿到 0
+    而画出一格宽的「隐形条」。改用 Rich 渲染协议，``options.max_width`` 即为本次
+    真正要绘制的区域宽度，保证任何一帧都居中可见。
+    """
+
+    def __init__(
+        self, clock: Clock, animation_level: str, highlight: Style, track: Style, cap: int
+    ) -> None:
+        self._clock = clock
+        self._animation_level = animation_level
+        self._highlight = highlight
+        self._track = track
+        self._cap = cap
+
+    def __rich_console__(self, console, options):  # noqa: ANN001, ANN201
+        total = max(1, options.max_width)
+        width = min(total, self._cap)
+        bar = max(2, int(width * 0.25))
+        span = width + bar
+        if self._animation_level == "none":
+            start = 0
+        else:
+            speed = 30  # cells/s，与 Textual ProgressBar 的 indeterminate 一致
+            pos = int((speed * self._clock.time) % (2 * span))
+            if pos > span:
+                pos = 2 * span - pos
+            start = pos - bar
+        text = Text()
+        for i in range(width):
+            text.append("━", style=self._highlight if start <= i < start + bar else self._track)
+        yield text
+
+
+class ProgressCover(Widget):
+    """控件 loading=True 时覆盖其区域的不定进度条（方框 + 居中往复高亮条）。
+
+    必须是**单个自渲染 widget**：Textual 的 ``Widget._cover()`` 只把它交给合成器
+    替换原控件区域，并不挂进 DOM 参与布局；若用容器 + 子件，子件 region 恒为 0
+    而完全不可见（``ProgressBar`` 自身 compose 出 ``Bar`` 子件，因此同样不可用）。
+    """
+
+    COMPONENT_CLASSES = {"pc--bar", "pc--highlight"}
+
+    DEFAULT_CSS = """
+    ProgressCover {
+        width: 100%;
+        height: 100%;
+        background: $surface;
+        border: round $secondary;
+        margin: 1 1 0 1;
+        content-align: center middle;
+        &> .pc--bar { color: $panel-lighten-1; background: $surface; }
+        &> .pc--highlight { color: $primary; background: $surface; }
+    }
+    """
+
+    BAR_WIDTH = 40
+    """进度条固定宽（与全屏 BusyOverlay `.busy-box` 的内容宽一致），由 content-align 居中。"""
+
+    def __init__(self) -> None:
+        super().__init__()
+        self._clock = Clock()
+
+    def on_mount(self) -> None:
+        self._clock.reset()
+        self.auto_refresh = 1 / 15
+
+    def render(self) -> _IndeterminateBar:
+        highlight = Style.from_color(self.get_component_rich_style("pc--highlight").color)
+        track = Style.from_color(self.get_component_rich_style("pc--bar").color)
+        return _IndeterminateBar(
+            self._clock, self.app.animation_level, highlight, track, self.BAR_WIDTH
+        )
+
+
+class BusyOverlay(ModalScreen[None]):
+    """全屏忙碌遮罩：阻断一切输入直到被 pop。
+
+    使用固定宽度（46）与分行结构防止文案变化引起容器抖动或 Emoji 换行。
+    """
+
+    DEFAULT_CSS = """
+    BusyOverlay {
+        align: center middle;
+        background: $boost;
+    }
+    BusyOverlay .busy-box {
+        width: 46;
+        height: auto;
+        min-height: 5;
+        padding: 1 2;
+        border: round $primary;
+        background: $surface;
+        align: center middle;
+    }
+    BusyOverlay #busy-title {
+        width: 100%;
+        content-align: center middle;
+        text-style: bold;
+        text-wrap: nowrap;
+        text-overflow: ellipsis;
+        overflow: hidden;
+        margin-bottom: 1;
+    }
+    BusyOverlay LoadingIndicator { width: 100%; height: 1; }
+    BusyOverlay ProgressBar { width: 100%; }
+    BusyOverlay #busy-counter {
+        width: 100%;
+        content-align: center middle;
+        color: $text-muted;
+        margin-top: 1;
+    }
+    """
+
+    def __init__(self, message: str = "正在处理…", *, mode: str = "dots", total: float | None = None) -> None:
+        super().__init__()
+        self._message = message
+        self._mode = mode
+        self._total = total
+        self._done = 0.0
+
+    def compose(self):
+        with Vertical(classes="busy-box"):
+            yield Static(self._message, id="busy-title")
+            if self._mode == "bar":
+                yield ProgressBar(total=None, show_bar=True, show_percentage=False, show_eta=False)
+            elif self._mode == "percent":
+                yield ProgressBar(total=self._total, show_percentage=True, show_eta=False)
+                yield Static(f"0/{int(self._total or 0)} (0%)", id="busy-counter")
+            else:
+                yield LoadingIndicator()
+
+    def set_message(self, message: str) -> None:
+        self._message = message
+        if self.is_mounted:
+            with contextlib.suppress(NoMatches):
+                self.query_one("#busy-title", Static).update(message)
+
+    def advance(self, amount: float = 1) -> None:
+        """percent 模式：推进进度条并刷新计数文案。"""
+        self._done += amount
+        if self.is_mounted:
+            with contextlib.suppress(NoMatches):
+                bar = self.query_one(ProgressBar)
+                bar.progress += amount
+                if self._mode == "percent":
+                    pct = int(round((self._done / (self._total or 1)) * 100))
+                    self.query_one("#busy-counter", Static).update(
+                        f"{int(self._done)}/{int(self._total or 0)} ({pct}%)"
+                    )
+
+
+@contextlib.asynccontextmanager
+async def busy(app, message: str = "正在处理…", *, mode: str = "dots", total: float | None = None):
+    """异步 worker 内包裹耗时操作，全程显示全屏忙碌遮罩（异常/取消亦收起）。
+
+    用法：async with busy(self.app, "正在保存…", mode="bar"): await asyncio.to_thread(...)
+    需要进度回调时接住返回的遮罩对象：async with busy(app, "拉取中", mode="percent", total=n) as ov: ...
+    """
+    overlay = BusyOverlay(message, mode=mode, total=total)
+    app.push_screen(overlay)
+    try:
+        yield overlay
+    finally:
+        # 确保遮罩被收起：可能仍是栈顶，也可能已被其它层覆盖
+        for _ in range(len(app.screen_stack)):
+            if isinstance(app.screen, BusyOverlay) or app.screen is overlay:
+                app.pop_screen()
+            else:
+                break
+        if overlay.is_mounted:
+            overlay.remove()
+
+
+# ---------------------------------------------------------------- 控件就地忙碌态
+
+BUSY_MIN_SECONDS = 0.3
+"""忙碌态最短可见时长（秒）：本地 API 常在 1 帧内返回，过短的反馈肉眼看不见。"""
+
+
+async def hold_busy(started: float) -> None:
+    """把忙碌反馈补足到 BUSY_MIN_SECONDS，避免快速操作只闪一帧。"""
+    remaining = BUSY_MIN_SECONDS - (time.monotonic() - started)
+    if remaining > 0:
+        await asyncio.sleep(remaining)
+
+
+class ControlBusy:
+    """异步操作期间在触发控件上就地反馈：禁用控件 + 文本换成点阵 spinner。
+
+    - `Button`：改写自身 `label`（如 `⠋ 重启 Clash`），结束后复原。
+    - `Select` / `Switch`：禁用控件，并在同行左侧标签（`.kv-label` / `.fl-label`）前插 spinner。
+    """
+
+    def __init__(self, screen) -> None:
+        self.screen = screen
+        self._control = None
+        self._targets: list[tuple[object, str]] = []
+        self._frame = 0
+        self._timer = None
+
+    @staticmethod
+    def _row_label(control):
+        parent = control.parent
+        if parent is not None:
+            for child in parent.children:
+                if isinstance(child, Static):
+                    return child
+        return None
+
+    def start(self, control) -> None:
+        self.stop()
+        self._control = control
+        control.disabled = True
+        if isinstance(control, Button):
+            self._targets.append((control, control.label.plain))
+        else:
+            label = self._row_label(control)
+            if label is not None:
+                self._targets.append((label, str(label.content)))
+        self._apply()
+        self._timer = self.screen.set_interval(SPINNERS["dots"]["interval"] / 1000, self._tick)
+
+    def _apply(self) -> None:
+        frames = SPINNERS["dots"]["frames"]
+        glyph = frames[self._frame % len(frames)]
+        for widget, original in self._targets:
+            if isinstance(widget, Button):
+                widget.label = f"{glyph} {original}"
+            else:
+                widget.update(f"{glyph} {original}")
+
+    def _tick(self) -> None:
+        self._frame += 1
+        self._apply()
+
+    def stop(self) -> None:
+        if self._timer is not None:
+            self._timer.stop()
+            self._timer = None
+        for widget, original in self._targets:
+            if isinstance(widget, Button):
+                widget.label = original
+            else:
+                widget.update(original)
+        self._targets = []
+        if self._control is not None:
+            self._control.disabled = False
+            self._control = None
+
+
 __all__ = [
     "ConfirmModal", "InputModal", "FormField", "FormModal", "OutputModal",
     "ClickTable", "make_table", "load_rows", "filter_fuzzy", "fuzzy_score",
     "shorten", "rcell", "fit_table_columns",
+    "ProgressCover", "BusyOverlay", "busy", "ControlBusy", "hold_busy", "BUSY_MIN_SECONDS",
     "tint", "colored_text",
     "STYLE_OK", "STYLE_ERR", "STYLE_WARN", "STYLE_INFO", "STYLE_DIM",
     "HINT_PICK", "HINT_MENU", "HINT_FORM", "EDIT_HINT", "HINT_FORM_EDIT", "HINT_FORM_TA",

{clash_controller-0.2.2 → clash_controller-0.2.3}/clash_controller.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clash_controller
-Version: 0.2.2
+Version: 0.2.3
 Summary: A Textual TUI for managing Clash proxy instances
 Author-email: Moha-Master <hongkongreporter@outlook.com>
 License-Expression: MIT

{clash_controller-0.2.2 → clash_controller-0.2.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "clash_controller"
-version = "0.2.2"
+version = "0.2.3"
 description = "A Textual TUI for managing Clash proxy instances"
 readme = "README.md"
 requires-python = ">=3.10"