Ray

¿Qué es Ray?

Ray es un compañero de depuración de escritorio multiplataforma y multi‑framework diseñado para recoger, organizar y visualizar la salida de depuración de tu código. En lugar de volcar los datos en línea dentro de tu aplicación o consola, Ray ofrece un entorno central y rico en funciones donde cadenas, matrices, objetos, consultas, correos electrónicos, eventos y más pueden enviarse y renderizarse en un formato legible y navegable. Con Ray, puedes filtrar, buscar, archivar y analizar la información de depuración de PHP, Laravel, JavaScript y más, todo dentro de una única aplicación dedicada. El objetivo es simple: mantener la experiencia de depuración rápida, organizada y no disruptiva para tu flujo de trabajo, al mismo tiempo que ofrece herramientas potentes para entender y actuar sobre tus datos.

Ray 3.0 introduce mejoras que conectan la depuración tradicional con flujos de trabajo asistidos por IA, generación de componentes HTML y representaciones diagramáticas más ricas. El producto enfatiza consistencia entre lenguajes, herramientas en línea para navegar en el IDE, capacidades remotas y visualización de datos flexible, todo ello para ser fácil de adoptar tanto para equipos como para individuos.

Características clave

• Interfaz de depuración centralizada: Recopila y organiza toda la salida de depuración en una sola aplicación de escritorio, sin que se disemine entre terminales y logs.
• Soporte multilingüe y multi‑framework: Funciona con PHP, Laravel, JavaScript y más; sintaxis y flujo de trabajo consistentes.
• Depuración remota por SSH: Conéctate a servidores remotos y transmite la salida de depuración directamente a Ray, habilitando diagnósticos en tiempo real sin cambios en tu código local.
• Archivo y recuperación de mensajes: Guarda salidas importantes para comparación, auditorías o reproducir problemas difíciles de depurar.
• Pausa y medición de ejecución: Pausa rutas de código y mide el tiempo entre llamadas para identificar cuellos de botella de rendimiento sin añadir código extra.
• No se requiere volcar datos (salida automática): Recibe la salida automáticamente de consultas, trabajos, excepciones y otras fuentes de datos, reduciendo código repetitivo en tu proyecto.
• Salir al IDE: Abre la ubicación de código relevante directamente desde Ray, compatible con múltiples IDEs para un cambio rápido de contexto.
• Temas y extensibilidad: Cambia temas para adaptar Ray a tu flujo de trabajo, crea macros y expande Ray con tu propio cliente o bindings de lenguaje para entornos no soportados.
• Componentes HTML y salidas impulsadas por IA: Deja que la IA genere componentes HTML o prototipos dentro de Ray e interactúa con ellos directamente.
• Diagramas Mermaid y ERD: Genera diagramas estructurados para explicar esquemas de bases de datos complejos con visores integrados.
• Integración con MCP server: Proporciona a agentes IA acceso a tu entorno Windows y herramientas para automatización y generación avanzada.
• Novedades de Ray 3.0: Mira lo que genera tu IA, interactúa con salidas de IA en la app y aprovecha herramientas mejoradas de diagramación y visualización.
• Compatibilidad multiplataforma: Ray se ejecuta en macOS, Windows y Linux para una experiencia de depuración coherente entre dispositivos.
• Documentación y comunidad: Documentación completa acompaña a Ray, con un ecosistema de soporte impulsado por la comunidad para lenguajes y frameworks.

Cómo usar Ray

1. Obtén Ray: Descarga e instala Ray desde el sitio oficial. Las licencias se gestionan a través de Spatie, con opciones de precio estándar y ofertas de lanzamiento (a partir de Ray 3.0, consulta el precio en la página de pago).
2. Instala e inicializa: Inicia la aplicación de escritorio Ray en tu máquina de desarrollo. Asegúrate de que Ray esté en funcionamiento y listo para recibir datos.
3. Envía datos de depuración desde tu código: Usa la función ray() (o el equivalente en tu lenguaje) para enviar cadenas, matrices, objetos, consultas, correos, eventos o cualquier dato que quieras inspeccionar. Puedes etiquetar salidas para mejorar el filtrado y la búsquedas.
4. Explora la renderización en la app: Ray renderiza tus datos en un formato legible y estructurado. Usa filtros por tipo, origen o etiquetas personalizadas para estrechar resultados, y usa la función de búsqueda para localizar cualquier cosa entre todos los mensajes.
5. Filtra, archiva y refina: Adjunta colores o etiquetas a las salidas, archiva mensajes para referencia posterior y pausa/medición de ejecución para aislar problemas.
6. Salta a tu IDE: Desde un archivo volcado, ve directamente a la ubicación relevante en tu editor. Ray admite muchos IDEs populares para navegación rápida.
7. Aprovecha IA y componentes HTML: Usa las funciones asistidas por IA de Ray para generar componentes HTML o prototipos, o explicar datos complejos con diagramas Mermaid/ERD.
8. Extiende y personaliza: Si Ray aún no soporta un lenguaje o framework que usas, extiéndelo mediante macros o crea un cliente personalizado para enviar datos.
9. Despliega de forma remota si es necesario: Aprovecha la depuración remota por SSH para monitorizar y depurar código que se ejecuta en servidores remotos.
10. Explora y optimiza: Usa pausas, temporización y herramientas de filtrado para aislar problemas de rendimiento, reproducir incidencias y comparar salidas entre ejecuciones.

Casos de uso

• Depuración de PHP y Laravel: Salida de datos de tiempo de ejecución de PHP y Laravel directamente en Ray, visualiza arrays y objetos, e inspecciona consultas con etiquetado contextual.
• Depuración de JavaScript y frontend: Captura salidas tipo consola, respuestas de API y eventos de Node.js o código basado en navegador, todo en un solo lugar.
• Depuración en servidor remoto: Depura código que se ejecuta en máquinas remotas vía SSH, transmitiendo logs y salidas a Ray para análisis en tiempo real.
• Desarrollo asistido por IA: Genera componentes HTML, prototipos o explicaciones de esquemas complejos con IA, y visualiza resultados dentro de Ray usando visores integrados.
• Visualización de bases de datos y esquemas: Crea diagramas Mermaid o ERD a partir de tus flujos de datos y consultas para entender mejor las relaciones de la base de datos.
• Consistencia en el flujo de depuración: Mantén una experiencia de depuración uniforme entre macOS, Windows y Linux, asegurando que los equipos permanezcan alineados sin importar la estación de trabajo.

Preguntas frecuentes

• ¿Cuál es el modelo de precios y licencias? Ray ofrece una licencia de escritorio de pago. A partir de la versión más reciente, los precios se muestran en la página de pago, con una opción de lanzamiento a precio reducido. Las licencias suelen ser válidas por un periodo determinado (p. ej., 1 año) y se gestionan a través del sistema de licencias oficial (Spatie). Se mencionan licencias de por vida como opción, sujeto a los términos vigentes. Las licencias compradas antes de una versión mayor pueden seguir siendo válidas bajo los términos anteriores.
• ¿Qué plataformas son compatibles? Ray está diseñado para ser multiplataforma y se ejecuta en macOS, Windows y Linux, proporcionando una experiencia de depuración consistente en todos los entornos de escritorio.
• ¿Qué lenguajes y frameworks son compatibles? Ray es compatible con PHP, Laravel, JavaScript y lenguajes adicionales a través de bindings de lenguaje o clientes personalizados. El producto enfatiza una sintaxis y flujo de trabajo consistentes entre los lenguajes soportados.
• ¿Puedo depurar de forma remota o en servidores? Sí. Ray admite depuración remota por SSH, permitiéndote conectarte a servidores remotos y transmitir la salida de depuración directamente a Ray sin modificar tu código de la aplicación localmente.
• ¿Cómo funcionan la búsqueda, filtrado y archivo? Puedes filtrar mensajes por tipo, origen o etiquetas personalizadas, usar la búsqueda para localizar elementos entre todos los mensajes y archivar salidas importantes para referencia futura o comparación. Esto ayuda a gestionar grandes volúmenes de datos de depuración de forma eficiente.
• ¿Existe integración con IA y generación de HTML? Sí. En Ray 3.0 hay funciones que permiten generar componentes HTML y diagramas con IA, con un visor en la app para diagramas Mermaid y ERD. También puedes conectar las salidas de IA a tu flujo de depuración para obtener insights mejorados.
• ¿Cómo empiezo? Descarga la aplicación de escritorio Ray desde el sitio oficial, revisa la documentación sobre bindings de lenguaje y comienza a enviar datos a través de las llamadas ray() en tu código. Si necesitas personalizar o extender Ray, puedes explorar macros y clientes personalizados.

Notas adicionales

Ray enfatiza un flujo de trabajo que mantiene la salida de depuración fuera de tu aplicación, mientras la hace accesible, buscable y accionable. El objetivo es proporcionar un entorno de depuración poderoso, extensible y multiplataforma que escale con tus proyectos y equipos, sin interrumpir tu flujo de desarrollo.