termora 0.80.0__py3-none-any.whl

cutecom/__init__.py

@@ -0,0 +1,11 @@
+"""Termora（``cutecom`` 包）— 串口、CAN 与协议调试工具。
+
+提供桌面 GUI 与可选的无界面 CLI；本模块导出应用名称、组织与版本等标识，
+供设置持久化、窗口标题与命令行描述共用。
+"""
+
+APP_NAME = "Termora"
+APP_ORG = "Termora"
+APP_ID = "Termora"
+APP_TAGLINE = "Serial · CAN · Protocols"
+VERSION = "0.80.0"

cutecom/__main__.py

@@ -0,0 +1,6 @@
+"""``python -m cutecom`` 入口：委托 ``cutecom.app.main`` 启动应用。"""
+
+from cutecom.app import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

cutecom/app.py

@@ -0,0 +1,151 @@
+"""Termora 主入口：解析命令行，在 GUI 与无界面串口模式之间分发。"""
+
+from __future__ import annotations
+
+import argparse
+import sys
+import time
+from pathlib import Path
+
+from PySide6.QtCore import QCoreApplication, QIODevice, QTimer
+from PySide6.QtSerialPort import QSerialPort
+from PySide6.QtWidgets import QApplication
+
+from cutecom import APP_ID, APP_NAME, APP_ORG, VERSION
+from cutecom.core.settings import AppSettings
+from cutecom.core.theme import ui_font
+from cutecom.ui.icons import app_icon
+from cutecom.ui.main_window import MainWindow
+
+
+def _run_headless(args: argparse.Namespace) -> int:
+    """无界面模式：打开串口，可选发送字符串或文件，将 RX 写入 stdout 后按超时退出。"""
+    app = QCoreApplication([APP_NAME])
+    app.setOrganizationName(APP_ORG)
+    app.setApplicationName(APP_ID)
+    app.setApplicationVersion(VERSION)
+
+    port = QSerialPort()
+    port.setPortName(args.port)
+    port.setBaudRate(args.baud)
+    port.setDataBits(QSerialPort.DataBits.Data8)
+    port.setParity(QSerialPort.Parity.NoParity)
+    port.setStopBits(QSerialPort.StopBits.OneStop)
+    if not port.open(QIODevice.OpenModeFlag.ReadWrite):
+        print(f"termora: cannot open {args.port}: {port.errorString()}", file=sys.stderr)
+        return 1
+
+    def on_ready() -> None:
+        data = bytes(port.readAll())
+        if data:
+            sys.stdout.buffer.write(data)
+            sys.stdout.buffer.flush()
+
+    port.readyRead.connect(on_ready)
+
+    if args.send:
+        payload = args.send.encode("utf-8", errors="replace")
+        if args.line_end == "crlf":
+            payload += b"\r\n"
+        elif args.line_end == "cr":
+            payload += b"\r"
+        elif args.line_end == "lf":
+            payload += b"\n"
+        port.write(payload)
+        port.flush()
+
+    if args.send_file:
+        path = Path(args.send_file)
+        if not path.is_file():
+            print(f"termora: file not found: {path}", file=sys.stderr)
+            port.close()
+            return 1
+        port.write(path.read_bytes())
+        port.flush()
+
+    deadline = time.monotonic() + max(0.0, args.timeout)
+    timer = QTimer()
+    timer.setInterval(50)
+
+    def tick() -> None:
+        if time.monotonic() >= deadline:
+            port.close()
+            app.quit()
+
+    timer.timeout.connect(tick)
+    timer.start()
+    return app.exec()
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = argparse.ArgumentParser(description=f"{APP_NAME} {VERSION}")
+    parser.add_argument("-s", "--session", default="", help="Open a named session")
+    parser.add_argument("--port", default="", help="Serial device (CLI)")
+    parser.add_argument("--baud", type=int, default=115200, help="Baud rate for --port")
+    parser.add_argument("--send", default="", help="Send a string after open")
+    parser.add_argument("--send-file", default="", help="Send a file after open")
+    parser.add_argument(
+        "--line-end",
+        choices=("none", "lf", "cr", "crlf"),
+        default="lf",
+        help="Line ending appended to --send (headless)",
+    )
+    parser.add_argument(
+        "--timeout",
+        type=float,
+        default=2.0,
+        help="Seconds to keep reading in headless mode before exit",
+    )
+    parser.add_argument(
+        "--headless",
+        action="store_true",
+        help="No GUI: open --port, send, print RX to stdout",
+    )
+    args = parser.parse_args(argv)
+
+    if args.headless:
+        if not args.port:
+            parser.error("--headless requires --port")
+        # 使用 QCoreApplication，不实例化 QWidget，适合脚本与管道场景。
+        return _run_headless(args)
+
+    app = QApplication(sys.argv if argv is None else [APP_NAME, *argv])
+    app.setOrganizationName(APP_ORG)
+    app.setApplicationName(APP_ID)
+    app.setApplicationDisplayName(APP_NAME)
+    app.setApplicationVersion(VERSION)
+    # 资源图标缺失时 isNull()，跳过 setWindowIcon 以免占位空图标。
+    icon = app_icon()
+    if not icon.isNull():
+        app.setWindowIcon(icon)
+
+    settings = AppSettings()
+    settings.read(args.session)
+    if args.port:
+        settings.update_session(device=args.port, baud_rate=args.baud)
+    app.setFont(ui_font(settings.language))
+    window = MainWindow(settings, args.session)
+    if args.port:
+        window.control.apply_session(settings.current_session())
+    window.show()
+    if args.port:
+        QTimer.singleShot(0, window.open_device)
+        # 延迟发送，等待 open_device 完成后再写串口。
+        if args.send_file:
+            def _send_file_later() -> None:
+                path = Path(args.send_file)
+                if path.is_file() and window.device.isOpen():
+                    window._write_bytes(path.read_bytes())
+
+            QTimer.singleShot(400, _send_file_later)
+        if args.send:
+            def _send_later() -> None:
+                if window.device.isOpen():
+                    window.input.setText(args.send)
+                    window.exec_cmd(clear_input=False)
+
+            QTimer.singleShot(400, _send_later)
+    return app.exec()
+
+if __name__ == "__main__":
+    raise SystemExit(main())

cutecom/can/__init__.py

@@ -0,0 +1,24 @@
+"""CAN 分析器公共导出：帧/过滤器类型与可选 python-can 后端封装。"""
+
+from cutecom.can.backend import (
+    BusStats,
+    CanBackendKind,
+    CanBusBackend,
+    CanConnectionConfig,
+    CanFilter,
+    CanFrame,
+    list_interfaces,
+)
+from cutecom.can.dbc_support import DbcDatabase, DecodedSignal
+
+__all__ = [
+    "BusStats",
+    "CanBackendKind",
+    "CanBusBackend",
+    "CanConnectionConfig",
+    "CanFilter",
+    "CanFrame",
+    "DbcDatabase",
+    "DecodedSignal",
+    "list_interfaces",
+]