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

Пустые и битые архивы

Проверяет zip и tar-архивы, показывает пустые и повреждённые и удаляет их только с --apply.

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

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

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

Перед запуском
  • Битые архивы могут содержать нужные данные. Удаляйте их только после проверки.
Запуск

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

python cleanup_empty_archives.py --path ~/Downloads

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

Примеры

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

  • python cleanup_empty_archives.py --path ~/Downloads
  • python cleanup_empty_archives.py --path ~/Downloads --apply
  • python cleanup_empty_archives.py --path ~/Downloads --apply --include-corrupt
Зависимости

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

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

cleanup_empty_archives.py

#!/usr/bin/env python3
"""Поиск пустых и повреждённых zip и tar-архивов."""
from __future__ import annotations

import argparse
import os
import tarfile
import zipfile
from pathlib import Path

ZIP_EXTENSIONS = {".zip"}
TAR_EXTENSIONS = {".tar", ".tar.gz", ".tgz", ".tar.bz2", ".tbz2", ".tar.xz", ".txz"}


def archive_kind(path: Path) -> str | None:
    lowered = path.name.lower()
    if path.suffix.lower() in ZIP_EXTENSIONS:
        return "zip"
    if any(lowered.endswith(suffix) for suffix in TAR_EXTENSIONS):
        return "tar"
    return None


def inspect(path: Path, kind: str) -> tuple[str, int, int]:
    try:
        if kind == "zip":
            with zipfile.ZipFile(path) as archive:
                infos = archive.infolist()
                total = sum(item.file_size for item in infos)
                return ("empty" if not infos or total == 0 else "ok"), len(infos), total
        with tarfile.open(path, "r:*") as archive:
            members = archive.getmembers()
            total = sum(item.size for item in members if item.isfile())
            return ("empty" if not members or total == 0 else "ok"), len(members), total
    except (zipfile.BadZipFile, tarfile.TarError, OSError, EOFError):
        return "corrupt", 0, 0


def main() -> int:
    parser = argparse.ArgumentParser(description="Пустые и битые архивы")
    parser.add_argument("--path", type=Path, default=Path("."), help="Каталог для поиска")
    parser.add_argument("--apply", action="store_true", help="Удалить пустые архивы")
    parser.add_argument("--include-corrupt", action="store_true", help="Удалять также повреждённые архивы")
    args = parser.parse_args()

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

    empty: list[tuple[Path, int]] = []
    corrupt: list[tuple[Path, int]] = []
    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.is_symlink():
                continue
            kind = archive_kind(path)
            if kind is None:
                continue
            state, count, total = inspect(path, kind)
            try:
                size = path.stat().st_size
            except OSError:
                size = 0
            if state == "empty":
                empty.append((path, size))
                print(f"Пустой архив: {path} (записей: {count}, данных: {total} байт)")
            elif state == "corrupt":
                corrupt.append((path, size))
                print(f"Повреждённый архив: {path}")

    print(f"Пустых: {len(empty)}, повреждённых: {len(corrupt)}")
    if not args.apply:
        print("Предпросмотр. Для удаления пустых архивов добавьте --apply.")
        return 0

    targets = list(empty)
    if args.include_corrupt:
        targets.extend(corrupt)
        print("Повреждённые архивы также будут удалены.")

    deleted = 0
    freed = 0
    errors = 0
    for path, size in targets:
        try:
            path.unlink()
            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-empty-archives
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

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

Категория

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

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

Теги