Архивы

Архивировать проект

Собирает zip проекта без .git, кэшей, виртуальных окружений и каталогов сборки.

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

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

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

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

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

python archive_project.py ./my-project project.zip

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

Примеры

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

  • python archive_project.py ./my-project project.zip
  • python archive_project.py ./my-project project.zip --exclude '*.log' --exclude 'docs/tmp/*'
  • python archive_project.py ./my-project project.zip --dry-run
Зависимости

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

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

archive_project.py

#!/usr/bin/env python3
"""Архивация проекта с типовыми исключениями."""
from __future__ import annotations

import argparse
import fnmatch
import zipfile
from pathlib import Path

EXCLUDED_DIRS = {
    ".git", ".hg", ".svn", "node_modules", "__pycache__", ".pytest_cache",
    ".mypy_cache", ".ruff_cache", ".tox", ".venv", "venv", "env", "dist",
    "build", "target", "out", ".next", ".nuxt", "coverage", ".cache",
    ".idea", ".vscode",
}
EXCLUDED_FILES = {".DS_Store", "Thumbs.db", "desktop.ini"}
EXCLUDED_PATTERNS = ["*.pyc", "*.pyo", "*.class", "*.o", "*.obj", "*.tmp", "*.swp", "*.swo", "*~"]


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("--exclude", action="append", default=[], help="Дополнительный шаблон исключения")
    parser.add_argument("--level", type=int, choices=range(0, 10), default=9, 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]] = []
    skipped_links = 0
    for path in sorted(source.rglob("*")):
        if path.is_symlink():
            skipped_links += 1
            continue
        if not path.is_file():
            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} МБ, ссылок пропущено: {skipped_links}")
    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=f"{source.name}/{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-project-archive
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

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

Категория

Архивы

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