Архивы

Склеить части архива

Собирает файл из частей по manifest и проверяет размер и SHA-256 каждой части.

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

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

Скрипт читает manifest, проверяет, что все части лежат рядом с ним и не выходят за пределы папки. Каждая часть сверяется по размеру и хешу до записи, а итоговый файл проверяется ещё раз. При несовпадении временный файл удаляется, поэтому повреждённая копия не остаётся.

Перед запуском
  • Целевой файл перезаписывается только с флагом --force.
Запуск

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

python merge_parts.py ./parts/backup.zip.parts.json --output ./backup.zip

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

Примеры

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

  • python merge_parts.py ./parts/backup.zip.parts.json --output ./backup.zip
  • python merge_parts.py ./parts/backup.zip.parts.json
  • python merge_parts.py ./parts/backup.zip.parts.json --dry-run
Зависимости

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

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

merge_parts.py

#!/usr/bin/env python3
"""Склейка частей по manifest с проверкой хешей."""
from __future__ import annotations

import argparse
import hashlib
import json
import os
from pathlib import Path


def hash_file(path: Path) -> str:
    digest = hashlib.sha256()
    with path.open("rb") as handle:
        while chunk := handle.read(1024 * 1024):
            digest.update(chunk)
    return digest.hexdigest()


def main() -> int:
    parser = argparse.ArgumentParser(description="Склеить части файла")
    parser.add_argument("manifest", type=Path, help="Manifest от split_archive.py")
    parser.add_argument("--output", type=Path, help="Итоговый файл")
    parser.add_argument("--force", action="store_true", help="Перезаписать итоговый файл")
    parser.add_argument("--dry-run", action="store_true", help="Только проверить части")
    args = parser.parse_args()

    manifest_path = args.manifest.expanduser().resolve()
    if not manifest_path.is_file():
        parser.error(f"Manifest не найден: {manifest_path}")
    data = json.loads(manifest_path.read_text(encoding="utf-8"))
    for field in ("original", "size", "sha256", "parts"):
        if field not in data:
            parser.error(f"В manifest нет поля {field}")
    if not data["parts"]:
        parser.error("Manifest не содержит частей")

    base = manifest_path.parent
    output = (args.output or base / Path(data["original"]).name).expanduser().resolve()
    if output.exists() and not args.force:
        parser.error(f"Файл уже существует: {output}. Используйте --force")

    total = 0
    for part in data["parts"]:
        name = str(part.get("name", ""))
        part_path = (base / name).resolve()
        if not part_path.is_relative_to(base) or not part_path.is_file():
            parser.error(f"Часть не найдена или вне папки: {name}")
        if part_path.stat().st_size != int(part.get("size", -1)):
            parser.error(f"Размер части не совпал: {name}")
        total += part_path.stat().st_size
        if args.dry_run:
            print(f"OK: {name}")
            continue
        digest = hash_file(part_path)
        if digest != part.get("sha256"):
            parser.error(f"SHA-256 части не совпал: {name}")
        print(f"Проверено: {name}")

    if total != int(data["size"]):
        parser.error(f"Суммарный размер {total} не равен {data['size']}")
    if args.dry_run:
        print(f"Режим проверки: все {len(data['parts'])} частей на месте.")
        return 0

    temp = output.with_name(output.name + ".tmp")
    if temp.exists():
        parser.error(f"Временный файл уже существует: {temp}")
    digest = hashlib.sha256()
    try:
        with temp.open("wb") as target:
            for part in data["parts"]:
                part_path = base / part["name"]
                with part_path.open("rb") as source:
                    while chunk := source.read(1024 * 1024):
                        target.write(chunk)
                        digest.update(chunk)
        if temp.stat().st_size != int(data["size"]) or digest.hexdigest() != data["sha256"]:
            temp.unlink(missing_ok=True)
            print("Итоговый файл не прошёл проверку, временная копия удалена.")
            return 1
        os.replace(temp, output)
    except OSError:
        temp.unlink(missing_ok=True)
        raise

    print(f"Готово: {output} ({output.stat().st_size / 1024 / 1024:.1f} МБ)")
    return 0


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

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

CLI 1.0.0

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

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

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

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

Категория

Архивы

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