128 lines
5.9 KiB
Python
128 lines
5.9 KiB
Python
"""Plan reference edits before mutating files; retain a recovery copy for each transaction."""
|
||
from __future__ import annotations
|
||
|
||
import difflib
|
||
import json
|
||
import os
|
||
import time
|
||
import uuid
|
||
from dataclasses import dataclass
|
||
from pathlib import Path
|
||
from urllib.parse import quote, urlsplit, urlunsplit
|
||
|
||
from .document_resources import analyze_document, apply_source_edits, resolve_local_reference
|
||
from .document_tree import discover_documents
|
||
from .file_versions import atomic_write
|
||
|
||
|
||
@dataclass
|
||
class RenamePlan:
|
||
source: Path
|
||
target: Path
|
||
originals: dict[Path, bytes]
|
||
replacements: dict[Path, bytes]
|
||
buffers: dict[Path, str]
|
||
changes: list[str]
|
||
|
||
|
||
def plan_rename(root: Path, source: Path, target: Path, buffers=None) -> RenamePlan:
|
||
root, source, target = root.resolve(), source.resolve(), target.resolve()
|
||
if not source.is_relative_to(root) or not target.is_relative_to(root):
|
||
raise ValueError("重命名目标必须位于当前项目内。")
|
||
if target.exists():
|
||
raise FileExistsError(target)
|
||
buffers = buffers or {}
|
||
originals = {source: source.read_bytes()}
|
||
replacements, snapshots, changes = {}, {}, []
|
||
for entry in discover_documents(root, ("markdown",)):
|
||
path = entry.path
|
||
raw = path.read_bytes()
|
||
text = buffers.get(path, raw.decode("utf-8-sig"))
|
||
new_path = target if path == source else path
|
||
edits = []
|
||
for reference in analyze_document(text).references:
|
||
resolved = resolve_local_reference(path, reference.url)
|
||
if resolved is None:
|
||
continue
|
||
moved = target if resolved == source else resolved
|
||
if moved == resolved and new_path.parent == path.parent:
|
||
continue
|
||
url = urlsplit(reference.url)
|
||
if url.scheme == "file":
|
||
new_url = urlsplit(moved.as_uri())._replace(query=url.query, fragment=url.fragment)
|
||
else:
|
||
relative = quote(Path(os.path.relpath(moved, new_path.parent)).as_posix(), safe="/.-_~")
|
||
new_url = url._replace(path=relative)
|
||
edits.append(reference.edit_url(urlunsplit(new_url)))
|
||
updated = apply_source_edits(text, edits)
|
||
if updated != text or (path == source and path in buffers):
|
||
originals[path] = raw
|
||
# Keep BOM and line endings when no editor snapshot replaces the source.
|
||
replacements[path] = (b"\xef\xbb\xbf" if raw.startswith(b"\xef\xbb\xbf") and path not in buffers else b"") + updated.encode("utf-8")
|
||
if path in buffers:
|
||
snapshots[path] = text
|
||
changes.append("".join(difflib.unified_diff(raw.decode("utf-8-sig").splitlines(True), updated.splitlines(True),
|
||
fromfile=str(path.relative_to(root)), tofile=str(new_path.relative_to(root)))))
|
||
return RenamePlan(source, target, originals, replacements, snapshots, changes)
|
||
|
||
|
||
def execute_rename(plan: RenamePlan, backup_root: Path | None = None) -> Path:
|
||
if plan.target.exists():
|
||
raise FileExistsError(plan.target)
|
||
for path, original in plan.originals.items():
|
||
if path.read_bytes() != original:
|
||
raise OSError(f"文件在预览后已变化,请重新重命名:{path.name}")
|
||
base = backup_root or Path(os.environ.get("LOCALAPPDATA", str(Path.home()))) / "MDHelper" / "rename-backups"
|
||
backup = base / (time.strftime("%Y%m%d-%H%M%S-") + uuid.uuid4().hex[:8])
|
||
manifest = {"source": str(plan.source), "target": str(plan.target), "files": {}}
|
||
for index, (path, original) in enumerate(plan.originals.items()):
|
||
name = f"{index}.bak"
|
||
atomic_write(backup / name, original)
|
||
manifest["files"][name] = str(path)
|
||
atomic_write(backup / "manifest.json", json.dumps(manifest, ensure_ascii=False, indent=2).encode("utf-8"))
|
||
written, renamed = [], False
|
||
try:
|
||
plan.source.rename(plan.target)
|
||
renamed = True
|
||
for path, data in plan.replacements.items():
|
||
destination = plan.target if path == plan.source else path
|
||
atomic_write(destination, data)
|
||
written.append(path)
|
||
except OSError as exc:
|
||
failures = []
|
||
for path in reversed(written):
|
||
try:
|
||
atomic_write(plan.target if path == plan.source else path, plan.originals[path])
|
||
except OSError as rollback_error:
|
||
failures.append(str(rollback_error))
|
||
if renamed:
|
||
try:
|
||
plan.target.rename(plan.source)
|
||
except OSError as rollback_error:
|
||
failures.append(str(rollback_error))
|
||
if failures:
|
||
raise OSError(f"重命名失败,自动恢复未完全成功。备份位于 {backup}:{';'.join(failures)}") from exc
|
||
raise OSError(f"重命名失败,文件已恢复。备份位于 {backup}:{exc}") from exc
|
||
return backup
|
||
|
||
|
||
def confirm_rename(parent, plan: RenamePlan) -> bool:
|
||
if not plan.replacements:
|
||
return True
|
||
from PySide6.QtWidgets import QDialog, QDialogButtonBox, QLabel, QPlainTextEdit, QVBoxLayout
|
||
dialog = QDialog(parent)
|
||
dialog.setWindowTitle("重命名并更新引用")
|
||
dialog.resize(950, 620)
|
||
layout = QVBoxLayout(dialog)
|
||
layout.addWidget(QLabel(f"{plan.source.name} → {plan.target.name}\n将更新 {len(plan.replacements)} 个文件;包含相关编辑器的未保存内容。操作前自动备份,失败时恢复。"))
|
||
preview = QPlainTextEdit()
|
||
preview.setReadOnly(True)
|
||
preview.setPlainText("\n".join(plan.changes))
|
||
layout.addWidget(preview)
|
||
buttons = QDialogButtonBox(QDialogButtonBox.StandardButton.Cancel)
|
||
buttons.addButton("重命名并保存上述更改", QDialogButtonBox.ButtonRole.AcceptRole)
|
||
buttons.accepted.connect(dialog.accept)
|
||
buttons.rejected.connect(dialog.reject)
|
||
layout.addWidget(buttons)
|
||
return dialog.exec() == QDialog.DialogCode.Accepted
|