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

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

Name: FileForge CLI — пакетная обработка и переименование файлов с откатом
Brand: Fizoni
Price: 29 USD
Availability: InStock

Version 1.0.0 Updated: 2026-10-05 Quality: 78/100

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

📁 What is inside (ZIP, 9 files)

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

Problem

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

Solution

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

More details

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

Features

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

What you get

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, наследование правил, переменные окружения

Installation guide

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.

Requirements

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

Options and pricing

Choose the level that suits you:

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

Frequently asked questions

What is included?

In what format will I receive the files?

After payment you get a secure link and a ZIP archive with all materials. The link is shown on the order page and available via the Telegram bot.

How long is the download link valid?

The link is active for 24 hours, up to 5 downloads.

Do I need special skills?

The product is designed for entrepreneurs and specialists. A step-by-step guide is included; no programming skills required.

Can I get a refund?

For refunds, contact support: [email protected].