Архивы

Упаковать папку в zip

Собирает zip-архив из папки, сохраняет структуру и умеет исключать временные файлы.

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

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

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

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

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

python create_zip.py ./project project.zip

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

Примеры

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

  • python create_zip.py ./project project.zip
  • python create_zip.py ./project project.zip --exclude '*.log' --exclude '.git/*'
  • python create_zip.py ./project project.zip --dry-run
Зависимости

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

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

create_zip.py

#!/usr/bin/env python3
"""Упаковка папки в zip с исключениями."""
from __future__ import annotations

import argparse
import fnmatch
import zipfile
from pathlib import Path


def is_excluded(relative: str, patterns: list[str]) -> bool:
    name = Path(relative).name
    return any(
        fnmatch.fnmatch(relative, pattern) or fnmatch.fnmatch(name, pattern)
        for pattern in patterns
    )


def main() -> int:
    parser = argparse.ArgumentParser(description="Упаковать папку в zip")
    parser.add_argument("source", type=Path, help="Папка-источник")
    parser.add_argument("output", type=Path, help="Имя zip-файла")
    parser.add_argument("--exclude", action="append", default=[], help="Шаблон исключения, можно повторить")
    parser.add_argument("--level", type=int, choices=range(0, 10), default=6, help="Уровень сжатия 0-9")
    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")
    if source == output:
        parser.error("Архив не может совпадать с папкой")

    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 is_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} МБ")
    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=args.level) as archive:
        for path, relative in files:
            archive.write(path, arcname=relative)
    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-create-zip-folder
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

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

Категория

Архивы

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