Архивы

Разбить архив на части

Делит большой файл на части заданного размера и создаёт manifest с хешами для склейки.

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

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

Скрипт читает файл блоками и пишет части с предсказуемыми именами. Для каждой части считается SHA-256, а итоговый manifest хранит исходное имя, размер, общий хеш и список частей. По умолчанию ничего не перезаписывается, а режим --dry-run показывает только план разбиения.

Перед запуском
  • Существующие части и manifest перезаписываются только с флагом --force.
Запуск

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

python split_archive.py backup.zip --size 100M --output-dir ./parts

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

Примеры

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

  • python split_archive.py backup.zip --size 100M --output-dir ./parts
  • python split_archive.py video.tar.zst --size 2G --prefix video.part
  • python split_archive.py backup.zip --size 50M --dry-run
Зависимости

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

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

split_archive.py

#!/usr/bin/env python3
"""Разбиение большого файла на части с manifest."""
from __future__ import annotations

import argparse
import hashlib
import json
import re
from datetime import datetime, timezone
from pathlib import Path


def parse_size(text: str) -> int:
    match = re.fullmatch(r"(\d+)([KMG]?)", text.strip().upper())
    if not match:
        raise argparse.ArgumentTypeError("Размер должен быть числом с суффиксом K, M или G")
    value = int(match.group(1))
    suffix = match.group(2)
    multiplier = {"": 1, "K": 1024, "M": 1024**2, "G": 1024**3}[suffix]
    result = value * multiplier
    if result < 1024:
        raise argparse.ArgumentTypeError("Минимальный размер части: 1K")
    return result


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("file", type=Path, help="Исходный файл")
    parser.add_argument("--size", required=True, type=parse_size, help="Размер части, например 100M")
    parser.add_argument("--output-dir", type=Path, help="Папка для частей")
    parser.add_argument("--prefix", help="Префикс имён частей")
    parser.add_argument("--force", action="store_true", help="Перезаписать существующие файлы")
    parser.add_argument("--dry-run", action="store_true", help="Только показать план")
    args = parser.parse_args()

    source = args.file.expanduser().resolve()
    if not source.is_file():
        parser.error(f"Файл не найден: {source}")
    output_dir = (args.output_dir or source.parent).expanduser().resolve()
    prefix = args.prefix or f"{source.name}.part"
    manifest_path = output_dir / f"{source.name}.parts.json"
    size = source.stat().st_size
    count = (size + args.size - 1) // args.size
    if count == 0:
        parser.error("Пустой файл не нужно разбивать")
    part_paths = [output_dir / f"{prefix}{index:03d}" for index in range(1, count + 1)]

    print(f"Файл: {source}")
    print(f"Размер: {size / 1024 / 1024:.1f} МБ, частей: {count} по {args.size / 1024 / 1024:.1f} МБ")

    if args.dry_run:
        for path in part_paths:
            print(f"  {path.name}")
        print("Режим проверки: файлы не созданы.")
        return 0

    output_dir.mkdir(parents=True, exist_ok=True)
    existing = [path for path in part_paths + [manifest_path] if path.exists()]
    if existing and not args.force:
        print("Файлы уже существуют, добавьте --force:")
        for path in existing:
            print(f"  {path}")
        return 1

    parts = []
    with source.open("rb") as handle:
        for index, part_path in enumerate(part_paths, 1):
            digest = hashlib.sha256()
            written = 0
            with part_path.open("wb") as part:
                while written < args.size:
                    chunk = handle.read(min(1024 * 1024, args.size - written))
                    if not chunk:
                        break
                    part.write(chunk)
                    digest.update(chunk)
                    written += len(chunk)
            parts.append({"name": part_path.name, "size": written, "sha256": digest.hexdigest()})
            print(f"  {part_path.name}: {written / 1024 / 1024:.1f} МБ")

    manifest = {
        "tool": "archives-split-archive",
        "created": datetime.now(timezone.utc).isoformat(timespec="seconds"),
        "original": source.name,
        "size": size,
        "sha256": hash_file(source),
        "part_size": args.size,
        "parts": parts,
    }
    manifest_path.write_text(json.dumps(manifest, ensure_ascii=False, indent=2), encoding="utf-8")
    print(f"Manifest: {manifest_path}")
    return 0


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

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

CLI 1.0.0

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

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

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

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

Категория

Архивы

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