Подготовить архив к отправке
Собирает аккуратный zip без служебного мусора и проверяет, что он не превышает лимит.
Что делает скрипт
Скрипт исключает кэши, временные файлы, .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.zippython prepare_for_send.py ./report report.zip --max-size 20Mpython prepare_for_send.py ./report report.zip --dry-run
Что понадобится
winget install Python.Python.3.12
brew install python
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.