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

Старые файлы во временных каталогах

Показывает временные файлы старше N дней и удаляет их только с --apply.

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

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

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

Перед запуском
  • С --apply файлы удаляются без возможности отмены. Активные временные файлы могут быть заняты.
Запуск

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

python cleanup_temp_files.py --days 7

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

Примеры

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

  • python cleanup_temp_files.py --days 7
  • python cleanup_temp_files.py --days 30 --min-size 1048576
  • python cleanup_temp_files.py --days 7 --apply
Зависимости

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

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

cleanup_temp_files.py

#!/usr/bin/env python3
"""Удаление старых файлов во временных каталогах."""
from __future__ import annotations

import argparse
import json
import os
import tempfile
import time
from pathlib import Path


def temp_roots() -> list[Path]:
    roots = {Path(tempfile.gettempdir())}
    if os.name == "nt":
        for name in ("TEMP", "TMP"):
            value = os.environ.get(name)
            if value:
                roots.add(Path(value))
        local = os.environ.get("LOCALAPPDATA")
        if local:
            roots.add(Path(local) / "Temp")
    else:
        roots.add(Path("/tmp"))
        var_tmp = Path("/var/tmp")
        if var_tmp.is_dir():
            roots.add(var_tmp)
    return sorted({path.resolve() for path in roots if path.is_dir()}, key=str)


def forbidden(path: Path) -> bool:
    resolved = path.expanduser().resolve()
    return resolved == Path(resolved.anchor) or resolved == Path.home().resolve()


def is_under(path: Path, roots: list[Path]) -> bool:
    resolved = path.resolve()
    for root in roots:
        try:
            resolved.relative_to(root)
            return True
        except ValueError:
            continue
    return False


def collect(roots: list[Path], days: int, min_size: int) -> list[tuple[Path, int, float]]:
    cutoff = time.time() - days * 86400
    found: list[tuple[Path, int, float]] = []
    seen: set[Path] = set()
    for root in roots:
        for current, dirnames, filenames in os.walk(root, followlinks=False):
            dirnames[:] = [
                name
                for name in dirnames
                if not os.path.islink(os.path.join(current, name))
            ]
            for name in filenames:
                path = Path(current) / name
                if path in seen or path.is_symlink():
                    continue
                seen.add(path)
                try:
                    stat = path.stat()
                except OSError:
                    continue
                if stat.st_size < min_size or stat.st_mtime > cutoff:
                    continue
                found.append((path, stat.st_size, stat.st_mtime))
    return found


def main() -> int:
    parser = argparse.ArgumentParser(description="Очистка старых временных файлов")
    parser.add_argument("--days", type=int, default=7, help="Минимальный возраст файла в днях")
    parser.add_argument("--min-size", type=int, default=0, help="Минимальный размер в байтах")
    parser.add_argument("--path", type=Path, action="append", default=[], help="Дополнительный каталог")
    parser.add_argument("--apply", action="store_true", help="Удалить найденные файлы")
    parser.add_argument("--json", type=Path, help="Сохранить отчёт в JSON")
    args = parser.parse_args()

    if args.days < 0:
        parser.error("--days не может быть отрицательным")
    if args.min_size < 0:
        parser.error("--min-size не может быть отрицательным")

    roots = temp_roots()
    for extra in args.path:
        resolved = extra.expanduser().resolve()
        if not resolved.is_dir():
            parser.error(f"Каталог не найден: {resolved}")
        if forbidden(resolved):
            parser.error(f"Нельзя использовать этот каталог: {resolved}")
        if any(resolved == root or resolved.is_relative_to(root) for root in roots):
            continue
        roots = [root for root in roots if not root.is_relative_to(resolved)]
        roots.append(resolved)
    roots = sorted(set(roots), key=str)

    found = collect(roots, args.days, args.min_size)
    found.sort(key=lambda item: item[1], reverse=True)
    total = sum(item[1] for item in found)

    print(f"Временные каталоги: {', '.join(str(root) for root in roots)}")
    print(f"Файлов старше {args.days} дней: {len(found)}, объём: {total / 1048576:.1f} MB")
    for path, size, modified in found[:20]:
        stamp = time.strftime("%Y-%m-%d", time.localtime(modified))
        print(f"  {size / 1048576:8.1f} MB  {stamp}  {path}")
    if len(found) > 20:
        print(f"  ... и ещё {len(found) - 20} файлов")

    if args.json:
        payload = {
            "roots": [str(root) for root in roots],
            "days": args.days,
            "total_bytes": total,
            "files": [
                {"path": str(path), "size": size, "modified": modified}
                for path, size, modified in found
            ],
        }
        args.json.write_text(json.dumps(payload, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
        print(f"Отчёт сохранён: {args.json}")

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

    deleted = 0
    freed = 0
    errors = 0
    for path, size, _ in found:
        if not is_under(path, roots):
            continue
        try:
            path.unlink()
            deleted += 1
            freed += size
        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-temp-files
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

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

Категория

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

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