Benvenuti a OpenDev Explorer, la mia rubrica dedicata all’esplorazione del mondo Open Source che strizza un occchio alla developer experience. Io sono Riccardo (aka TheZal) e oggi vi parler\u00f2 di quello che potrebbe diventare il nuovo migliore amico di ogni backendista: Bruno, un bassotto a caccia di API.<\/p>\n\n\n\n
Oggi facciamo la conoscenza di Bruno, un API Client con il logo di un bassotto che ha come obiettivo quello di ridefinire il paradigma degli API Client corrente, sfidando i colossi del settore come Postman.<\/p>\n\n\n\n
Ma cosa rende Bruno speciale? Quelle che lo differenzia dagli altri sono le sue caratteristiche tra cui: il focus sulla privacy, la semplicit\u00e0 d’uso, l’introduzione di un nuovo markup language per la documentazione delle api e l’attenzione rivolta alla Developer Experience, ma procediamo con ordine!<\/p>\n\n\n\n
Bruno \u00e8 disponibile per Windows, macOS e Linux. Si pu\u00f2 scaricare dal sito ufficiale<\/a> o installarlo tramite il gestore di pacchetti del proprio sistema operativo usando uno dei seguenti comandi:<\/p>\n\n\n Inoltre \u00e8 disponibile anche come estensione per Visual Studio Code, cos\u00ec non dovrai lasciare il tuo IDE per intergaire con Bruno.<\/p>\n\n\n\n L’utilizzo \u00e8 molto semplice, una volta importata la collection (che pu\u00f2 essere di diversi tipi come Postman, Insomnia, OpenAPI, ecc.) si pu\u00f2 iniziare a fare richieste alle API. Per farlo basta cliccare sul pulsante “Send” e Bruno si occuper\u00e0 di tutto il resto.<\/p>\n\n\n\n Bruno, come detto sopra, utilizza un nuovo markup language proprietario, ovvero Bru.<\/p>\n\n\n\n Un semplicissimo esempio di un file Bru che fa una richiesta GET a un endpoint \u00e8 il seguente:<\/p>\n\n\n Come si pu\u00f2 notare, il file \u00e8 diviso in due sezioni: L’esempio \u00e8 preso direttamente dal loro repository di esempio su github disponibile qui<\/a>.<\/p>\n\n\n\n La developer experience con Bruno si distingue per l’uso innovativo del linguaggio Bru e per l’approccio al versioning della documentazione delle API. Bru \u00e8 un linguaggio di markup progettato specificatamente per il caso d’uso di Bruno e offre un modo efficiente e intuitivo per salvare le informazioni relative alle richieste API. Questo linguaggio, essendo plain text, si integra perfettamente con i sistemi di controllo versione come Git, permettendo agli sviluppatori di collaborare facilmente sulle API Collection.<\/p>\n\n\n\n Il versioning della documentazione delle API \u00e8 reso semplice e trasparente grazie a questa integrazione con i sistemi di version control. Gli sviluppatori possono tracciare le modifiche, collaborare e mantenere le versioni delle loro API collection in modo efficiente, garantendo che la documentazione sia sempre aggiornata e sincronizzata con l’ultima versione del codice. Questo approccio enfatizza l’importanza della privacy dei dati e la sicurezza, mantenendo tutte le informazioni in locale senza piani per una sincronizzazione cloud, in linea con la visione a lungo termine di Bruno per la privacy dei dati.<\/p>\n\n\n\n L’extra mile di Bruno \u00e8 rappresentato dalla sua attenzione alla privacy. Bruno \u00e8 un software open source che non richiede alcuna registrazione e non necessita di piani per una sincronizzazione cloud. Tutti i dati vengono salvati in locale e non vengono mai inviati a nessun server esterno. Questo garantisce la privacy dei dati e la sicurezza, mantenendo tutte le informazioni in locale coerentemente in linea con la visione a lungo termine di Bruno per la privacy dei dati.<\/p>\n\n\n\n Per saperne di pi\u00f9 sulla long-term vision di Bruno, \u00e8 possibile leggere il post su github<\/a> dedicato.<\/p>\n\n\n\n Bruno vuole quindi andare a ridefinire ci\u00f2 che \u00e8 attualmente lo standard per un API Client. Per farlo Bruno si concentra su alcuni punti chiave che andremo ad analizzare.<\/p>\n\n\n\n A differenza di Postman, Bruno decentralizza la gestione delle collection. Ci\u00f2 significa che non esiste un unico file, ma \u00e8 possibile salvarle in file separati permettendo di avere una migliore gestione, soprattutto quando si lavora in team. Bruno salva le collection in locale e grazie a questa scelta, \u00e8 possibile utilizzare Git per tenere traccia delle modifiche, delle versioni e collaborare facilmente con altri sviluppatori.<\/p>\n\n\n\n L’applicazione web di Postman effettua richieste API utilizzando un server proxy proprietario, ci\u00f2 implica che non hai il controllo sui tuoi dati e sei obbligato a utilizzare il loro server proxy per effettuare le richieste API, rappresentando un considerevole rischio per la sicurezza.<\/p>\n\n\n\n Bruno, invece, effettua richieste API direttamente dal tuo computer, offrendoti il pieno controllo sui tuoi dati e eliminando il rischio di sicurezza associato all’utilizzo di un server proxy.<\/p>\n\n\n\n Postman richiede quindi di essere connesso a internet, invece Bruno funziona offline, permettendoti di lavorare anche quando non sei connesso a internet.<\/p>\n\n\n\n Postman offre una funzionalit\u00e0 di collaborazione a pagamento per team, con un costo di partenza di $15 al mese per utente (dopo la versione gratuita per 3 utenti). Al contrario, Bruno \u00e8 completamente gratuito e open source. Puoi utilizzare Git o qualsiasi sistema di controllo delle versioni preferito per collaborare sulle tue raccolte API, senza alcun costo associato. Questa differenza sostanziale nella politica di prezzo rende Bruno un’opzione accessibile e aperta per la collaborazione sui progetti API.<\/p>\n\n\n\n Bruno quindi \u00e8 un API Client open source che si propone di ridefinire il paradigma degli API Client corrente, sfidando i colossi del settore come Postman da cui si distingue per il suo approccio alla privacy, per la semplicit\u00e0 d’uso e per l’attenzione rivolta alla developer experience. <\/p>\n\n\n\n Bruno \u00e8 disponibile per Windows, macOS e Linux e si pu\u00f2 scaricare dal sito ufficiale<\/a> o installarlo tramite il gestore di pacchetti del proprio sistema operativo.<\/p>\n\n\n\n Darete una chance a Bruno? Qui \u00e8 TheZal che vi saluta e vi aspetta al prossimo episodio di OpenDev Explorer!<\/p>\n","protected":false},"excerpt":{"rendered":"# Su Mac come Homebrew<\/span>\nbrew install bruno\n\n# Su Windows come Chocolatey<\/span>\nchoco install bruno\n\n# Su Linux tramite Snap<\/span>\nsnap install bruno\n\n# Su Linux tramite Apt<\/span>\nsudo mkdir -p \/etc\/apt\/keyrings\nsudo gpg --no-default<\/span>-keyring --keyring \/etc\/apt\/keyrings\/bruno.gpg --keyserver keyserver.ubuntu.com --recv-keys 9<\/span>FA6017ECABE0266\n\necho<\/span> \"deb [signed-by=\/etc\/apt\/keyrings\/bruno.gpg] http:\/\/debian.usebruno.com\/ bruno stable\"<\/span> | sudo tee \/etc\/apt\/sources.list<\/span>.d\/bruno.list<\/span>\n\nsudo apt update\nsudo apt install bruno<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\nL’utilizzo<\/h4>\n\n\n\n
meta {\n name<\/span>: Repository Info\n type<\/span>: http\n seq<\/span>: 2<\/span>\n}\n\nget<\/span> {\n url<\/span>: {{baseUrl}}\/repos\/usebruno\/bruno\n}<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\nmeta<\/code> e get<\/code>. La prima contiene le informazioni generali sulla richiesta, mentre la seconda contiene le informazioni specifiche per la richiesta GET. In questo caso, la richiesta viene fatta all’endpoint {{baseUrl}}\/repos\/usebruno\/bruno<\/code> dove {{baseUrl}}<\/code> \u00e8 una variabile definita dall’enviroment scelto nella gui di Bruno che verr\u00e0 sostituita con il valore corretto al momento dell’esecuzione.<\/p>\n\n\n\nLa developer experience<\/strong><\/h3>\n\n\n\n
L’extra mile<\/h2>\n\n\n\n
Il confronto con lo status quo<\/strong><\/h2>\n\n\n\n
Come e dove vengono salvate le collection<\/strong><\/h3>\n\n\n\n
Come vengono effettuate le richieste API<\/strong><\/h3>\n\n\n\n
Team collaboration<\/strong><\/h3>\n\n\n\n
Tiriamo le somme!<\/strong><\/h2>\n\n\n\n