8dae91c2ca
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.
109 lines
4.5 KiB
Python
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
|