Архивы

Проверить целостность архива

Читает zip или tar целиком и показывает повреждённые файлы без распаковки на диск.

Python Windows macOS Linux Новичок
Скачать check_integrity.py
Описание

Что делает скрипт

Скрипт определяет формат по содержимому, а не только по расширению. Для zip вызывается встроенная проверка CRC, для tar каждый файл читается потоком и сверяется с заявленным размером. Архив не распаковывается, поэтому проверку можно запускать на больших копиях и в каталогах только для чтения.

Запуск

Быстрый старт

python check_integrity.py backup.zip

Скачайте файл, откройте терминал в папке со скриптом и выполните команду. В Linux и macOS интерпретатор может называться python3, в Windows - python или py.

Примеры

Другие варианты

  • python check_integrity.py backup.zip
  • python check_integrity.py project.tar.gz
  • python check_integrity.py backup.zip --json report.json
Зависимости

Что понадобится

Python 3.10+ Только стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux sudo apt install python3
Исходник

check_integrity.py

#!/usr/bin/env python3
"""Проверка целостности zip и tar без распаковки."""
from __future__ import annotations

import argparse
import json
import tarfile
import zipfile
from pathlib import Path


def check_zip(path: Path) -> dict:
    result = {"format": "zip", "status": "ok", "files": 0, "bytes": 0, "errors": []}
    try:
        with zipfile.ZipFile(path) as archive:
            infos = archive.infolist()
            result["files"] = sum(1 for info in infos if not info.is_dir())
            result["bytes"] = sum(info.file_size for info in infos if not info.is_dir())
            encrypted = [info.filename for info in infos if info.flag_bits & 0x1]
            if encrypted:
                result["encrypted"] = len(encrypted)
                result["status"] = "partial"
                result["errors"].append(f"Зашифрованных файлов: {len(encrypted)}, CRC не проверен")
            bad = archive.testzip()
            if bad is not None:
                result["status"] = "error"
                result["errors"].append(f"Повреждён файл: {bad}")
    except (zipfile.BadZipFile, OSError, RuntimeError) as error:
        result["status"] = "error"
        result["errors"].append(str(error))
    return result


def check_tar(path: Path) -> dict:
    result = {"format": "tar", "status": "ok", "files": 0, "bytes": 0, "errors": []}
    try:
        with tarfile.open(path, mode="r:*") as archive:
            for member in archive:
                if not member.isfile():
                    continue
                result["files"] += 1
                handle = archive.extractfile(member)
                if handle is None:
                    result["errors"].append(f"Не читается: {member.name}")
                    continue
                read = 0
                while True:
                    chunk = handle.read(1024 * 1024)
                    if not chunk:
                        break
                    read += len(chunk)
                result["bytes"] += read
                if read != member.size:
                    result["status"] = "error"
                    result["errors"].append(f"Размер не совпал: {member.name} ({read} вместо {member.size})")
    except (tarfile.TarError, OSError, EOFError) as error:
        result["status"] = "error"
        result["errors"].append(str(error))
    return result


def main() -> int:
    parser = argparse.ArgumentParser(description="Проверить целостность zip или tar")
    parser.add_argument("archive", type=Path, help="Проверяемый архив")
    parser.add_argument("--json", type=Path, help="Сохранить отчёт в JSON")
    args = parser.parse_args()

    path = args.archive.expanduser().resolve()
    if not path.is_file():
        parser.error(f"Файл не найден: {path}")
    if path.suffix.lower() == ".7z":
        print("Для 7z используйте: 7z t archive.7z")
        return 2

    if zipfile.is_zipfile(path):
        result = check_zip(path)
    elif tarfile.is_tarfile(path):
        result = check_tar(path)
    else:
        print("Формат не распознан. Поддерживаются zip и tar с сжатием.")
        return 2

    for message in result["errors"]:
        print(f"Ошибка: {message}")
    print(f"Формат: {result['format']}, файлов: {result['files']}, размер: {result['bytes'] / 1024 / 1024:.1f} МБ")
    print("Результат:", "OK" if result["status"] == "ok" else result["status"])

    if args.json:
        args.json.write_text(json.dumps(result, ensure_ascii=False, indent=2), encoding="utf-8")
    return 0 if result["status"] == "ok" else 1


if __name__ == "__main__":
    raise SystemExit(main())

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get archives-check-integrity
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Архивы

Упаковка, распаковка, проверка целостности и безопасная работа с архивами.