Найти файлы по дате изменения
Отбирает файлы по дате изменения в диапазоне after и before, печатает дату, размер и путь.
Что делает скрипт
Скрипт сравнивает локальную дату изменения файла с границами, заданными в формате 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-01python find_by_date.py --dir ~/Documents --before 2024-01-01 --json old.json
Что понадобится
winget install Python.Python.3.12
brew install python
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.