Files
MDHelper/mdhelper/file_versions.py
T
shen 8dae91c2ca fix: protect editor content and harden document exports
Protect pending edits on window close, keep save-as paths and drafts consistent,
copy relative image resources, reject oversized table imports without truncation,
and preserve independent preview scrolling during refresh.

Archive rendered MHTML resources with portable references and embedded local
fonts. Preserve existing outputs on export cancellation or failure. Convert
editor match positions and filter directory results in linear passes.

Include the previously completed editor image/table/history improvements,
undoable replacement, export snapshots, shared page settings, and cancellable
PDF/Word export workflow. Update documentation and version to 0.3.1.

Validation: 142 pytest cases passed; GUI smoke, improvements integration, and
offline MHTML/scroll reliability smoke checks passed.
2026-10-29 18:22:42 +08:00

109 lines
4.5 KiB
Python

"""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