Упаковать папку в zip
Собирает zip-архив из папки, сохраняет структуру и умеет исключать временные файлы.
Что делает скрипт
Скрипт обходит папку, пропускает символические ссылки и файлы по шаблонам исключений. Путь внутри архива строится относительно источника, поэтому распаковка возвращает привычное дерево. Существующий архив перезаписывается только с флагом --force, а режим --dry-run показывает список файлов без записи.
- Существующий архив перезаписывается только с флагом --force.
Быстрый старт
python create_zip.py ./project project.zip
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python create_zip.py ./project project.zippython create_zip.py ./project project.zip --exclude '*.log' --exclude '.git/*'python create_zip.py ./project project.zip --dry-run
Что понадобится
winget install Python.Python.3.12
brew install python
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.