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