Найти файлы по расширению
Рекурсивно ищет файлы с нужными расширениями, показывает размер и умеет сохранить отчёт в JSON.
Что делает скрипт
Скрипт обходит указанную папку, поддерживает несколько расширений и по желанию учитывает регистр. Служебные каталоги вроде .git и node_modules можно исключить. По умолчанию только читает метаданные и печатает результат.
Быстрый старт
python find_by_extension.py --dir ./projects --ext .jpg
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python find_by_extension.py --dir . --ext .py --ext .mdpython find_by_extension.py --dir ~/Downloads --ext .zip --json report.json
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
find_by_extension.py
#!/usr/bin/env python3
"""Поиск файлов по расширению в указанной папке."""
from __future__ import annotations
import argparse
import json
import os
from pathlib import Path
DEFAULT_EXCLUDES = {".git", ".hg", ".svn", "node_modules", "__pycache__", ".venv", "venv"}
def human_size(size: int) -> str:
value = float(size)
for unit in ("B", "KB", "MB", "GB", "TB"):
if value < 1024 or unit == "TB":
if unit == "B":
return f"{int(value)} B"
return f"{value:.1f} {unit}"
value /= 1024
return f"{size} B"
def parse_extensions(values: list[str], lower: bool) -> set[str]:
result: set[str] = set()
for value in values:
for part in value.split(","):
part = part.strip()
if not part:
continue
if not part.startswith("."):
part = "." + part
result.add(part.lower() if lower else part)
return result
def iter_files(root: Path, excludes: set[str]):
for current, dirs, files in os.walk(root):
current_path = Path(current)
dirs[:] = [
name for name in dirs
if name not in excludes and not (current_path / name).is_symlink()
]
for name in files:
path = current_path / name
if path.is_symlink() or not path.is_file():
continue
yield path
def main() -> int:
parser = argparse.ArgumentParser(description="Найти файлы по расширению")
parser.add_argument("--dir", type=Path, default=Path("."), help="Папка для поиска")
parser.add_argument("--ext", action="append", required=True, help="Расширение, можно указать несколько раз")
parser.add_argument("--exclude", action="append", default=[], help="Имя папки, которую нужно пропустить")
parser.add_argument("--case-sensitive", action="store_true", help="Учитывать регистр расширения")
parser.add_argument("--json", type=Path, help="Сохранить результат в JSON")
args = parser.parse_args()
root = args.dir.expanduser().resolve()
if not root.is_dir():
parser.error(f"Папка не найдена: {root}")
lower = not args.case_sensitive
extensions = parse_extensions(args.ext, lower)
if not extensions:
parser.error("Не задано ни одного расширения")
excludes = DEFAULT_EXCLUDES | {item.strip() for item in args.exclude if item.strip()}
matches = []
total_size = 0
for path in iter_files(root, excludes):
name = path.name.lower() if lower else path.name
if not any(name.endswith(ext) for ext in extensions):
continue
try:
stat = path.stat()
except OSError as error:
print(f"Пропуск {path}: {error}")
continue
relative = path.relative_to(root)
matches.append({"path": str(relative), "size": stat.st_size})
total_size += stat.st_size
print(f"{human_size(stat.st_size):>10} {relative}")
if not matches:
print("Файлы с такими расширениями не найдены.")
return 0
print(f"\nНайдено файлов: {len(matches)}, общий размер: {human_size(total_size)}")
if args.json:
output = args.json.expanduser()
output.parent.mkdir(parents=True, exist_ok=True)
output.write_text(
json.dumps({"root": str(root), "files": matches}, ensure_ascii=False, indent=2) + "\n",
encoding="utf-8",
)
print(f"Отчёт сохранён: {output}")
return 0
if __name__ == "__main__":
raise SystemExit(main())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.