Файлы и папки

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

Отбирает файлы по дате изменения в диапазоне after и before, печатает дату, размер и путь.

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

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

Скрипт сравнивает локальную дату изменения файла с границами, заданными в формате YYYY-MM-DD. Можно указать только начало или только конец диапазона. Данные не изменяются, отчёт при необходимости сохраняется в JSON.

Запуск

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

python find_by_date.py --dir ./projects --after 2025-01-01 --before 2025-12-31

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

Примеры

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

  • python find_by_date.py --dir . --after 2025-06-01
  • python find_by_date.py --dir ~/Documents --before 2024-01-01 --json old.json
Зависимости

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

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

find_by_date.py

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

import argparse
import json
import os
from datetime import date, datetime
from pathlib import Path

DEFAULT_EXCLUDES = {".git", ".hg", ".svn", "node_modules", "__pycache__", ".venv", "venv"}


def parse_date(value: str) -> date:
    try:
        return datetime.strptime(value, "%Y-%m-%d").date()
    except ValueError as error:
        raise argparse.ArgumentTypeError(f"Дата должна быть в формате YYYY-MM-DD: {value}") from error


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("--after", type=parse_date, help="Начальная дата включительно, YYYY-MM-DD")
    parser.add_argument("--before", type=parse_date, help="Конечная дата включительно, YYYY-MM-DD")
    parser.add_argument("--exclude", action="append", default=[], help="Имя папки, которую нужно пропустить")
    parser.add_argument("--json", type=Path, help="Сохранить результат в JSON")
    args = parser.parse_args()

    if not args.after and not args.before:
        parser.error("Укажите --after и/или --before")
    if args.after and args.before and args.after > args.before:
        parser.error("Дата --after позже даты --before")

    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):
        try:
            stat = path.stat()
        except OSError as error:
            print(f"Пропуск {path}: {error}")
            continue
        changed = datetime.fromtimestamp(stat.st_mtime)
        changed_date = changed.date()
        if args.after and changed_date < args.after:
            continue
        if args.before and changed_date > args.before:
            continue
        matches.append(
            {
                "path": str(path.relative_to(root)),
                "size": stat.st_size,
                "modified": changed.isoformat(timespec="seconds"),
            }
        )

    if not matches:
        print("Файлы с такими датами не найдены.")
        return 0

    matches.sort(key=lambda item: item["modified"], reverse=True)
    for item in matches:
        print(f"{item['modified']}  {human_size(item['size']):>10}  {item['path']}")

    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), "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-date
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

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

Категория

Файлы и папки

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