Method rollback

openkb/mutation.py:203–232

(self)

            self.write_journal("active")

    def rollback(self) -> None:
        # Restore children before parents so directory deletes cannot remove
        # paths that still need to be restored from a more specific backup.
        for target, backup in sorted(
            self.entries.items(),
            key=lambda item: len(item[0].parts),
            reverse=True,
        ):
            # A hardlinked dir backup supports an O(touched) inode-diff restore
            # (leave untouched shared-inode files, only touch changed ones) —
            # do NOT rmtree it first, which would discard those shared inodes.
            if target.is_dir() and target in self.hardlinked_dirs:
                if backup is not None and backup.is_dir():
                    _restore_hardlinked_dir(backup, target)
                else:
                    shutil.rmtree(target, ignore_errors=True)  # new dir, no backup
                continue
            # Non-hardlinked (file, or copied dir): unconditional remove + restore.
            if target.is_dir():
                shutil.rmtree(target, ignore_errors=True)
            else:
                target.unlink(missing_ok=True)
            if backup is None:
                continue
            target.parent.mkdir(parents=True, exist_ok=True)
            if backup.is_dir():
                shutil.copytree(backup, target)
            else:
                _copy_file_atomic(backup, target)
        self.write_journal("rolled_back")

    def rollback_best_effort(self) -> Exception | None:
        try: