"""Atomic writes and bounded, per-document local version history.""" from __future__ import annotations import hashlib import os import tempfile import time import uuid from pathlib import Path def atomic_write(path: Path, data: bytes) -> None: path = path.resolve() path.parent.mkdir(parents=True, exist_ok=True) descriptor, temporary = tempfile.mkstemp(prefix=f".{path.name}.", suffix=".tmp", dir=path.parent) try: with os.fdopen(descriptor, "wb") as stream: stream.write(data) stream.flush() os.fsync(stream.fileno()) os.replace(temporary, path) finally: Path(temporary).unlink(missing_ok=True) class VersionStore: def __init__(self, root: Path | None = None, limit: int = 20) -> None: base = Path(os.environ.get("LOCALAPPDATA", str(Path.home() / ".local" / "share"))) self.root = root or Path(os.environ.get("MDHELPER_HISTORY_DIR", str(base / "MDHelper" / "history"))) self.limit = max(1, limit) def directory(self, path: Path) -> Path: key = hashlib.sha256(os.path.normcase(str(path.resolve())).encode("utf-8")).hexdigest() return self.root / key def versions(self, path: Path) -> list[Path]: return sorted(self.directory(path).glob("*.md"), reverse=True) def save(self, path: Path, source: str) -> None: data = source.encode("utf-8") previous = path.read_bytes() if path.exists() else None if previous == data: return if previous is not None: versions = self.versions(path) if not versions or versions[0].read_bytes() != previous: name = time.strftime("%Y%m%d-%H%M%S") + f"-{time.time_ns() % 1_000_000_000:09d}-{uuid.uuid4().hex[:6]}.md" atomic_write(self.directory(path) / name, previous) # A failed replacement leaves the original file and its history intact. atomic_write(path, data) for expired in self.versions(path)[self.limit:]: try: expired.unlink() except OSError: pass # History housekeeping must not turn a successful save into a failure. def show_version_history(parent: object, path: Path, current: str) -> str | None: import difflib from PySide6.QtWidgets import (QDialog, QDialogButtonBox, QHBoxLayout, QLabel, QListWidget, QPlainTextEdit, QSplitter, QVBoxLayout) from PySide6.QtCore import Qt versions = VersionStore().versions(path) dialog = QDialog(parent) dialog.setWindowTitle(f"历史版本 — {path.name}") dialog.resize(1000, 650) layout = QVBoxLayout(dialog) layout.addWidget(QLabel("保留最近 20 个保存前版本。恢复只替换编辑区内容,可撤销;按保存后才写入原文件。")) splitter = QSplitter(Qt.Orientation.Horizontal) listing = QListWidget() preview = QPlainTextEdit() preview.setReadOnly(True) splitter.addWidget(listing) splitter.addWidget(preview) splitter.setSizes([240, 760]) layout.addWidget(splitter) buttons = QDialogButtonBox(QDialogButtonBox.StandardButton.Cancel) restore = buttons.addButton("恢复到编辑区", QDialogButtonBox.ButtonRole.AcceptRole) restore.setEnabled(False) buttons.accepted.connect(dialog.accept) buttons.rejected.connect(dialog.reject) layout.addWidget(buttons) contents: dict[int, str] = {} for version in versions: stamp = version.name[:15] listing.addItem(f"{stamp[:4]}-{stamp[4:6]}-{stamp[6:8]} {stamp[9:11]}:{stamp[11:13]}:{stamp[13:15]}") def selected(row: int) -> None: restore.setEnabled(False) if row < 0: return try: source = versions[row].read_text(encoding="utf-8-sig") contents[row] = source diff = "\n".join(difflib.unified_diff(current.splitlines(), source.splitlines(), fromfile="当前编辑内容", tofile="选中的历史版本", lineterm="")) preview.setPlainText(diff or "此版本与当前编辑内容相同。") restore.setEnabled(True) except (OSError, UnicodeError) as exc: preview.setPlainText(f"无法读取此版本:{exc}") listing.currentRowChanged.connect(selected) if versions: listing.setCurrentRow(0) else: preview.setPlainText("暂无历史版本。文件内容改变并保存后,会自动保留保存前的内容。") return contents.get(listing.currentRow()) if dialog.exec() == QDialog.DialogCode.Accepted else None