Ray

O que é Ray?

Ray é um companheiro de depuração de desktop multiplataforma e multi-framework, projetado para coletar, organizar e visualizar a saída de depuração do seu código. Em vez de despejar dados inline no seu aplicativo ou no terminal, Ray oferece um ambiente centralizado, rico em recursos, onde strings, arrays, objetos, consultas, e-mails, eventos e muito mais podem ser enviados e renderizados em um formato legível e navegável. Com Ray, você pode filtrar, pesquisar, arquivar e analisar informações de depuração de PHP, Laravel, JavaScript e além, tudo dentro de um único aplicativo dedicado. O objetivo é simples: manter a experiência de depuração rápida, organizada e não intrusiva ao seu fluxo de trabalho, enquanto oferece ferramentas poderosas para entender e agir sobre seus dados.

Ray 3.0 apresenta melhorias que unem a depuração tradicional a fluxos de trabalho assistidos por IA, geração de componentes HTML e representações diagramáticas mais ricas. O produto enfatiza consistência entre linguagens, ferramentas inline para navegação na IDE, capacidades remotas e visualização de dados flexível – tudo fácil de adotar por equipes e indivíduos.

Principais características

• Interface de depuração centralizada: Colete e organize toda a saída de depuração em um único aplicativo desktop, não dispersa por terminais e logs.
• Suporte multilíngue e multi-framework: Funciona com PHP, Laravel, JavaScript e mais; sintaxe e fluxo de trabalho consistentes.
• Depuração remota via SSH: Conecte-se a servidores remotos e transmita a saída de depuração diretamente para o Ray, permitindo diagnóstico em tempo real sem alterações locais no código.
• Arquivamento e recuperação de mensagens: Salve saídas importantes para comparação, auditoria ou reprodução de problemas difíceis de depurar.
• Pausa e medição de execução: Pause caminhos de código e meça o tempo entre chamadas para identificar gargalos de desempenho sem adicionar código extra.
• Sem dump necessário (auto-output): Receba a saída automaticamente de consultas, jobs, exceções e outras fontes de dados, reduzindo boilerplate no seu código.
• Vá direto ao IDE: Abra diretamente a localização de origem relevante a partir do Ray, com suporte a vários IDEs populares para navegação rápida.
• Temas e extensibilidade: Altere temas para se adequar ao seu fluxo de trabalho, crie macros e estenda o Ray com seus próprios clientes ou bindings para ambientes não suportados.
• Componentes HTML e saídas guiadas por IA: Deixe que a IA gere componentes HTML ou protótipos dentro do Ray e interaja com eles diretamente.
• Diagramas Mermaid e ERD: Gere diagramas estruturados para explicar esquemas complexos de banco de dados com visualizadores integrados.
• Integração com MCP server: Fornece aos agentes IA acesso ao seu ambiente Windows e ferramentas para automação avançada e tarefas de geração.
• Novo no Ray 3.0: Veja o que sua IA gera, interaja com saídas de IA no app e aproveite ferramentas de diagramas e visualização aprimoradas.
• Compatibilidade cross-platform: Ray roda em macOS, Windows e Linux, oferecendo uma experiência de depuração consistente entre dispositivos.
• Documentação e comunidade: Documentação completa acompanha o Ray, com um ecossistema de suporte da comunidade para linguagens e frameworks.

Como usar Ray

1. Obter Ray: Baixe e instale o Ray no site oficial. Licenças são gerenciadas pela Spatie, com opções de preços incluindo padrão e preço promocional de lançamento (a partir do Ray 3.0, veja os preços no checkout).
2. Instalar e inicializar: Inicie o aplicativo desktop Ray na sua máquina de desenvolvimento. Certifique-se de que o Ray está em execução e pronto para receber dados.
3. Enviar dados de depuração do seu código: Use a função ray() (ou o equivalente na sua linguagem) para enviar strings, arrays, objetos, consultas, e-mails, eventos ou quaisquer dados que você queira inspecionar. Você pode rotular saídas para melhorar filtragem e pesquisabilidade.
4. Explorar a renderização no app: Ray renderiza seus dados em um formato legível e estruturado. Use filtros por tipo, origem ou rótulos personalizados para restringir os resultados, e use a busca para localizar qualquer coisa entre todas as mensagens.
5. Filtrar, arquivar e refinar: Anexe cores ou rótulos às saídas, arquive mensagens para referência futura e pause/mede a execução para isolar problemas.
6. Vá para o seu IDE: A partir de um arquivo dumpado, vá direto para o local relevante no seu editor. Ray suporta muitos IDEs populares para navegação rápida.
7. Aproveitar IA e componentes HTML: Use os recursos assistidos por IA do Ray para gerar componentes HTML ou protótipos, ou explicar dados complexos com diagramas Mermaid/ERD.
8. Estender e personalizar: Se Ray ainda não suportar uma linguagem ou framework de que você depende, estenda Ray via macros ou crie um cliente personalizado para enviar dados.
9. Implantar remotamente se necessário: Aproveite o depurador remoto via SSH para monitorar e depurar código em execução em servidores remotos.
10. Explorar e otimizar: Use pausa, timing e ferramentas de filtragem para isolar preocupações de desempenho, reproduzir problemas e comparar saídas entre execuções.

Casos de uso

• Depuração de PHP e Laravel: Saída de dados em tempo real de PHP e Laravel diretamente para o Ray, visualize arrays e objetos, e trate consultas com rotulagem contextual.
• Depuração de JavaScript e frontend: Capture saídas semelhantes a console, respostas de API e eventos de Node.js ou código baseado em navegador, tudo em um só lugar.
• Depuração em servidor remoto: Depure código rodando em máquinas remotas via SSH, transmitindo logs e saídas para o Ray para análise em tempo real.
• Desenvolvimento assistido por IA: Gere componentes HTML, protótipos ou explicações de esquemas complexos com IA, e visualize os resultados dentro do Ray usando visualizadores integrados.
• Visualização de banco de dados e esquemas: Crie diagramas Mermaid ou ERD a partir de seus fluxos de dados e consultas para entender melhor as relações no banco de dados.
• Coerência do fluxo de depuração: Mantenha uma experiência de depuração uniforme entre macOS, Windows e Linux, assegurando que equipes permaneçam alinhadas independentemente do ambiente.

FAQ

• Qual é o modelo de preço e licenciamento? Ray oferece uma licença desktop paga. A partir da versão mais recente, os preços são mostrados no checkout, com uma opção de lançamento a preço reduzido. Licenças costumam ser válidas por um período definido (ex.: 1 ano) e são gerenciadas pelo sistema oficial de licenciamento (Spatie). Licenças vitalícias são mencionadas como opção, sujeitas aos termos vigentes. Licenças adquiridas antes de uma versão maior podem permanecer válidas segundo os termos anteriores.
• Quais plataformas são suportadas? Ray é projetado para ser multiplataforma e roda em macOS, Windows e Linux, oferecendo uma experiência de depuração consistente em todos os ambientes desktop.
• Quais linguagens e frameworks são suportados? Ray suporta PHP, Laravel, JavaScript e linguagens adicionais via bindings de linguagem ou clientes personalizados. O produto enfatiza uma sintaxe e fluxo de trabalho consistentes entre os idiomas suportados.
• Posso depugar remotamente ou em servidores? Sim. Ray suporta depuração remota via SSH, permitindo conectar-se a servidores remotos e transmitir a saída de depuração diretamente para o Ray sem modificar localmente seu código.
• Como funcionam a pesquisa, filtragem e arquivamento? Você pode filtrar mensagens por tipo, origem ou rótulos personalizados, usar a busca para localizar itens entre todas as mensagens e arquivar saídas importantes para referência futura ou comparação. Isso ajuda a gerenciar grandes volumes de dados de depuração com eficiência.
• Existe integração com IA e geração HTML? Novidades em Ray 3.0 permitem que IA gere componentes HTML e diagramas, com um visualizador in-app para Mermaid e ERD. Você também pode conectar saídas de IA ao seu fluxo de depuração para insights aprimorados.
• Como posso começar? Baixe o aplicativo Ray no site oficial, consulte a documentação para bindings de linguagem e comece a enviar dados através das chamadas ray() no seu código. Se precisar personalizar ou estender Ray, pode explorar macros e clients personalizados.

Notas adicionais: Ray enfatiza um fluxo de trabalho que mantém a saída de depuração fora da sua aplicação, mantendo-a acessível, pesquisável e acionável. O objetivo é fornecer um ambiente de depuração poderoso, extensível e multiplataforma que cresça com seus projetos e equipes, mantendo seu fluxo de desenvolvimento.