repdf 0.0.8__py3-none-any.whl

repdf/renderer.py

@@ -0,0 +1,169 @@
+from __future__ import annotations
+
+from repdf.strings import tr
+
+import json
+import secrets
+import socket
+import subprocess
+import sys
+import threading
+from collections import OrderedDict
+from pathlib import Path
+from typing import TextIO
+
+from PySide6.QtCore import QObject, Signal
+
+
+def start_render_backend() -> subprocess.Popen[str]:
+    if getattr(sys, "frozen", False):
+        return _start_frozen_backend()
+    creation_flags = subprocess.CREATE_NO_WINDOW if sys.platform == "win32" else 0
+    process = subprocess.Popen(
+        [sys.executable, "-m", "repdf.render_worker", "--server"],
+        stdin=subprocess.PIPE,
+        stdout=subprocess.PIPE,
+        stderr=subprocess.PIPE,
+        text=True,
+        encoding="utf-8",
+        bufsize=1,
+        creationflags=creation_flags,
+    )
+    assert process.stdout is not None
+    ready_line = process.stdout.readline()
+    try:
+        ready = json.loads(ready_line)
+    except json.JSONDecodeError as exc:
+        process.terminate()
+        raise RuntimeError(tr('無法啟動 PDF 預覽後端。')) from exc
+    if ready.get("type") != "ready":
+        process.terminate()
+        raise RuntimeError(tr('PDF 預覽後端未正確啟動。'))
+    return process
+
+
+def _start_frozen_backend() -> subprocess.Popen[str]:
+    # Windowed executables have no stdin/stdout; use an authenticated local socket.
+    token = secrets.token_hex(32)
+    with socket.socket() as listener:
+        listener.bind(("127.0.0.1", 0))
+        listener.listen(1)
+        listener.settimeout(30)
+        port = listener.getsockname()[1]
+        flags = subprocess.CREATE_NO_WINDOW if sys.platform == "win32" else 0
+        process = subprocess.Popen(
+            [sys.executable, "--render-server", str(port), token],
+            stdin=subprocess.DEVNULL,
+            stdout=subprocess.DEVNULL,
+            stderr=subprocess.DEVNULL,
+            creationflags=flags,
+        )
+        try:
+            connection, _address = listener.accept()
+            with connection:
+                connection.settimeout(30)
+                process.stdin = connection.makefile("w", encoding="utf-8")
+                process.stdout = connection.makefile("r", encoding="utf-8")
+                ready = json.loads(process.stdout.readline())
+                if ready.get("type") != "ready" or ready.get("token") != token:
+                    raise RuntimeError(tr('PDF 預覽後端驗證失敗。'))
+                connection.settimeout(None)
+            return process
+        except Exception as exc:
+            process.terminate()
+            process.wait(timeout=5)
+            for stream in (process.stdin, process.stdout):
+                if stream is not None:
+                    stream.close()
+            raise RuntimeError(tr('無法啟動封裝版 PDF 預覽後端。')) from exc
+
+
+class RenderService(QObject):
+    message = Signal(object)
+
+    def __init__(self, process: subprocess.Popen[str], parent: QObject | None = None) -> None:
+        super().__init__(parent)
+        self.process = process
+        self._lock = threading.Lock()
+        self._busy = False
+        self._pending: OrderedDict[int, dict[str, object]] = OrderedDict()
+        self._closed = False
+        self._reader = threading.Thread(target=self._read_loop, daemon=True)
+        self._reader.start()
+
+    def request(
+        self, source: Path, scale: float, output_dir: Path, generation: int,
+        *, document_id: int = 0,
+    ) -> None:
+        payload: dict[str, object] = {
+            "source": str(source),
+            "scale": scale,
+            "output_dir": str(output_dir),
+            "generation": generation,
+        }
+        with self._lock:
+            if self._closed:
+                return
+            self._pending[document_id] = payload
+            self._pending.move_to_end(document_id, last=False)
+            self._start_next()
+
+    def cancel_pending(self, document_id: int) -> None:
+        with self._lock:
+            self._pending.pop(document_id, None)
+
+    def prioritize(self, document_id: int) -> None:
+        with self._lock:
+            if document_id in self._pending:
+                self._pending.move_to_end(document_id, last=False)
+
+    def _start_next(self) -> None:
+        while self._pending and not self._busy and not self._closed:
+            _, payload = self._pending.popitem(last=False)
+            self._busy = self._write(payload)
+
+    def _write(self, payload: dict[str, object]) -> bool:
+        stream = self.process.stdin
+        if stream is None or self.process.poll() is not None:
+            self.message.emit({
+                "type": "error", "generation": payload["generation"],
+                "message": tr('PDF 預覽後端已停止。'),
+            })
+            return False
+        try:
+            stream.write(json.dumps(payload) + "\n")
+            stream.flush()
+            return True
+        except (OSError, ValueError) as exc:
+            self.message.emit({"type": "error", "generation": payload["generation"],
+                               "message": str(exc)})
+            return False
+
+    def _read_loop(self) -> None:
+        stream: TextIO | None = self.process.stdout
+        if stream is None:
+            return
+        for line in stream:
+            try:
+                payload = json.loads(line)
+            except json.JSONDecodeError:
+                continue
+            self.message.emit(payload)
+            if payload.get("type") in {"done", "error"}:
+                with self._lock:
+                    self._busy = False
+                    self._start_next()
+
+    def close(self) -> None:
+        with self._lock:
+            self._closed = True
+            self._pending.clear()
+        if self.process.poll() is None:
+            self.process.terminate()
+            try:
+                self.process.wait(timeout=2)
+            except subprocess.TimeoutExpired:
+                self.process.kill()
+        for stream in (self.process.stdin, self.process.stdout, self.process.stderr):
+            if stream is not None:
+                stream.close()

repdf/strings.py

@@ -0,0 +1,107 @@
+"""UI translations shared by the GUI and background error messages."""
+
+import re
+from string import Formatter
+
+LANGUAGE = "zh"
+ENGLISH = {
+    "勾選此檔案以加入重組或拆分；未勾選任何標籤時僅輸出目前檔案": "Include this file in merge or split; if no tabs are checked, use only the current file",
+    "關閉此檔案": "Close this file",
+    "正在讀取 PDF…": "Reading PDF…",
+    "已調整第 {p0} 頁的預覽與輸出順序": "Updated the preview and output order of page {p0}",
+    "正在產生頁面預覽…": "Rendering page previews…",
+    "已載入 {p0} 頁；已選取 {p1} 頁": "Loaded {p0} pages; {p1} selected",
+    "部分頁面無法產生預覽": "Some page previews could not be rendered",
+    "預覽失敗": "Preview failed",
+    "無法完成頁面預覽：\n{p0}": "Could not render page previews:\n{p0}",
+    "請先開啟 PDF 檔案，或將多個 PDF 拖曳到視窗": "Open PDF files, or drag PDFs into this window",
+    "就緒": "Ready",
+    "檔案與顯示": "Files and display",
+    "開啟 PDF": "Open PDF",
+    "開啟 PDF（Ctrl+O）": "Open PDF (Ctrl+O)",
+    "輸出選取頁面": "Merge selected pages",
+    "輸出選取頁面為新 PDF（Ctrl+S / Ctrl+Shift+S）": "Merge selected pages into a new PDF (Ctrl+S / Ctrl+Shift+S)",
+    "拆分選取頁面": "Split selected pages",
+    "拆分選取頁面：依目前順序存成單頁 PDF，檔名附加補零序號": "Split selected pages into individual PDFs in the current order, with zero-padded file numbers",
+    "單數頁": "Odd pages",
+    "雙數頁": "Even pages",
+    "選取或取消原始頁碼的單數頁": "Select or deselect odd source page numbers in the current tab",
+    "選取或取消原始頁碼的雙數頁": "Select or deselect even source page numbers in the current tab",
+    "縮小": "Zoom out",
+    "縮小（Ctrl+-）": "Zoom out (Ctrl+-)",
+    "頁面顯示比例": "Page zoom",
+    "100% 以 96 DPI 顯示 PDF 頁面": "100% displays PDF pages at 96 DPI",
+    "放大": "Zoom in",
+    "放大（Ctrl++ / Ctrl+=）": "Zoom in (Ctrl++ / Ctrl+=)",
+    "頁面顯示比例：25%–200%\n拖曳右側滑桿調整比例。\n放大：Ctrl++ 或 Ctrl+=（每次增加 25 個百分點）\n縮小：Ctrl+-（每次減少 25 個百分點）\n回到 100%：點擊比例或按 Ctrl+0\n100% 以 96 DPI 顯示 PDF 頁面。": "Page zoom: 25%–200%\nDrag the slider on the right to adjust zoom.\nZoom in: Ctrl++ or Ctrl+= (25 percentage points per step)\nZoom out: Ctrl+- (25 percentage points per step)\nReset to 100%: click the percentage or press Ctrl+0\n100% displays PDF pages at 96 DPI.",
+    "repdf — PDF 選頁重組工具 {p0} 版": "repdf {p0}",
+    "目前檔案：已選取 {p0} / {p1} 頁；輸出合計 {p2} 頁": "Current file: {p0} / {p1} pages selected; {p2} pages in output",
+    "PDF 檔案 (*.pdf)": "PDF files (*.pdf)",
+    "部分 PDF 無法開啟": "Some PDFs could not be opened",
+    "拆分選取頁面：指定檔名，將自動附加序號": "Split selected pages: choose a base filename; numbers will be appended",
+    "無法輸出": "Cannot export",
+    "輸出檔案不可覆蓋來源 PDF。": "Output files must not overwrite a source PDF.",
+    "覆蓋單頁檔案": "Overwrite single-page files",
+    "已有 {p0} 個同名單頁檔案，例如：\n{p1}\n\n是否覆蓋？": "{p0} single-page files already exist, for example:\n{p1}\n\nOverwrite them?",
+    "正在拆分單頁 PDF…": "Exporting single-page PDFs…",
+    "正在輸出 PDF…": "Exporting PDF…",
+    "輸出完成：{p0}": "Export complete: {p0}",
+    "已拆分為 {p0} 個單頁 PDF：\n{p1}": "Exported {p0} single-page PDFs:\n{p1}",
+    "已輸出 {p0} 頁至：\n{p1}": "Exported {p0} pages to:\n{p1}",
+    "輸出完成": "Export complete",
+    "輸出失敗": "Export failed",
+    "repdf — PDF 選頁重組工具": "repdf",
+    "拖曳到另一頁可調整順序": "Drag to another page to change the order",
+    "第 {p0} 頁": "Page {p0}",
+    "☰ 拖曳排序": "☰ Reorder",
+    "載入中…": "Loading…",
+    "無法產生預覽": "Preview unavailable",
+    "找不到來源 PDF 檔案：{p0}": "Source PDF not found: {p0}",
+    "目前不支援密碼保護的 PDF：{p0}": "Password-protected PDFs are not supported: {p0}",
+    "選取的頁碼超出來源 PDF 範圍：{p0}": "Selected page numbers are outside the source PDF: {p0}",
+    "請至少選取一頁。": "Select at least one page.",
+    "部分單頁檔案已存在，請確認覆蓋或更換檔名。": "Some single-page files already exist. Confirm overwrite or choose another filename.",
+    "拆分輸出失敗；已完成 {p0} / {p1} 個檔案。\n{p2}": "Split export failed; {p0} / {p1} files completed.\n{p2}",
+    "找不到來源 PDF 檔案。": "Source PDF not found.",
+    "目前不支援密碼保護的 PDF。": "Password-protected PDFs are not supported.",
+    "無法讀取這個 PDF，檔案可能已損壞或格式不受支援。": "Could not read this PDF. It may be damaged or use an unsupported format.",
+    "這個 PDF 沒有可用的頁面。": "This PDF has no pages.",
+    "無法啟動 PDF 預覽後端。": "Could not start the PDF preview backend.",
+    "PDF 預覽後端未正確啟動。": "The PDF preview backend did not start correctly.",
+    "PDF 預覽後端驗證失敗。": "PDF preview backend authentication failed.",
+    "無法啟動封裝版 PDF 預覽後端。": "Could not start the packaged PDF preview backend.",
+    "PDF 預覽後端已停止。": "The PDF preview backend has stopped.",
+    "跟隨系統": "Follow system",
+    "中文": "Chinese",
+    "淺色": "Light",
+    "深色": "Dark",
+    "介面語言": "Interface language",
+    "介面配色": "Color theme",
+    "介面語言：{mode}（目前：{language}）\n點擊依序切換：跟隨系統 → 中文 → English": "Interface language: {mode} (current: {language})\nClick to cycle: Follow system → Chinese → English",
+    "介面配色：{mode}\n點擊依序切換：跟隨系統 → 淺色 → 深色": "Color theme: {mode}\nClick to cycle: Follow system → Light → Dark",
+}
+
+
+def tr(source: str, **values) -> str:
+    return (ENGLISH.get(source, source) if LANGUAGE == "en" else source).format(**values)
+
+
+def _pattern(template):
+    parts = []
+    for literal, field, _, _ in Formatter().parse(template):
+        parts.append(re.escape(literal))
+        if field is not None:
+            parts.append(f"(?P<{field}>.*?)")
+    return re.compile("".join(parts), re.DOTALL)
+
+
+_PATTERNS = [(zh, en, _pattern(zh), _pattern(en)) for zh, en in ENGLISH.items()]
+
+
+def localize_text(text: str) -> str:
+    """Retranslate existing text without changing filenames or user-provided values."""
+    for zh, en, zh_pattern, en_pattern in _PATTERNS:
+        match = zh_pattern.fullmatch(text) or en_pattern.fullmatch(text)
+        if match:
+            return (en if LANGUAGE == "en" else zh).format(**match.groupdict())
+    return text

repdf/theme.py

@@ -0,0 +1,134 @@
+from __future__ import annotations
+
+from importlib.resources import files
+
+from PySide6.QtCore import QObject, Qt, Slot
+from PySide6.QtGui import QColor, QGuiApplication, QPalette
+from PySide6.QtWidgets import QApplication
+
+
+class ThemeController(QObject):
+    def __init__(self, app: QApplication, mode: str = "system", parent=None) -> None:
+        super().__init__(parent or app)
+        self.app = app
+        self.mode = mode if mode in {"system", "light", "dark"} else "system"
+        hints = QGuiApplication.styleHints()
+        if hasattr(hints, "colorSchemeChanged"):
+            hints.colorSchemeChanged.connect(self.apply)
+        self.apply()
+
+    def set_mode(self, mode: str) -> None:
+        if mode not in {"system", "light", "dark"}:
+            raise ValueError(mode)
+        self.mode = mode
+        self.apply()
+
+    @Slot()
+    def apply(self, *_args: object) -> None:
+        scheme = QGuiApplication.styleHints().colorScheme()
+        dark = self.mode == "dark" or (self.mode == "system" and scheme == Qt.ColorScheme.Dark)
+        palette = QPalette()
+        colors = (
+            {
+                QPalette.ColorRole.Window: "#202124",
+                QPalette.ColorRole.WindowText: "#f1f3f4",
+                QPalette.ColorRole.Base: "#17181a",
+                QPalette.ColorRole.AlternateBase: "#292a2d",
+                QPalette.ColorRole.Text: "#f1f3f4",
+                QPalette.ColorRole.Button: "#303134",
+                QPalette.ColorRole.ButtonText: "#f1f3f4",
+                QPalette.ColorRole.Highlight: "#8ab4f8",
+                QPalette.ColorRole.HighlightedText: "#202124",
+                QPalette.ColorRole.PlaceholderText: "#9aa0a6",
+            }
+            if dark
+            else {
+                QPalette.ColorRole.Window: "#f5f6f8",
+                QPalette.ColorRole.WindowText: "#202124",
+                QPalette.ColorRole.Base: "#ffffff",
+                QPalette.ColorRole.AlternateBase: "#eef0f3",
+                QPalette.ColorRole.Text: "#202124",
+                QPalette.ColorRole.Button: "#ffffff",
+                QPalette.ColorRole.ButtonText: "#202124",
+                QPalette.ColorRole.Highlight: "#0b57d0",
+                QPalette.ColorRole.HighlightedText: "#ffffff",
+                QPalette.ColorRole.PlaceholderText: "#6f7378",
+            }
+        )
+        for role, color in colors.items():
+            palette.setColor(role, QColor(color))
+        palette.setColor(
+            QPalette.ColorGroup.Disabled,
+            QPalette.ColorRole.ButtonText,
+            QColor("#777b80" if dark else "#9aa0a6"),
+        )
+        self.app.setPalette(palette)
+        border = "#4a4d51" if dark else "#d5d8dc"
+        card = "#292a2d" if dark else "#ffffff"
+        slider_track = "#5f6368" if dark else "#c4c7c5"
+        slider_fill = "#8ab4f8" if dark else "#0b57d0"
+        slider_handle = "#aecbfa" if dark else "#0b57d0"
+        hover = "#35383d" if dark else "#e7ebf0"
+        pressed = "#41464e" if dark else "#d8e3f3"
+        disabled = "#777b80" if dark else "#9aa0a6"
+        check = files("repdf").joinpath("assets", "check.svg").as_posix()
+        partial = files("repdf").joinpath("assets", "partial.svg").as_posix()
+        self.app.setStyleSheet(
+            f"""
+            QFrame#pageCard {{ background: {card}; border: 1px solid {border};
+                               border-radius: 8px; }}
+            QFrame#pageCard QLabel, QFrame#pageCard QCheckBox {{ border: none; }}
+            QToolBar {{ background: palette(window); border: none;
+                        border-bottom: 1px solid {border}; padding: 4px 8px; spacing: 4px; }}
+            QToolBar::separator {{ background: {border}; width: 1px; margin: 5px 4px; }}
+            QTabWidget::pane {{ border: none; }}
+            QTabBar::tab {{ background: transparent; color: palette(window-text);
+                            border: none; border-bottom: 2px solid transparent;
+                            padding: 5px 8px; margin-right: 2px; }}
+            QTabBar::tab:selected {{ background: {card}; border-bottom-color: {slider_fill}; }}
+            QTabBar::tab:!selected:hover {{ background: {hover}; }}
+            QToolButton {{ background: transparent; border: 1px solid transparent;
+                           border-radius: 4px; padding: 4px; color: palette(button-text); }}
+            QToolButton:hover {{ background: {hover}; }}
+            QToolButton:pressed {{ background: {pressed}; }}
+            QToolButton:focus {{ border-color: {slider_fill}; }}
+            QToolButton:disabled {{ color: {disabled}; background: transparent; }}
+            QPushButton {{ background: {card}; color: palette(button-text);
+                           border: 1px solid {border}; border-radius: 5px;
+                           min-height: 30px; padding: 2px 12px; }}
+            QPushButton:hover {{ background: {hover}; border-color: {slider_fill}; }}
+            QPushButton:pressed {{ background: {pressed}; }}
+            QPushButton:focus {{ border-color: {slider_fill}; }}
+            QPushButton:disabled {{ color: {disabled}; }}
+            QCheckBox {{ spacing: 6px; }}
+            QCheckBox::indicator {{ width: 16px; height: 16px;
+                                    border: 1px solid {border}; border-radius: 3px;
+                                    background: {card}; }}
+            QCheckBox::indicator:hover {{ border-color: {slider_fill}; }}
+            QCheckBox::indicator:checked {{ background: #0b57d0; border-color: #0b57d0;
+                                            image: url("{check}"); }}
+            QCheckBox::indicator:indeterminate {{ background: #0b57d0; border-color: #0b57d0;
+                                                  image: url("{partial}"); }}
+            QCheckBox::indicator:disabled {{ background: {hover}; border-color: {border}; }}
+            QScrollArea {{ border: 1px solid {border}; border-radius: 6px; }}
+            QStatusBar {{ background: palette(window); border: none; }}
+            QStatusBar::item {{ border: none; }}
+            QScrollBar:vertical {{ background: transparent; width: 10px; margin: 2px; }}
+            QScrollBar:horizontal {{ background: transparent; height: 10px; margin: 2px; }}
+            QScrollBar::handle {{ background: {slider_track}; border-radius: 3px;
+                                 min-width: 24px; min-height: 24px; }}
+            QScrollBar::handle:hover {{ background: {slider_fill}; }}
+            QScrollBar::add-line, QScrollBar::sub-line {{ width: 0; height: 0; border: none; }}
+            QScrollBar::add-page, QScrollBar::sub-page {{ background: transparent; }}
+            QSlider::groove:horizontal {{ height: 2px; background: {slider_track};
+                                          border-radius: 1px; }}
+            QSlider::sub-page:horizontal {{ background: {slider_fill};
+                                            border-radius: 1px; }}
+            QSlider::add-page:horizontal {{ background: {slider_track};
+                                            border-radius: 1px; }}
+            QSlider::handle:horizontal {{ background: {slider_handle};
+                                          border: none;
+                                          border-radius: 5px; width: 10px;
+                                          margin: -4px 0; }}
+            """
+        )