sdev 0.6.0__tar.gz → 0.6.2__tar.gz

{sdev-0.6.0/sdev.egg-info → sdev-0.6.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sdev
-Version: 0.6.0
+Version: 0.6.2
 Summary: 串口控制器工具包
 Home-page: https://github.com/klrc/sdev
 Author: klrc

{sdev-0.6.0 → sdev-0.6.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sdev"
-version = "0.6.0"
+version = "0.6.2"
 description = "串口控制器工具包"
 readme = "README.md"
 license = {text = "MIT"}

{sdev-0.6.0 → sdev-0.6.2}/sdev/__init__.py

@@ -10,7 +10,7 @@ from __future__ import annotations
 from .models import Demoboard
 from .remote import any_device
 
-__version__ = "0.6.0"
+__version__ = "0.6.2"
 __author__ = "klrc"
 __email__ = "1440698245@qq.com"
 

{sdev-0.6.0 → sdev-0.6.2}/sdev/base/serial_core.py

@@ -187,6 +187,23 @@ class SerialCore:
         self._max_lines_per_prompt = 4
         # 仅串口与缓冲区逻辑，不包含任何日志/显示状态
 
+    # --- 轻量级日志接口：供上层 Demoboard.check_alive 使用，默认静默 ---
+
+    def _log(self, level: str, message: str) -> None:
+        """
+        占位日志接口：目前串口核心层不做实际日志记录，仅为上层提供统一调用点。
+        """
+        return
+
+    def error(self, message: str) -> None:
+        self._log("error", message)
+
+    def warning(self, message: str) -> None:
+        self._log("warning", message)
+
+    def success(self, message: str) -> None:
+        self._log("success", message)
+
     # --- 连接与资源管理 ---
 
     def _serial_reader(self) -> None:

{sdev-0.6.0 → sdev-0.6.2}/sdev/cli/cli_wrapper.py

@@ -280,7 +280,7 @@ def _get_combined_demoboard_list_silent(
     remote_hosts_override: Optional[list] = None,
 ) -> list[dict[str, Any]]:
     """
-    静默获取「本地 + 远程」combined 列表并填充 device（小写），不输出任何日志。
+    静默获取「本地 + 远程」combined 列表并填充 device（保持原始大小写），不输出任何日志。
     供 activate 按 device 模糊匹配时使用。实现复用 sdev.remote.board_list。
     """
     from ..remote.board_list import get_combined_demoboard_list_silent as _get_combined
@@ -380,9 +380,23 @@ def cmd_shell(args: argparse.Namespace) -> int:
     prefix = _format_shell_prefix(host, port, baudrate)
     print(f"{_CYAN}{prefix}{_RESET}")
 
+    # 若未显式指定 --timeout，则默认等待 60 秒，避免长命令过早被认为超时。
+    effective_timeout: Optional[float] = args.timeout if args.timeout is not None else 60.0
+
     with Demoboard(port, baudrate, host=host) as board:
         try:
-            _ = board.execute_command(args.command, flag=args.flag, timeout=args.timeout)
+            _ = board.execute_command(args.command, flag=args.flag, timeout=effective_timeout)
+        except KeyboardInterrupt:
+            # 将本地 Ctrl-C 映射为对板子的真实 Ctrl-C 中断，
+            # 然后通过 execute_command(None, ...) 等待提示符，尽量让远端命令完整收尾。
+            try:
+                board.send_interrupt()
+                # 不再发送新命令，仅等待当前提示符出现作为“收尾”信号。
+                _ = board.execute_command(None, flag=args.flag, timeout=effective_timeout)
+            except Exception:
+                pass
+            print()  # 保证光标回到新行
+            return 130  # 约定：被 Ctrl-C 中断
         except TimeoutError as e:
             print(e, file=sys.stderr)
             return 1
@@ -616,7 +630,7 @@ def cmd_demoboard_list(args: argparse.Namespace) -> int:
         print(f"{_YELLOW}[INFO]{_RESET} 未发现任何 demoboard。")
         return 0
 
-    # 对可用板子逐个获取 device（串行，避免持锁冲突），统一小写
+    # 对可用板子逐个获取 device（串行，避免持锁冲突），保留原始大小写
     device_timeout = getattr(args, "timeout", 2.0)
     for r in combined:
         if not r.get("available"):
@@ -633,7 +647,7 @@ def cmd_demoboard_list(args: argparse.Namespace) -> int:
                 board = Demoboard(port_raw, baud)
             board.connect()
             try:
-                r["device"] = (board.check_model_type(timeout=device_timeout) or "").lower()
+                r["device"] = board.check_model_type(timeout=device_timeout) or ""
             finally:
                 board.disconnect()
         except Exception:

{sdev-0.6.0 → sdev-0.6.2}/sdev/models/demoboard.py

@@ -107,9 +107,20 @@ class Demoboard:
 
     # --- 对外 API ---
 
+    def send_interrupt(self) -> None:
+        """
+        将一次「中断」请求转换为对板子的 Ctrl-C（^C）发送。
+        供 CLI 在捕获本地 KeyboardInterrupt 时调用，尽量让远端 shell 也一起中断当前前台命令。
+        """
+        try:
+            self._core.send(CTRL_C)
+        except Exception:
+            # 中断本身是“尽力而为”，失败时不再向外抛异常，避免干扰宿主进程退出路径。
+            return
+
     def execute_command(
         self,
-        cmd: str,
+        cmd: Optional[str],
         *,
         flag: str = " #",
         timeout: Optional[float] = None,
@@ -118,6 +129,8 @@ class Demoboard:
     ) -> Union[List[str], Generator[str, None, None]]:
         """
         在板子上执行一条命令并等待提示符出现：
+        - cmd 为非 None 时：发送该命令并等待其回显 + 提示符；
+        - cmd 为 None 时：不发送新命令，仅等待当前提示符（适合 Ctrl-C 之后“收尾”等待）。
         - 默认开启 display：边收数据边在宿主终端高亮回显（语义参考旧版 shell）；
         - stream=False：收集所有行并返回 list；
         - stream=True：返回一个逐行生成原始输出的 generator。

{sdev-0.6.0 → sdev-0.6.2}/sdev/remote/board_list.py

@@ -174,9 +174,7 @@ def get_combined_demoboard_list_silent(
                 board = Demoboard(port_raw, baud)
             board.connect()
             try:
-                r["device"] = (
-                    board.check_model_type(timeout=device_timeout) or ""
-                ).lower()
+                r["device"] = board.check_model_type(timeout=device_timeout) or ""
             finally:
                 board.disconnect()
         except Exception:

{sdev-0.6.0 → sdev-0.6.2}/sdev/remote/client.py

@@ -45,6 +45,23 @@ class RemoteSerialCore:
         self._scan_timeout = 0.1
         self._max_lines_per_prompt = 4
 
+    # --- 轻量级日志接口：供上层 Demoboard.check_alive 使用，默认静默 ---
+
+    def _log(self, level: str, message: str) -> None:
+        """
+        占位日志接口：目前远程串口核心层不做实际日志记录，仅为上层提供统一调用点。
+        """
+        return
+
+    def error(self, message: str) -> None:
+        self._log("error", message)
+
+    def warning(self, message: str) -> None:
+        self._log("warning", message)
+
+    def success(self, message: str) -> None:
+        self._log("success", message)
+
     # --- 底层 TCP 收发 ---
 
     def _read_loop(self) -> None:

{sdev-0.6.0 → sdev-0.6.2/sdev.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sdev
-Version: 0.6.0
+Version: 0.6.2
 Summary: 串口控制器工具包
 Home-page: https://github.com/klrc/sdev
 Author: klrc

{sdev-0.6.0 → sdev-0.6.2}/setup.py

@@ -5,7 +5,7 @@ with open("README.md", "r", encoding="utf-8") as fh:
 
 setup(
     name="sdev",
-    version="0.6.0",
+    version="0.6.2",
     author="klrc",
     author_email="144069824@qq.com",
     description="串口控制器工具包",