Очистка и порядок

Старые виртуальные окружения Python

Находит .venv и venv с файлом pyvenv.cfg и удаляет только старые окружения после --apply.

Python Windows macOS Linux Средний
Скачать cleanup_python_venvs.py
Описание

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

Скрипт обходит дерево проектов, распознаёт виртуальные окружения по наличию pyvenv.cfg и считает их размер. Каталоги моложе заданного срока пропускаются. По умолчанию выводится отчёт, а с --apply окружения удаляются после повторной проверки маркера.

Перед запуском
  • После удаления окружение нужно создать заново и установить зависимости.
Запуск

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

python cleanup_python_venvs.py --path ~/projects --days 60

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

Примеры

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

  • python cleanup_python_venvs.py --path ~/projects --days 60
  • python cleanup_python_venvs.py --path ~/projects --days 90 --apply
Зависимости

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

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

cleanup_python_venvs.py

#!/usr/bin/env python3
"""Поиск старых виртуальных окружений Python."""
from __future__ import annotations

import argparse
import os
import shutil
import time
from pathlib import Path

VENV_NAMES = {".venv", "venv", "env"}


def directory_size(path: Path) -> int:
    total = 0
    for current, dirnames, filenames in os.walk(path, followlinks=False):
        dirnames[:] = [
            name
            for name in dirnames
            if not os.path.islink(os.path.join(current, name))
        ]
        for name in filenames:
            file_path = Path(current) / name
            if file_path.is_symlink():
                continue
            try:
                total += file_path.stat().st_size
            except OSError:
                continue
    return total


def find_venvs(root: Path, days: int) -> list[tuple[Path, int, float]]:
    cutoff = time.time() - days * 86400
    found: list[tuple[Path, int, float]] = []
    for current, dirnames, _ in os.walk(root, followlinks=False):
        keep: list[str] = []
        for name in dirnames:
            path = Path(current) / name
            if path.is_symlink():
                continue
            if name in VENV_NAMES and (path / "pyvenv.cfg").is_file():
                try:
                    modified = (path / "pyvenv.cfg").stat().st_mtime
                except OSError:
                    continue
                if modified <= cutoff:
                    found.append((path, directory_size(path), modified))
                continue
            keep.append(name)
        dirnames[:] = keep
    return found


def main() -> int:
    parser = argparse.ArgumentParser(description="Старые виртуальные окружения Python")
    parser.add_argument("--path", type=Path, default=Path("."), help="Каталог с проектами")
    parser.add_argument("--days", type=int, default=30, help="Минимальный возраст в днях")
    parser.add_argument("--apply", action="store_true", help="Удалить найденные окружения")
    args = parser.parse_args()

    if args.days < 0:
        parser.error("--days не может быть отрицательным")
    root = args.path.expanduser().resolve()
    if not root.is_dir():
        parser.error(f"Каталог не найден: {root}")
    if root == Path(root.anchor):
        parser.error("Нельзя использовать корень файловой системы")

    found = find_venvs(root, args.days)
    found.sort(key=lambda item: item[2])
    total = sum(item[1] for item in found)

    print(f"Каталог: {root}")
    print(f"Окружений старше {args.days} дней: {len(found)}, объём: {total / 1048576:.1f} MB")
    for path, size, modified in found:
        stamp = time.strftime("%Y-%m-%d", time.localtime(modified))
        print(f"  {size / 1048576:8.1f} MB  {stamp}  {path}")

    if not args.apply:
        print("Предпросмотр. Для удаления добавьте --apply.")
        return 0

    deleted = 0
    freed = 0
    errors = 0
    for path, size, _ in found:
        if not (path / "pyvenv.cfg").is_file():
            print(f"Пропуск, маркер окружения исчез: {path}")
            continue
        try:
            shutil.rmtree(path)
            deleted += 1
            freed += size
            print(f"Удалено: {path}")
        except OSError as error:
            errors += 1
            print(f"Не удалось удалить {path}: {error}")
    print(f"Удалено: {deleted}, освобождено: {freed / 1048576:.1f} MB, ошибок: {errors}")
    return 0


if __name__ == "__main__":
    raise SystemExit(main())

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get cleanup-python-venvs
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

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

Категория

Очистка и порядок

Безопасная очистка временных файлов, кэшей, дублей и старых загрузок.