#!/usr/bin/env python3 """Безопасное восстановление tar-архива в отдельную папку.""" from __future__ import annotations import argparse import hashlib import os import shutil import sys import tarfile from pathlib import Path def file_digest(path: Path, chunk_size: int = 1024 * 1024) -> str: digest = hashlib.sha256() with path.open("rb") as handle: while block := handle.read(chunk_size): digest.update(block) return digest.hexdigest() def check_member(member: tarfile.TarInfo) -> str: name = member.name.replace("\\", "/") if not name or name.startswith("/"): return "абсолютный путь" parts = Path(name).parts if any(part == ".." for part in parts): return "переход вверх" if member.issym() or member.islnk(): return "ссылка" if member.ischr() or member.isblk() or member.isfifo(): return "специальный файл" if not (member.isfile() or member.isdir()): return "неподдерживаемый тип" return "" def parse_manifest(path: Path) -> dict[str, str]: result: dict[str, str] = {} for raw_line in path.read_text(encoding="utf-8", errors="replace").splitlines(): line = raw_line.strip() if not line or line.startswith("#"): continue parts = line.split(None, 1) if len(parts) != 2: continue digest, name = parts result[name.lstrip("*").strip().lstrip("./")] = digest.lower() return result def main() -> int: parser = argparse.ArgumentParser(description="Восстановить tar-архив в новую папку") parser.add_argument("--archive", type=Path, required=True) parser.add_argument("--dest", type=Path, required=True) parser.add_argument("--manifest", type=Path) parser.add_argument("--dry-run", action="store_true") args = parser.parse_args() archive_path = args.archive.expanduser().resolve() dest = args.dest.expanduser().resolve() if not archive_path.is_file(): parser.error(f"Архив не найден: {archive_path}") if dest.exists() and not dest.is_dir(): parser.error(f"Назначение не является папкой: {dest}") if dest.is_dir() and any(dest.iterdir()): parser.error("Папка назначения должна быть пустой") expected = parse_manifest(args.manifest.expanduser().resolve()) if args.manifest else {} extracted = 0 skipped = 0 problems = 0 try: archive = tarfile.open(archive_path, "r:*") except tarfile.TarError as error: print(f"Не удалось открыть архив: {error}", file=sys.stderr) return 2 with archive: members = archive.getmembers() for member in members: reason = check_member(member) if reason: print(f"Пропуск {member.name}: {reason}", file=sys.stderr) problems += 1 continue target = dest / member.name try: target.relative_to(dest) except ValueError: print(f"Пропуск {member.name}: путь вне назначения", file=sys.stderr) problems += 1 continue if args.dry_run: print(f"Будет восстановлено: {member.name}") continue if member.isdir(): target.mkdir(parents=True, exist_ok=True) continue source = archive.extractfile(member) if source is None: problems += 1 continue target.parent.mkdir(parents=True, exist_ok=True) try: with target.open("xb") as handle: shutil.copyfileobj(source, handle) mode = member.mode & 0o777 if mode: target.chmod(mode) os.utime(target, (member.mtime, member.mtime)) extracted += 1 except OSError as error: problems += 1 print(f"Ошибка {member.name}: {error}", file=sys.stderr) if args.dry_run: print(f"Элементов: {len(members)}, проблем: {problems}") return 1 if problems else 0 if args.manifest: for relative, expected_digest in expected.items(): candidate = dest / relative if not candidate.is_file(): print(f"Нет файла из manifest: {relative}", file=sys.stderr) problems += 1 continue if file_digest(candidate) != expected_digest: print(f"Хеш не совпал: {relative}", file=sys.stderr) problems += 1 print(f"Восстановлено файлов: {extracted}, пропущено: {skipped}, проблем: {problems}") print(f"Папка: {dest}") return 1 if problems else 0 if __name__ == "__main__": sys.exit(main())