Архивы

Подготовить архив к отправке

Собирает аккуратный zip без служебного мусора и проверяет, что он не превышает лимит.

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

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

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

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

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

python prepare_for_send.py ./report report.zip --max-size 20M

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

Примеры

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

  • python prepare_for_send.py ./report report.zip
  • python prepare_for_send.py ./report report.zip --max-size 20M
  • python prepare_for_send.py ./report report.zip --dry-run
Зависимости

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

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

prepare_for_send.py

#!/usr/bin/env python3
"""Подготовка zip к отправке с контролем размера."""
from __future__ import annotations

import argparse
import fnmatch
import hashlib
import re
import zipfile
from pathlib import Path

EXCLUDED_DIRS = {
    ".git", ".hg", ".svn", "node_modules", "__pycache__", ".pytest_cache",
    ".mypy_cache", ".ruff_cache", ".venv", "venv", ".idea", ".vscode", ".cache",
}
EXCLUDED_FILES = {".DS_Store", "Thumbs.db", "desktop.ini"}
EXCLUDED_PATTERNS = ["*.tmp", "*.temp", "*.swp", "*.swo", "*~", "*.pyc", "*.pyo"]


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


def excluded(relative: str, extra: list[str]) -> bool:
    parts = Path(relative).parts
    if any(part in EXCLUDED_DIRS for part in parts):
        return True
    name = parts[-1] if parts else relative
    if name in EXCLUDED_FILES:
        return True
    patterns = EXCLUDED_PATTERNS + extra
    return any(fnmatch.fnmatch(relative, pattern) or fnmatch.fnmatch(name, pattern) for pattern in patterns)


def main() -> int:
    parser = argparse.ArgumentParser(description="Подготовить архив к отправке")
    parser.add_argument("source", type=Path, help="Папка для упаковки")
    parser.add_argument("output", type=Path, help="Имя zip-файла")
    parser.add_argument("--max-size", type=parse_size, default=20 * 1024 * 1024, help="Лимит размера архива")
    parser.add_argument("--exclude", action="append", default=[], help="Дополнительный шаблон исключения")
    parser.add_argument("--allow-oversize", action="store_true", help="Не считать превышение ошибкой")
    parser.add_argument("--force", action="store_true", help="Перезаписать архив")
    parser.add_argument("--dry-run", action="store_true", help="Только показать план")
    args = parser.parse_args()

    source = args.source.expanduser().resolve()
    output = args.output.expanduser().resolve()
    if not source.is_dir():
        parser.error(f"Папка не найдена: {source}")
    if output.exists() and not args.force:
        parser.error(f"Файл уже существует: {output}. Используйте --force")

    files: list[tuple[Path, str]] = []
    for path in sorted(source.rglob("*")):
        if not path.is_file() or path.is_symlink():
            continue
        relative = path.relative_to(source).as_posix()
        if excluded(relative, args.exclude):
            continue
        if path.resolve() == output:
            continue
        files.append((path, relative))

    if not files:
        print("После исключений не осталось файлов.")
        return 1
    total = sum(path.stat().st_size for path, _ in files)
    print(f"Файлов: {len(files)}, исходный размер: {total / 1024 / 1024:.1f} МБ, лимит: {args.max_size / 1024 / 1024:.1f} МБ")
    if args.dry_run:
        for _, relative in files:
            print(f"  {relative}")
        print("Режим проверки: архив не создан.")
        return 0

    output.parent.mkdir(parents=True, exist_ok=True)
    with zipfile.ZipFile(output, "w", compression=zipfile.ZIP_DEFLATED, compresslevel=9) as archive:
        for path, relative in files:
            archive.write(path, arcname=f"{source.name}/{relative}")

    digest = hashlib.sha256()
    with output.open("rb") as handle:
        while chunk := handle.read(1024 * 1024):
            digest.update(chunk)
    size = output.stat().st_size
    print(f"Готово: {output} ({size / 1024 / 1024:.1f} МБ)")
    print(f"SHA-256: {digest.hexdigest()}")
    if size > args.max_size and not args.allow_oversize:
        print("Архив больше лимита. Разделите его через archives-split-archive.")
        return 1
    return 0


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

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

CLI 1.0.0

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

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

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

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

Категория

Архивы

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