Проверить целостность архива
Читает zip или tar целиком и показывает повреждённые файлы без распаковки на диск.
Что делает скрипт
Скрипт определяет формат по содержимому, а не только по расширению. Для zip вызывается встроенная проверка CRC, для tar каждый файл читается потоком и сверяется с заявленным размером. Архив не распаковывается, поэтому проверку можно запускать на больших копиях и в каталогах только для чтения.
Быстрый старт
python check_integrity.py backup.zip
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python check_integrity.py backup.zippython check_integrity.py project.tar.gzpython check_integrity.py backup.zip --json report.json
Что понадобится
winget install Python.Python.3.12
brew install python
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.