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

Файлы нулевого размера

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

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

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

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

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

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

python cleanup_zero_byte.py --path ./projects

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

Примеры

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

  • python cleanup_zero_byte.py --path ./projects
  • python cleanup_zero_byte.py --path ./projects --apply
Зависимости

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

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

cleanup_zero_byte.py

#!/usr/bin/env python3
"""Поиск файлов нулевого размера."""
from __future__ import annotations

import argparse
import os
import time
from pathlib import Path

SKIP_DIRS = {".git", "node_modules", ".venv", "venv", "env", "__pycache__"}
KEEP_NAMES = {".gitkeep", ".keep", "__init__.py", ".placeholder"}


def main() -> int:
    parser = argparse.ArgumentParser(description="Файлы нулевого размера")
    parser.add_argument("--path", type=Path, default=Path("."), help="Каталог для поиска")
    parser.add_argument("--days", type=int, default=0, 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("Нельзя использовать корень файловой системы")

    cutoff = time.time() - args.days * 86400
    found: list[tuple[Path, float]] = []
    for current, dirnames, filenames in os.walk(root, followlinks=False):
        dirnames[:] = [
            name
            for name in dirnames
            if name not in SKIP_DIRS and not os.path.islink(os.path.join(current, name))
        ]
        for name in filenames:
            if name in KEEP_NAMES:
                continue
            path = Path(current) / name
            if path.is_symlink():
                continue
            try:
                stat = path.stat()
            except OSError:
                continue
            if stat.st_size == 0 and stat.st_mtime <= cutoff:
                found.append((path, stat.st_mtime))

    found.sort(key=lambda item: item[1])
    print(f"Каталог: {root}")
    print(f"Пустых файлов: {len(found)}")
    for path, modified in found[:50]:
        stamp = time.strftime("%Y-%m-%d", time.localtime(modified))
        print(f"  {stamp}  {path}")
    if len(found) > 50:
        print(f"  ... и ещё {len(found) - 50} файлов")

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

    deleted = 0
    errors = 0
    for path, _ in found:
        try:
            path.unlink()
            deleted += 1
        except OSError as error:
            errors += 1
            print(f"Не удалось удалить {path}: {error}")
    print(f"Удалено: {deleted}, ошибок: {errors}")
    return 0


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

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

CLI 1.0.0

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

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

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

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

Категория

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

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