Qué hace la herramienta
- Filtrado por MIME: procesa solo archivos cuyo nombre MIME contenga
text/
ojson
(ej: HTML, CSS, JS, CSV, MD, XML, YAML, INI, JSON). - Búsqueda y reemplazo precisos: patrones de texto simple o regex, opcionalmente sensibles a mayúsculas y con coincidencia de palabra completa.
- Vista previa en modo simulación: muestra exactamente qué archivos y líneas cambiarán antes de escribir.
- Ámbito selectivo: incluir/excluir rutas, patrones glob y extensiones de archivos.
- Soporte de codificación: utf-8 por defecto con manejo correcto de BOM.
- Escrituras seguras: copias de seguridad opcionales y estrategia de escritura atómica para minimizar riesgos de corrupción.
- Informe de cambios: resumen por archivo con conteo de coincidencias y reemplazos.
Casos de uso comunes
- Rebranding & actualizaciones de texto: nombres de productos, datos de empresa, texto legal.
- Migraciones de URL/dominio: reemplazar hosts antiguos, rutas de CDN, prefijos de recursos.
- Rotación de configuración y claves: cambiar endpoints de API o claves en configuraciones no binarias.
- Refactorización de código: renombrar módulos, clases CSS y banderas de funciones.
- Preparación para localización: extraer o normalizar cadenas hardcodeadas.
- Higiene de datos: corregir nombres de propiedades JSON, encabezados CSV o errores de esquema.
Cómo funciona
- Elige una carpeta raíz para el escaneo.
- Define tu patrón (texto simple o regex) y el valor de reemplazo.
- Refina el alcance con globs de inclusión/exclusión y filtros de extensión.
- Ejecuta un modo simulación para previsualizar archivos coincidentes y fragmentos de líneas.
- Aplica los cambios con copias de seguridad habilitadas para fácil reversión.
- Revisa el informe con conteo de coincidencias, archivos cambiados y elementos omitidos.
Por qué usar filtrado MIME?
Los archivos binarios a menudo contienen secuencias de bytes que parecen texto. El filtrado MIME limita las operaciones a formatos de texto, reduciendo coincidencias falsas y evitando la corrupción de archivos en imágenes, fuentes, archivos comprimidos y ejecutables.
Buenas prácticas
- Haz una copia de seguridad o usa control de versiones antes de reemplazos grandes.
- Prefiere límites regex (ej:
\b
) para evitar coincidencias parciales. - Apunta con precisión usando globs de inclusión como
**/*.js
ocontent/**/*.md
. - Prueba en un subconjunto pequeño y luego escálalo al árbol completo.
- Revisa los diffs para confirmar que no hay ediciones no deseadas.
Limitaciones
- Omite formatos binarios por diseño; si un archivo reporta un MIME no textual, no se modificará.
- Patrones regex demasiado amplios pueden coincidir más de lo previsto — usa vista previa y anclas.
- Archivos monolíticos muy grandes pueden requerir más memoria; divídelos o ajusta el alcance si es necesario.
FAQ
- ¿Qué archivos están incluidos?
- Cualquier archivo cuyo tipo MIME contenga
text/
(ej:text/html
,text/css
,text/markdown
) ojson
(ej:application/json
). - ¿Puedo deshacer los cambios?
- Sí. Habilita copias de seguridad para crear archivos
.bak
, o confía en tu sistema de control de versiones para revertir cambios específicos. - ¿Cambia permisos o marcas de tiempo de archivos?
- Los permisos se conservan. Las marcas de tiempo se actualizan solo en archivos modificados.
- ¿Reescribe los finales de línea?
- Conserva los finales de línea existentes (LF/CRLF), a menos que tu entorno imponga una política diferente.
- ¿Cómo evito cambiar variables dentro de bloques de código que no quiero tocar?
- Restringe el alcance con globs de inclusión y usa regex con anclas/contextos para coincidir solo en regiones seguras.