Rozdział 23 · Część IV · Wdrażamy SafeSort

Dziennik wykonanych operacji

Każdy apply tworzy manifest JSON-, pokazujący, co naprawdę się wydarzyło – to jedyne źródło danych do cofnięcia.

Issue #7 · Project SafeSort Pierwsze wydanie

Record operation manifest

Area: SafetyPriority: Medium

git switch -c feat/manifest-and-undo

Każde udane połączenie apply pozostawia ślad — plik-manifest w formacie JSON, który opisuje, co dokładnie zostało wykonane. Bez tego dziennika polecenie undo, o którym będę mówić na następnej stronie, nie wiem Co dokładnie należy anulować.

{
  "operation_id": "20260824T011640800152",
  "root": "/home/anna/Downloads",
  "timestamp": "2026-08-24T01:16:40",
  "moves": [
    {
      "source": "/home/anna/Downloads/otchet.pdf",
      "destination": "/home/anna/Downloads/Sorted/documents/otchet.pdf",
      "completed": true,
      "error": null
    }
  ]
}

Ścieżka do manifestu — nieprzypadkowa: jest przewidywalnie tworzona od korzenia i identyfikatora operacji, a sam identyfikator — znacznik czasowy, sformatowany tak, aby porządek leksykograficzny zgadzał się z chronologicznym:

def new_operation_id() -> str:
    return datetime.now().strftime("%Y%m%dT%H%M%S%f")

def history_dir(root: Path) -> Path:
    return Path(root) / STATE_DIRNAME / "history"

Modele Path w programie musi zostać przekształcone w zwykłe łańcuch znaków do zapisu JSON, format, który nie ma typu „ścieżki”