Файлы и папки

Найти файлы по имени

Ищет файлы по регулярному выражению в имени или относительном пути и сохраняет отчёт в JSON.

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

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

Скрипт принимает regex, компилирует его один раз и проверяет каждое имя файла при обходе дерева. Можно искать по полному относительному пути и отключить учёт регистра. Это только поиск, файлы и папки не меняются.

Запуск

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

python find_by_name.py --dir . --pattern '^invoice-\d{4}'

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

Примеры

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

  • python find_by_name.py --dir ~/Documents --pattern 'report.*2025' --ignore-case
  • python find_by_name.py --dir . --pattern 'backup' --full-path --json found.json
Зависимости

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

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

find_by_name.py

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

import argparse
import json
import os
import re
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":
            return f"{int(value)} B" if unit == "B" else f"{value:.1f} {unit}"
        value /= 1024
    return f"{size} B"


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("--pattern", required=True, help="Регулярное выражение для имени или пути")
    parser.add_argument("--ignore-case", action="store_true", help="Не учитывать регистр")
    parser.add_argument("--full-path", action="store_true", help="Искать по относительному пути, а не только по имени")
    parser.add_argument("--exclude", action="append", default=[], help="Имя папки, которую нужно пропустить")
    parser.add_argument("--json", type=Path, help="Сохранить результат в JSON")
    args = parser.parse_args()

    try:
        regex = re.compile(args.pattern, re.IGNORECASE if args.ignore_case else 0)
    except re.error as error:
        parser.error(f"Ошибка в регулярном выражении: {error}")

    root = args.dir.expanduser().resolve()
    if not root.is_dir():
        parser.error(f"Папка не найдена: {root}")

    excludes = DEFAULT_EXCLUDES | {item.strip() for item in args.exclude if item.strip()}
    matches = []
    for path in iter_files(root, excludes):
        relative = path.relative_to(root)
        subject = str(relative) if args.full_path else path.name
        if not regex.search(subject):
            continue
        try:
            stat = path.stat()
        except OSError as error:
            print(f"Пропуск {path}: {error}")
            continue
        matches.append(
            {
                "path": str(relative),
                "size": stat.st_size,
                "modified": stat.st_mtime,
            }
        )
        print(f"{human_size(stat.st_size):>10}  {relative}")

    if not matches:
        print("Совпадений не найдено.")
        return 0

    print(f"\nНайдено файлов: {len(matches)}")
    if args.json:
        output = args.json.expanduser()
        output.parent.mkdir(parents=True, exist_ok=True)
        output.write_text(
            json.dumps({"root": str(root), "pattern": args.pattern, "files": matches}, ensure_ascii=False, indent=2) + "\n",
            encoding="utf-8",
        )
        print(f"Отчёт сохранён: {output}")
    return 0


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

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

CLI 1.0.0

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

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

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

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

Категория

Файлы и папки

Поиск, переименование, сортировка, сравнение и безопасная работа с файлами.