smooth-criminal 0.3.0

Dashboard de análisis de rendimiento con decoradores inteligentes

🎩 Smooth Criminal

A Python performance acceleration toolkit with the soul of Michael Jackson.

---

🚀 ¿Qué es esto?

Smooth Criminal es una librería de Python para acelerar funciones y scripts automáticamente usando:

• 🧠 Numba
• ⚡ Asyncio y threading
• 📊 Dashboard visual con Flet
• 🧪 Benchmarks y profiling
• 🎶 Estilo, carisma y mensajes inspirados en MJ

---

💡 Características principales

Decorador / Función	Descripción
@smooth	Aceleración con Numba (modo sigiloso y rápido)
@moonwalk	Convierte funciones en corutinas async sin esfuerzo
@thriller	Benchmark antes y después (con ritmo)
@jam(workers=n)	Paralelismo automático con ThreadPoolExecutor
@black_or_white(mode)	Optimiza tipos numéricos (float32 vs float64)
@bad	Modo de optimización agresiva (fastmath)
@beat_it	Fallback automático si algo falla
dangerous(func)	Mezcla poderosa de decoradores (@bad + @thriller)
profile_it(func)	Estadísticas detalladas de rendimiento
analyze_ast(func)	Análisis estático para detectar código optimizable

---

🧠 Dashboard visual

Ejecuta el panel interactivo para ver métricas de tus funciones decoradas:

python -m smooth_criminal.dashboard

O bien:

python scripts/example_flet_dashboard.py

• Tabla con tiempos, decoradores y puntuaciones

• Botones para exportar CSV, limpiar historial o ver gráfico

• Interfaz elegante con Flet (modo oscuro)

⚙️ Instalación

pip install smooth-criminal

O para desarrollo local:

git clone https://github.com/Alphonsus411/smooth_criminal.git
cd smooth_criminal
pip install -e .

💃 Ejemplo rápido

from smooth_criminal import smooth, thriller

@thriller
@smooth
def square(n):
    return [i * i for i in range(n)]

print(square(10))

🧪 CLI interactiva

smooth-criminal analyze my_script.py

Esto analizará tu código buscando funciones lentas, bucles, range(), etc.

📚 Documentación

Próximamente en ReadTheDocs…

📝 Licencia

MIT © Adolfo González

🎤 Créditos

• Michael Jackson por la inspiración musical 🕺

• Numba, NumPy, asyncio por la base técnica

• Flet por el dashboard elegante