Skip to content

dannymaaz/DataForge-CLI

Repository files navigation

🚀 DataForge CLI | El Orquestador de Datos Futurista

DataForge Banner Python License OS

DataForge CLI es un toolkit de consola de alto rendimiento diseñado para la transformación fluida de datos. Convierte estructuras complejas de Excel a CSV optimizados y genera sentencias SQL INSERT profesionales en segundos.

Diseñado para la eficiencia. Construido para el futuro.


💎 Características Principales

  • 📦 Extracción Inteligente: Detecta automáticamente encabezados y limpia datos basura en hojas de Excel.
  • ⚡ Perfiles Dinámicos: Generación de SQL mediante perfiles warehouse_clean (para staging) o generic.
  • 🔍 Diagnóstico Profundo: Herramientas integradas para inspeccionar estructuras y validar calidad de datos.
  • 🛠️ Versatilidad: Soporte multiformato (utf-8, latin-1) y detección automática de delimitadores.
  • 🖥️ UI Minimalista: Menú interactivo con diseño responsive para terminales de cualquier tamaño.

🚀 Arranque Rápido

1. Preparar el Entorno

pip install -r requirements.txt

2. Ejecutar la Terminal

Elige tu método preferido según tu sistema:

  • Windows: run-tool.bat
  • Linux/macOS: sh run-tool.sh
  • Universal: python scripts/data_toolkit_cli.py

3. Flujo Maestro

  1. Opción 1: Transforma tus hojas de Excel en archivos CSV limpios.
  2. Opción 2: Convierte esos CSV en potentes scripts SQL listos para producción.

📸 Capturas de Pantalla

Menú en Terminal Ancha

DataForge CLI wide

Menú en Terminal Compacta

DataForge CLI compact

Generación SQL en Acción

DataForge SQL run


🛠️ Herramientas Disponibles

  • 1 📄 Extraer Excel a CSV: Desglose completo de libros de trabajo.
  • 2 🗄️ Generar SQL INSERT: Automatización de scripts de carga.
  • 3 🕵️ Inspeccionar Excel: Análisis de la estructura interna antes de procesar.
  • 4Validar CSV: Control de calidad y detección de anomalías.
  • 5 🔗 Unir CSVs: Consolidación de múltiples fuentes en un solo archivo.
  • 6 🧹 Limpieza: Mantenimiento de carpetas temporales de salida.

🏗️ Arquitectura del Proyecto

.
|-- 📂 scripts/           # Motores de ejecución y lógica
|   |-- 📂 lib/           # Librerías de procesamiento core
|-- 📂 docs/              # Activos y documentación
|-- 📂 data/              # Depósito de entrada/salida
|-- 📄 run-tool.bat       # Lanzador Windows
|-- 📄 run-tool.sh        # Lanzador Linux/macOS
|-- 📄 requirements.txt   # Dependencias base

🌐 Compatibilidad y CI

El toolkit está diseñado para ser agnóstico del sistema operativo. Contamos con integración continua (GitHub Actions) validada en:

  • Ubuntu (Linux)
  • Windows
  • macOS

👨‍💻 Creado Por: Danny Maaz

GitHub LinkedIn

✨ ¿Te gusta el proyecto? ¡Apóyalo! ✨

PayPal


© 2026 - Danny Maaz

About

🚀 DataForge CLI: Un orquestador de datos futurista y minimalista. Toolkit de alta velocidad para transformar Excel a CSV y generar scripts SQL INSERT profesionales. Optimizado para staging y flujos de datos complejos. Creado por Danny Maaz. 💎⚡

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages