Ray

¿Qué es Ray?

Ray es una app de escritorio dedicada para organizar e inspeccionar la salida de depuración fuera del runtime de tu aplicación. Te permite enviar valores (cadenas, arrays, objetos y más) con una sintaxis consistente ray(...), y luego verlos, filtrarlos y revisarlos en Ray.

Su propósito principal es mantener la salida de depuración legible y estructurada, reduciendo la necesidad de saturar tu app con código de logging adicional. Ray también soporta depuración remota por SSH e incluye herramientas para pausar y medir la ejecución en contextos PHP/Laravel.

Características clave

• Vista de escritorio organizada para salida de depuración: Mantiene la salida de depuración en una app dedicada para inspeccionar resultados sin depender de consolas del navegador.
• Renderizado con formato para muchos tipos de datos: Envía valores como cadenas, arrays, objetos y tablas, y los renderiza de forma ordenada para inspección.
• Filtrado, etiquetado y búsqueda entre mensajes: Filtra por tipo, origen o etiquetas personalizadas, y usa búsqueda para encontrar salidas anteriores.
• Controles de archivo y limpiar: Limpia la pantalla y archiva mensajes para referencia posterior al comparar salidas o investigar problemas difíciles de reproducir.
• Depuración remota por SSH: Conéctate a servidores vía SSH para transmitir salida de depuración de código remoto a Ray.
• Salto a tu IDE: Salta desde la salida volcada de vuelta a la ubicación relevante en tu editor (con soporte para muchos IDEs, como se indica en el sitio).
• Sintaxis de depuración multiplataforma/multi-framework: El sitio describe usar el mismo enfoque estilo dump en varios lenguajes y frameworks.
• Herramientas de ejecución de Ray 3.0 para PHP/Laravel: Incluye pausa y medición de ejecución para pausar código PHP/Laravel y medir tiempo entre llamadas.
• Recepción automática de salida de runtime (Ray 3.0): El sitio menciona recibir salida automáticamente (p. ej., consultas, jobs, excepciones) sin agregar llamadas explícitas en tu código.
• Extensibilidad y personalización: Cambia temas, extiende Ray con macros y crea tu propio cliente para enviar datos desde lenguajes/frameworks no soportados aún.
• Funciones de IA (Ray 3.0): Interactúa con salida de IA directamente en Ray, incluyendo componentes/prototipos HTML generados por IA y explicaciones estructuradas para diagramas Mermaid y ERD mediante un visor integrado.
• Servidor MCP para agentes de IA: El sitio indica que un servidor MCP permite a agentes de IA acceder a ventanas/herramientas para leer, generar y mostrar contenido.

Cómo usar Ray

1. Descarga Ray y compra una licencia si es necesario (el sitio muestra un precio de $49 USD y menciona licencias de 1 año gestionadas por Spatie).
2. Envía salida de depuración a Ray usando la sintaxis ray(...) mostrada en el sitio (ejemplos incluyen etiquetado, tablas, aplicación de colores y filtrado por atributos de llamada).
3. Inspecciona y gestiona mensajes en Ray: usa búsqueda y filtros para acotar resultados, y archiva mensajes cuando quieras comparar salidas después.
4. (Opcional) Configura depuración remota: conéctate a un servidor vía SSH para que Ray transmita salida de depuración de ejecuciones remotas.
5. (Opcional) Usa navegación de IDE y herramientas de ejecución: salta a la ubicación fuente desde la salida de Ray y usa herramientas de pausa y medición de ejecución para PHP/Laravel.

Casos de uso

• Inspeccionar valores complejos sin saturar tu app: Envía cadenas, arrays, objetos y tablas a Ray (con etiquetas y formato) para entender el estado durante el desarrollo sin depender de salida cruda de consola.
• Depurar solicitudes o rutas de código específicas con filtros: Asocia colores/etiquetas a llamadas ray(...), luego filtra por tipo/origen/etiqueta en Ray para aislar mensajes relevantes.
• Comparar salidas entre intentos: Archiva mensajes antes/después de cambiar código para revisitar salidas anteriores al solucionar problemas intermitentes.
• Depuración de servidor remoto por SSH: Transmite salida de depuración de código en servidores remotos a Ray, permitiendo inspeccionar resultados sin copiar logs manualmente.
• Depuración de rendimiento y flujo en PHP/Laravel: Pausa ejecución y mide tiempo entre llamadas, además de recibir ciertas salidas de runtime automáticamente (consultas, jobs, excepciones) como se describe para Ray 3.0.
• Trabajar con diagramas de base de datos y explicaciones de esquemas vía IA: Usa funciones de Ray 3.0 para que la IA explique esquemas de bases de datos y vea salida estructurada en formato Mermaid o ERD.

Preguntas frecuentes

• ¿Ray es solo para depuración en el navegador? No. El sitio describe Ray como una app de escritorio dedicada que mantiene la salida de depuración organizada fuera del runtime de tu app.

• ¿Qué formatos de salida soporta Ray? El sitio indica que Ray formatea la salida que recibe (p. ej., cadenas, arrays, objetos) y puede renderizar tablas; también menciona volcar consultas, emails, eventos y stack traces.

• ¿Puede Ray depurar código en un servidor remoto? Sí. El sitio describe la conexión vía SSH y el streaming de salida de depuración a Ray.

• ¿Ray reemplaza a dd() u otros depuradores? La página dice que Ray no reemplaza dd ni xdebug; se describe como una tercera herramienta que cubre el vacío entre volcar datos rápidamente y flujos de depuración más estructurados.

• ¿Qué hay de nuevo en Ray 3.0? La página destaca pausa y medición de ejecución, interacciones con IA (incluyendo componentes HTML y visores Mermaid/ERD), y un servidor MCP para agentes de IA.

Alternativas

• Registro en navegador y salida de consola (p. ej., console.log, devtools del navegador): Útil para chequeos rápidos, pero los resultados están ligados al entorno del navegador y no se presentan en una línea de tiempo de escritorio dedicada y buscable.
• “Volcadores” del framework de la app (p. ej., depuración estilo dd()): Rápidos y directos, pero suelen mantener la salida dentro de la respuesta de la app/navegador en lugar de en una app de escritorio separada con filtrado/búsqueda y archivado.
• Herramientas de registro/observabilidad remota: Alternativas para recolectar logs de entornos remotos, que suelen enfocarse en agregación y monitoreo de logs en lugar del flujo de inspección estructurada y basada en mensajes descrito para Ray.
• Herramientas de REPL/depuración en terminal: Pueden inspeccionar valores durante el desarrollo, pero pueden no ofrecer la misma UI de escritorio organizada, filtrado y flujo de salto a IDE referenciado en el sitio de Ray.