freps: la herramienta que no debía existir (pero hacía falta)

Todo empezó con una necesidad muy concreta: necesitaba una herramienta para renombrar archivos, buscar y reemplazar texto de forma rápida y fiable en Windows.

Nada fuera de lo normal. Hasta que el contexto importó.

Un proyecto real, una máquina Windows “limpia”, cientos de ficheros, nombres inconsistentes y contenidos que había que actualizar. Y cero ganas de instalar dependencias, montar entornos o escribir otro script “solo para hoy”.

PowerShell era una opción, sí… pero demasiado verboso para algo que debería resolverse en segundos. Herramientas externas no siempre están disponibles (o permitidas). Hacerlo a mano es una invitación directa al error.

"Voy a hacer una herramienta mínima que haga exactamente esto... y ya está."

Spoiler: nunca es “y ya está”.

¿Qué es freps?

freps es una utilidad ligera de línea de comandos para Windows, implementada como un único archivo .bat, pensada para operaciones habituales sobre archivos y carpetas:

• Renombrar archivos y directorios
• Buscar texto
• Reemplazar contenido en múltiples archivos
• Listar por patrón
• Deshacer cambios
• Eliminar archivos de forma controlada

Sin instaladores. Sin dependencias. La pones en el PATH y la ejecutas desde un CMD normal.

La regla es simple: si no funciona en un Windows recién instalado, no entra.

Cómo funciona

freps funciona por modos: el primer argumento elige la operación, y el resto define qué buscar, qué cambiar y dónde aplicarlo.

Ideas clave de diseño:

• Procesado recursivo de directorios
• Filtrado por extensiones
• Opciones de dry-run (simular antes de tocar nada)
• Verbosidad configurable
• Backups opcionales al modificar contenido

Esto permite usarla tanto para “explorar” como para tareas repetibles de mantenimiento.

Ejemplos de uso

Renombrar archivos y carpetas:

freps r oldName newName C:\project

Reemplazar texto dentro de archivos (con backups):

freps p dev prod C:\project .cfg .env /B /V

Buscar texto dentro de archivos:

freps s ERROR "" C:\logs .log .txt

Deshacer un reemplazo usando los backups:

freps u C:\project

TIP: Para ir a lo seguro: primero dry-run, y cuando apliques cambios, activa backups.

Cómo está programado

Sí: freps está escrito en Batch de Windows. A propósito.

Eso implica decisiones muy claras:

• Se apoya en primitives estándar de CMD: for, if, call y expansión retardada.
• Manejo cuidadoso de rutas (espacios y caracteres especiales incluidos).
• Enfoque pragmático: portabilidad y mantenibilidad por delante de la “elegancia”.

¿A quién va dirigido?

freps está orientado a gente que trabaja en Windows y necesita operar sobre estructuras reales de proyectos:

• Ingeniería de automatización y control
• Técnicos de sistemas
• Desarrolladores en entornos Windows-only
• Equipos que mantienen proyectos grandes con ediciones repetitivas

Especialmente útil cuando no puedes instalar software adicional, necesitas algo rápido y reproducible, o trabajas en entornos más “industriales” que de escritorio dev.

Cierre

freps no pretende sustituir herramientas avanzadas. Existe porque resuelve un problema real de forma simple, portable y predecible.

Es el tipo de herramienta que no usas todos los días… pero cuando la necesitas, te alegra tenerla.

Repo: github.com/EidoAut/freps