← Каталог

Исходный код Node.js (8 модулей .js) + примеры конфигураций JSON/YAML + README с инструкцией

FileForge CLI — пакетная обработка и переименование файлов с откатом

Версия 1.0.0 Обновлён: 2026-10-05 Качество: 78/100

Готовая кроссплатформенная CLI-утилита на Node.js для массового переименования, сортировки, конвертации и обработки файлов по правилам. Поддерживает dry-run, логирование и полный откат изменений.

📁 Что внутри (ZIP, 9 файлов)
  • 01_cli.js
  • 02_file_scanner.js
  • 03_rule_engine.js
  • 04_file_operations.js
  • 05_dry_run.js
  • 06_logger.js
  • 07_rollback.js
  • 08_config_loader.js
  • README.md

Проблема

Пакетная обработка файлов обычно делается либо вручную, либо одноразовыми скриптами без предпросмотра и отката. Это приводит к ошибкам переименования, потерянным файлам и невозможности вернуть исходное состояние. Разработчики тратят часы на написание кода, который не покрывает dry-run, логирование и обработку ошибок доступа.

Решение

Утилита предоставляет готовый pipeline из восьми модулей: сканирование, движок правил, безопасные операции, dry-run, логирование в JSON Lines, откат, загрузка и валидация конфигурации. Пользователь задаёт правила в JSON/YAML, сначала проверяет результат в режиме предпросмотра, затем выполняет изменения и при необходимости откатывает их одной командой.

Подробнее

FileForge CLI — это протестированная утилита командной строки, которая закрывает рутину пакетной обработки файлов: переименование по regex и шаблонам, сортировку по папкам на основе метаданных, конвертацию изображений и медиа, а также безопасное перемещение с проверкой коллизий. Утилита построена как модульный pipeline: сканер собирает файлы по glob-маскам, движок правил вычисляет новые имена и пути, а слой операций выполняет изменения атомарно и безопасно. Главное отличие от «сгенерированного кода» — режим dry-run и журнал операций. Перед любыми изменениями вы запускаете предпросмотр и видите таблицу «было → станет» с подсчётом затронутых файлов. Только после подтверждения операции выполняются, а каждая из них пишется в JSON Lines. Это позволяет в любой момент откатить переименования и перемещения, включая восстановление из бэкапа. Конфигурация описывается в JSON или YAML: правила наследуются, поддерживают условия по расширению, дате и размеру, а также подстановку переменных окружения. Схемы валидации не дают запустить утилиту с некорректными правилами. Конвертация изображений и медиа выполняется через sharp и ffmpeg, если они установлены в системе. Утилита кроссплатформенная: корректно работает с путями и символами в Windows, macOS и Linux. Ошибки доступа к файлам и папкам не роняют процесс — они логируются на уровне warn, а обработка продолжается. Логи пишутся одновременно в консоль и в файл с уровнями info/warn/error. Вы получаете исходники по модулям, которые можно использовать как готовый CLI, так и встроить в свои скрипты. Никаких внешних сервисов и аккаунтов: всё работает локально. Экономия времени разработчика — от нескольких часов до нескольких дней, в зависимости от сложности правил.

Возможности

  • Рекурсивный обход директорий с фильтрацией по glob-маскам и сбором метаданных (размер, дата, mime)
  • Движок правил: regex, шаблоны, условия по расширению, дате и размеру, генерация нового имени и пути
  • Режим dry-run с таблицей «было → станет» и подсчётом затронутых файлов
  • Безопасные файловые операции: переименование, перемещение, копирование, конвертация через sharp/ffmpeg
  • Проверка коллизий и атомарность операций
  • Логирование в консоль и файл с уровнями info/warn/error
  • Журнал операций в формате JSON Lines для последующего отката
  • Откат переименований и перемещений, восстановление из бэкапа
  • Загрузка конфигурации из JSON/YAML с наследованием правил и подстановкой переменных окружения
  • Схемы валидации конфигурации
  • Кроссплатформенность: Windows, macOS, Linux
  • Обработка ошибок доступа к файлам без остановки процесса

Что вы получаете

  • 01_cli.js — точка входа CLI: парсинг аргументов (yargs), загрузка правил, оркестрация pipeline, справка и версия
  • 02_file_scanner.js — рекурсивный обход директорий, фильтрация по glob-маскам, сбор метаданных, обработка ошибок доступа
  • 03_rule_engine.js — движок правил: regex, шаблоны, условия, генерация нового имени и пути
  • 04_file_operations.js — безопасные операции: переименование, перемещение, копирование, конвертация, проверка коллизий
  • 05_dry_run.js — предпросмотр операций без изменений, таблица «было → станет», подсчёт файлов
  • 06_logger.js — логирование в файл и консоль, журнал операций в JSON Lines
  • 07_rollback.js — откат изменений по журналу, обратное применение операций, восстановление из бэкапа
  • 08_config_loader.js — загрузка и валидация конфигурации JSON/YAML, наследование правил, переменные окружения

Инструкция по установке

1. Установите Node.js 18+ и npm. 2. Распакуйте архив с файлами утилиты. 3. При необходимости установите зависимости: npm install yargs js-yaml sharp (sharp опционально, для конвертации изображений). 4. Создайте конфигурационный файл rules.yaml или rules.json на основе примеров. 5. Запустите предпросмотр: node 01_cli.js --config rules.yaml --dry-run. 6. Проверьте таблицу «было → станет». 7. Выполните обработку: node 01_cli.js --config rules.yaml. 8. Для отката используйте: node 01_cli.js --rollback --log operations.jsonl.

Требования

Node.js 18 или выше, npm. Опционально: sharp для конвертации изображений, ffmpeg для конвертации медиа. Внешние аккаунты и сервисы не требуются.

Варианты и цены

Выберите подходящий уровень:

  • Базовый — $17 · Основной набор файлов продукта.
  • Стандарт — $29 · Полный набор + инструкция по внедрению.
  • Расширенный — $46 · Всё из Стандарта + расширенные материалы и обновления.

Частые вопросы

Что входит в продукт?

Готовая кроссплатформенная CLI-утилита на Node.js для массового переименования, сортировки, конвертации и обработки файлов по правилам. Поддерживает dry-run, логирование и полный откат изменений.

В каком формате я получу файлы?

После оплаты вы получаете защищённую ссылку и ZIP-архив со всеми материалами. Ссылка приходит на странице заказа и доступна через Telegram-бот.

Как долго доступна ссылка на скачивание?

Ссылка активна 24 часов, до 5 скачиваний.

Нужны ли специальные знания?

Продукт рассчитан на предпринимателей и специалистов. Внутри — пошаговая инструкция, специальные навыки программирования не требуются.

Можно ли вернуть деньги?

По вопросам возврата свяжитесь с поддержкой: [email protected].

Смотрите также