Codebase Compass
Una herramienta CLI en Python para auditar la deriva del código (*code drift*) y visualizar la consistencia entre tus proyectos.
Codebase Compass
El Desafío: La Deriva Silenciosa del Código
Cuando un framework o una plantilla base se utiliza para crear múltiples proyectos, mantener la coherencia es un desafío monumental. Con el tiempo, cada proyecto evoluciona de forma independiente. Las mejoras implementadas en uno no se propagan a los demás, y las desviaciones del estándar original se acumulan silenciosamente, creando una deuda técnica difícil de gestionar. ¿Cómo saber qué tan lejos se ha desviado un proyecto de su "fuente de la verdad"?
Codebase Compass nació de esta necesidad en Fractalcode: la de tener una herramienta que nos permitiera auditar de forma rápida y visual la consistencia entre nuestro framework Automata y los proyectos de nuestros clientes.
La Solución: Una Hoja de Ruta para la Consistencia
Codebase Compass es la brújula que te guía a través de la complejidad de tus bases de código. La herramienta compara dos directorios —una base y un objetivo— y genera un reporte de texto detallado que revela todas las discrepancias estructurales y de contenido.
El resultado es un árbol de directorios intuitivo que utiliza un sistema de tres estados (✅ Idéntico, ⚠️ Modificado, ❌ Faltante) para mostrar el estado de cada archivo. Acompañado de un resumen con porcentajes y un gráfico visual, el reporte te permite tomar decisiones informadas sobre qué cambios necesitan ser sincronizados. Es una herramienta creada por desarrolladores, para desarrolladores.
Características Clave
Verificación de Integridad
Más allá de la existencia, la herramienta analiza el contenido de cada archivo mediante un hash SHA-256 para identificar con certeza cualquier modificación.
Árbol Visual de 3 Estados
Usa los íconos ✅, ⚠️, y ❌ para mostrar el estado de cada archivo y directorio de un vistazo.
Altamente Configurable
Un simple archivo config.json permite definir qué proyectos comparar y qué excluir.
Diagnóstico Instantáneo
Obtén métricas clave al instante: totales, porcentajes y un gráfico visual para medir la "salud" de tu base de código de un vistazo.
Interfaz Profesional
Ofrece feedback claro en la terminal durante el proceso de análisis y escritura.
Rendimiento Optimizado
Escrito en Python puro para ser extremadamente veloz. Analiza miles de archivos y genera el reporte en segundos.
Construido Con
Python
Git
- CLI
- Open Source
- Developer Tool
- Colorama
- Argparse
Pruébalo Tú Mismo
Codebase Compass es un proyecto de código abierto bajo licencia MIT. Te invitamos a explorar el código, usarlo en tus propios proyectos y contribuir si lo deseas. La documentación completa se encuentra en el README del repositorio.
