Ray

Che cos'è Ray?

Ray è un compagno di debugging desktop cross-language e cross-framework progettato per raccogliere, organizzare e visualizzare l'output di debug dal tuo codice. Invece di esibire i dati inline nella tua applicazione o nella console, Ray fornisce un ambiente centralizzato e ricco di funzionalità dove stringhe, array, oggetti, query, email, eventi e molto altro possono essere inviati e renderizzati in un formato leggibile e navigabile. Con Ray, puoi filtrare, cercare, archiviare e analizzare le informazioni di debug provenienti da PHP, Laravel, JavaScript e oltre, tutto all'interno di una singola app dedicata. L'obiettivo è semplice: mantenere l'esperienza di debugging veloce, ordinata e non invasiva al tuo flusso di lavoro, offrendo strumenti potenti per comprendere e agire sui tuoi dati.

Ray 3.0 introduce miglioramenti che colmano il divario tra debugging tradizionale e workflow assistiti dall'IA, la generazione di componenti HTML e rappresentazioni diagrammatiche più ricche. Il prodotto enfatizza la coerenza tra linguaggi, strumenti inline per la navigazione nell'IDE, capacità remote e visualizzazione dati flessibile – tutto facile da adottare per team e singoli.

Caratteristiche principali

• Interfaccia di debug centralizzata: Raccogli e organizza tutto l'output di debug in una sola app desktop, non sparso tra terminali e log.
• Supporto multilingue e multi-framework: Funziona con PHP, Laravel, JavaScript e altri; sintassi e flussi di lavoro coerenti.
• Debug remoto via SSH: Connettiti a server remoti e trasmetti l'output di debug direttamente in Ray, abilitando diagnosi in tempo reale senza modifiche al codice locale.
• Archiviazione e recupero dei messaggi: Salva output importanti per confronti, audit o per riprodurre problemi difficili da debuggare.
• Pausa e misurazione dell'esecuzione: Metti in pausa i percorsi di codice e misura il tempo tra le chiamate per individuare i colli di bottiglia delle prestazioni senza dover aggiungere codice.
• Nessun dump necessario (output automatico): Ricevi l'output automaticamente da query, job, eccezioni e altre sorgenti di dati, riducendo il boilerplate nel tuo codice.
• Salta all'IDE: Apri direttamente la posizione sorgente rilevante da Ray, supportato da molti IDE popolari per un rapido cambio di contesto.
• Temi e estendibilità: Cambia temi per adattarli al tuo flusso di lavoro, crea macro ed estendi Ray con i tuoi client o binding per linguaggi non supportati.
• Componenti HTML e uscite guidate dall'IA: Lascia che l'IA generi componenti HTML o prototipi all'interno di Ray e interagisci con essi direttamente.
• Diagrammi Mermaid ed ERD: Genera diagrammi strutturati per spiegare schemi complessi di database con visualizzatori integrati.
• Integrazione MCP server: Fornisce agli agenti IA accesso al tuo ambiente Windows e agli strumenti per l'automazione avanzata e le attività di generazione.
• Nuovo in Ray 3.0: Vedi cosa genera la tua IA, interagisci con gli output IA nell'app e sfrutta strumenti di diagrammazione e visualizzazione potenziati.
• Compatibilità cross-platform: Ray gira su macOS, Windows e Linux per un'esperienza di debug coerente su dispositivi diversi.
• Documentazione e community: Documentazione completa accompagna Ray, insieme a un ecosistema di supporto guidato dalla community per linguaggi e framework.

Come usare Ray

1. Ottenere Ray: Scarica e installa Ray dal sito ufficiale. Le licenze sono gestite tramite Spatie, con opzioni di prezzo che includono standard e promozione di lancio a prezzo ridotto (a partire da Ray 3.0; vedi i prezzi al checkout).
2. Installare e inizializzare: Avvia l'app desktop Ray sulla tua macchina di sviluppo. Assicurati che Ray sia in esecuzione e pronto a ricevere dati.
3. Inviare dati di debug dal tuo codice: Usa la funzione ray() (o l'equivalente nel tuo linguaggio) per inviare stringhe, array, oggetti, query, email, eventi o qualsiasi dato che vuoi ispezionare. Puoi etichettare gli output per migliorare filtraggio e ricercabilità.
4. Esplora il rendering in-app: Ray rende i tuoi dati in un formato leggibile e strutturato. Usa filtri per tipo, origine o etichette personalizzate per restringere i risultati, e usa la funzione di ricerca per localizzare qualsiasi cosa tra tutti i messaggi.
5. Filtra, archivia e refine: Applica colori o etichette agli output, archivia i messaggi per riferimenti futuri e metti in pausa o misura l'esecuzione per isolare i problemi.
6. Salta al tuo IDE: Da un file dumpato, vai direttamente alla posizione rilevante nel tuo editor. Ray supporta molti IDE popolari per una navigazione rapida.
7. Sfrutta IA e componenti HTML: Usa le funzionalità IA di Ray per generare componenti HTML o prototipi, o spiegare dati complessi con diagrammi Mermaid/ERD.
8. Estendi e personalizza: Se Ray non supporta ancora una lingua o un framework di cui fai affidamento, estendi Ray tramite macro o crea un client personalizzato per inviare dati.
9. Distribuire in remoto, se necessario: Sfrutta il debugging remoto via SSH per monitorare e debuggare codice in esecuzione su server remoti.
10. Esplora e ottimizza: Usa pause, timing e strumenti di filtraggio per isolare problemi di prestazioni, riprodurre problemi e confrontare output tra esecuzioni.

Casi d'uso

• PHP e Laravel debugging: Output dei dati in tempo reale di PHP e Laravel direttamente in Ray, visualizza array e oggetti, e ispeziona query con etichettatura contestuale.
• Debugging JavaScript e frontend: Cattura output simili a console, risposte API ed eventi da Node.js o codice basato su browser, tutto in un unico posto.
• Debug remoto su server: Esegui il debug di codice su macchine remote via SSH, trasmettendo log e output in Ray per analisi in tempo reale.
• Sviluppo guidato dall'IA: Genera componenti HTML, prototipi o spiegazioni di schemi complessi con l'IA, e visualizza i risultati all'interno di Ray usando viewer integrati.
• Visualizzazione di database e schemi: Crea diagrammi Mermaid o ERD dai tuoi flussi di dati e query per comprendere meglio le relazioni nel database.
• Coerenza del flusso di debug: Mantieni un'esperienza di debug uniforme tra macOS, Windows e Linux, assicurando che i team restino allineati indipendentemente dall'ambiente.

FAQ

• Qual è il modello di prezzo e licenza? Ray offre una licenza desktop a pagamento. A partire dall'ultima versione, i prezzi sono mostrati al checkout, con una promozione di lancio a prezzo ridotto. Le licenze sono tipicamente valide per un periodo definito (ad es. 1 anno) e gestite tramite il sistema ufficiale di licenze (Spatie). Le licenze a vita sono menzionate come opzione, soggette ai termini vigenti. Le licenze acquistate prima di una versione maggiore possono rimanere valide secondo i termini precedenti.
• Quali piattaforme sono supportate? Ray è progettato per essere multipiattaforma e gira su macOS, Windows e Linux, offrendo un'esperienza di debug coerente su tutti gli ambienti desktop principali.
• Quali linguaggi e framework sono supportati? Ray supporta PHP, Laravel, JavaScript e linguaggi aggiuntivi tramite binding linguistici o client personalizzati. Il prodotto enfatizza una sintassi e un flusso di lavoro coerenti tra i linguaggi supportati.
• Posso debuggare da remoto o sui server? Sì. Ray supporta il debugging remoto via SSH, permettendoti di connetterti ai server remoti e trasmettere l'output di debug direttamente in Ray senza modificare localmente il tuo codice.
• Come funzionano la ricerca, i filtri e l'archiviazione? Puoi filtrare i messaggi per tipo, origine o etichette personalizzate, usare la ricerca per trovare elementi tra tutti i messaggi, e archiviare output importanti per riferimenti futuri o confronti. Questo aiuta a gestire grandi volumi di dati di debug in modo efficiente.
• C'è integrazione con IA e generazione HTML? Nuove funzionalità in Ray 3.0 consentono all'IA di generare componenti HTML e diagrammi, con un visualizzatore in-app per Mermaid e ERD. Puoi anche collegare gli output IA al tuo flusso di debug per insight migliori.
• Come posso iniziare? Scarica l'app Ray dal sito ufficiale, consulta la documentazione per i binding linguistici e inizia a inviare dati tramite le chiamate ray() nel tuo codice. Se hai bisogno di personalizzare o estendere Ray, puoi esplorare macro e client personalizzati.

Note aggiuntive: Ray enfatizza un flusso di lavoro che mantiene l'output di debug fuori dall'applicazione pur rendendo l'informazione accessibile, ricercabile e azionabile. L'obiettivo è fornire un ambiente di debugging potente, estendibile e multiplataforma che cresce con i tuoi progetti e team, mantenendo il tuo flusso di sviluppo.