#!/usr/bin/env python3 """Безопасная распаковка zip.""" from __future__ import annotations import argparse import os import shutil import stat import zipfile from pathlib import Path, PurePosixPath, PureWindowsPath def safe_parts(name: str) -> tuple[str, ...]: normalized = name.replace("\\", "/") path = PurePosixPath(normalized) if path.is_absolute() or PureWindowsPath(normalized).drive: raise ValueError(f"абсолютный путь: {name}") parts = tuple(part for part in path.parts if part not in ("", ".")) if not parts: raise ValueError(f"пустое имя: {name!r}") if any(part == ".." for part in parts): raise ValueError(f"выход из папки: {name}") return parts def is_symlink(info: zipfile.ZipInfo) -> bool: mode = (info.external_attr >> 16) & 0o170000 return mode == stat.S_IFLNK def main() -> int: parser = argparse.ArgumentParser(description="Безопасно распаковать zip") parser.add_argument("archive", type=Path, help="Zip-архив") parser.add_argument("destination", type=Path, help="Папка для распаковки") parser.add_argument("--force", action="store_true", help="Перезаписать существующие файлы") parser.add_argument("--dry-run", action="store_true", help="Только проверить и показать план") args = parser.parse_args() archive_path = args.archive.expanduser().resolve() destination = args.destination.expanduser().resolve() if not archive_path.is_file(): parser.error(f"Архив не найден: {archive_path}") if destination.exists() and not destination.is_dir(): parser.error(f"Цель не является папкой: {destination}") with zipfile.ZipFile(archive_path) as archive: plan: list[tuple[zipfile.ZipInfo, Path]] = [] errors: list[str] = [] skipped: list[str] = [] for info in archive.infolist(): try: parts = safe_parts(info.filename) except ValueError as error: errors.append(str(error)) continue if info.flag_bits & 0x1: skipped.append(f"{info.filename}: зашифрован") continue if is_symlink(info): skipped.append(f"{info.filename}: символическая ссылка") continue target = destination.joinpath(*parts) if not target.resolve().is_relative_to(destination.resolve()): errors.append(f"путь вне папки: {info.filename}") continue plan.append((info, target)) if errors: print("Распаковка отменена, найдены небезопасные элементы:") for error in errors: print(f" {error}") return 2 for name in skipped: print(f"Пропуск: {name}") existing = [str(target) for _, target in plan if target.exists() and not target.is_dir()] if existing and not args.force: print("Эти файлы уже существуют, используйте --force:") for name in existing: print(f" {name}") return 1 if args.dry_run: for info, target in plan: kind = "папка" if info.is_dir() else "файл" print(f"{kind}: {target.relative_to(destination)}") print("Режим проверки: ничего не записано.") return 0 destination.mkdir(parents=True, exist_ok=True) files = 0 for info, target in plan: if info.is_dir(): target.mkdir(parents=True, exist_ok=True) continue target.parent.mkdir(parents=True, exist_ok=True) with archive.open(info) as source, target.open("wb") as handle: shutil.copyfileobj(source, handle) try: mode = (info.external_attr >> 16) & 0o777 if mode: os.chmod(target, mode) except OSError: pass files += 1 print(f"Распаковано файлов: {files} в {destination}") return 0 if __name__ == "__main__": raise SystemExit(main())