{"id":28087,"date":"2024-06-06T15:11:32","date_gmt":"2024-06-06T13:11:32","guid":{"rendered":"https:\/\/www.codemotion.com\/magazine\/?p=28087"},"modified":"2024-06-06T15:11:34","modified_gmt":"2024-06-06T13:11:34","slug":"le-api-di-bruno-bruno-vs-postman","status":"publish","type":"post","link":"https:\/\/www.codemotion.com\/magazine\/it\/backend-it\/le-api-di-bruno-bruno-vs-postman\/","title":{"rendered":"Le API di Bruno \u2013 Bruno vs Postman"},"content":{"rendered":"\n

Bruno \u00e8 un API Client open source che<\/strong>, ormai da qualche tempo, si sta rapidamente diffondendo, guadagnando terreno nei confronti del popolarissimo Postman<\/strong>.<\/p>\n\n\n\n

Si tratta di un progetto che vuole crescere con il supporto della propria Community, senza la partecipazione di aziende terze (se non come sponsor) e, soprattutto, con la forte volont\u00e0 di non farsi acquisire. Insomma, vogliono camminare con le loro gambe, mantenendo la propria identit\u00e0, accettando aiuti esterni, senza per\u00f2 permettere alcuna interferenza nella gestione del progetto. <\/p>\n\n\n\n

Di questi tempi \u00e8 certamente un nobile intento, auguriamoci che duri.<\/p>\n\n\n\n

Perch\u00e9 Bruno<\/h2>\n\n\n\n

Non so per voi ma, per me, Postman \u00e8 da sempre sinonimo di \u201caffidabilit\u00e0\u201d e \u201cabitudine\u201d: nonostante alcuni piccoli dettagli (ad esempio il non poter modificare le request se non attraverso la sua interfaccia) l\u2019ho sempre trovato adatto a quelle che sono le mie esigenze. La mia caratteristica pigrizia ha fatto il resto: tutte le mie collection sono li da tempo immemore, e pensare di riorganizzarle altrove mi ha sempre fatto accapponare la pelle.<\/p>\n\n\n\n

Tutto perfetto, dunque, finch\u00e9 non mi sono trovato nella condizione di dover condividere \u201cseriamente\u201d le mie request con il Team, per un\u2019effettiva collaborazione: tra i costi per la subscription e la gestione condivisa delle chiamate, che richiede \u2013 come ogni inizio \u2013 frequentissime variazioni, la mia perplessit\u00e0 cresceva quotidianamente\u2026<\/p>\n\n\n\n

E poi arriva Bruno (mi ricorda tanto il titolo di un film\u2026), che con la sua semplicit\u00e0 architetturale cattura immediatamente la mia attenzione,<\/strong> spingendomi addirittura ad importare alcune collection di Postman.<\/p>\n\n\n\n

In questo post, provo a riepilogare i punti di \u201ccontatto\u201d (o, se preferite, di \u201cattrito\u201d) tra i due concorrenti, analizzandoli da entrambi i punti di vista per arrivare a decretare \u2013 ancorch\u00e9 possibile \u2013 il vincitore di questa sfida. Iniziamo!<\/p>\n\n\n\n

Salvataggio delle Configurazioni<\/h3>\n\n\n\n

Mentre Postman salva le configurazioni di collection e request nel suo Cloud, Bruno le salva sul filesystem della macchina locale, nei suoi files \u201cbru\u201d. Sebbene questa possa sembrare cosa da poco, \u00e8 in realt\u00e0 una differenza enorme che si ripercuote pesantemente sul tema della collaborazione (di cui parleremo pi\u00f9 avanti), dell\u2019usabilit\u00e0 e della privacy.<\/p>\n\n\n\n

In termini di usabilit\u00e0, per modificare collection e request, oltre alla UI di Bruno, possiamo modificare direttamente i files di configurazione (i \u201c.bru\u201d per l\u2019appunto) che, nella loro versione pi\u00f9 semplice, sono simili al seguente:<\/p>\n\n\n\n

\"A<\/figure>\n\n\n\n

Un ottimo editor che mi sento di consigliarvi (ancorch\u00e9 ve ne sia necessit\u00e0) per l\u2019editing dei files Bru \u00e8 Visual Studio Code, per il quale (guarda il caso, alle volte) esiste l\u2019extension denominata \u201cBruno\u201d che implementa la syntax highlighting per facilitarne la gestione.<\/p>\n\n\n\n

Si aggiunga che Bruno non ha un proprio Cloud (e, stando al loro Manifest, \u00e8 molto probabile che non l\u2019avr\u00e0 mai) per cui la persistenza delle configurazioni \u00e8 totalmente a carico dell\u2019utente: quindi, considerando che i files di configurazione delle collection e delle request risiedono solo sul filesystem delle nostre macchine, la privacy \u00e8 garantita al 100%. La loro eventuale condivisione \u00e8 esclusivamente nelle nostre mani.<\/p>\n\n\n\n

Collaborazione<\/h3>\n\n\n\n

In netta contrapposizione alla filosofia di Postman, che persiste le nostre configurazioni in qualche indefinito angolo del suo Cloud, abbiamo visto che, in Bruno, le definizioni delle request (e collection) risiedono sul nostro filesystem locale, e sono rappresentate da file di testo in formato Bru.<\/p>\n\n\n\n

Quindi, se \u00e8 vero che in Postman posso fare un backup esportando la mia collection, \u00e8 altrettando vero che in Bruno posso facilmente trasformare la mia struttura su filesystem in un repository Git (o SVN, o Mercurial\u2026) per pusharlo su BitBucket, GitHub o GitLab (e chi pi\u00f9 ne ha pi\u00f9 ne metta).<\/p>\n\n\n\n

Abbiamo appena implementato la condivisione a livello di Team!!<\/p>\n\n\n\n

Mentre Postman ci obbliga ad acquistare licenze per Teams composti da pi\u00f9 di 3 Utenti (ed i prezzi non sono esattamente \u201cpopolari\u201d), Bruno ci offre gratuitamente questa stessa possibilit\u00e0 \u201cout-of-the-box\u201d, senza alcun limite: sta a noi decidere cosa (e con chi) condividere le request. Non \u00e8 meraviglioso? <\/p>\n\n\n\n

Online? Offline!<\/h3>\n\n\n\n

Devo ammettere che non mi sono mai accorto di questo dettaglio, in quanto la mia quotidianit\u00e0 mi porta ad essere sempre connesso, ma- a quanto pare \u2013 Postman funziona solo in modalit\u00e0 \u201conline\u201d. Quindi, non si avvia se non ha la possibilit\u00e0 di contattare i suoi server (ma perch\u00e9?!?!).<\/p>\n\n\n\n

Al contrario, Bruno non ha alcuna necessit\u00e0 di connessione<\/strong>, in quanto tutto ci\u00f2 di cui ha bisogno risiede sul filesystem locale. Questo significa che \u00e8 possibile, in fase di sviluppo di un servizio, effettuare chiamate all\u2019ambiente locale anche se siete isolati dal resto del mondo.\u00a0<\/p>\n\n\n\n

Questo \u00e8 un altro \u201cdettaglio\u201d che va a consolidare ulteriormente il rispetto che Bruno ha per la nostra privacy.<\/p>\n\n\n\n

Uso di Librerie Esterne<\/h3>\n\n\n\n

Per un Dev, l\u2019utilizzo di librerie esterne rappresenta la normalit\u00e0 (la ruota ed il fuoco li hanno gi\u00e0 inventati da tempo, non serve reinventarli) e trova un senso anche in questo contesto.<\/p>\n\n\n\n

Sia Postman che Bruno offrono librerie precaricate, immediatamente fruibili, che sono in grado di coprire la maggior parte delle nostre esigenze, ad esempio:<\/p>\n\n\n\n

Postman<\/em><\/strong><\/td>Libreria<\/em><\/strong><\/td>Bruno<\/em><\/strong><\/td><\/tr>
X<\/td>ajv<\/td>X<\/td><\/tr>
<\/td>axios<\/td>X<\/td><\/tr>
<\/td>node-fetch<\/td>X<\/td><\/tr>
X<\/td>atob<\/td>X<\/td><\/tr>
X<\/td>btoa<\/td>X<\/td><\/tr>
X<\/td>chai<\/td>X<\/td><\/tr>
X<\/td>lodash<\/td>X<\/td><\/tr>
X<\/td>moment<\/td>X<\/td><\/tr>
X<\/td>uuid<\/td>X<\/td><\/tr>
<\/td>nanoid<\/td>X<\/td><\/tr>
X<\/td>crypto-js<\/td>X<\/td><\/tr>
X<\/td>cheerio<\/td><\/td><\/tr>
X<\/td>csv-parse<\/td><\/td><\/tr>
X<\/td>tv4<\/td><\/td><\/tr>
X<\/td>xml2js<\/td><\/td><\/tr>
X<\/td>postman-collection<\/td><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Postman non sembra \u201cstrutturato\u201d per accogliere librerie esterne nel suo ecosistema. Le alternative per farlo sono sostanzialmente due:<\/p>\n\n\n\n

    \n
  1. Via script, scaricare la libreria da un CDN ed eseguire la funzione eval sulla stringa restituita. A seconda di dove viene posta questa chiamata, la libreria \u00e8 scaricata a ogni esecuzione di request o test.<\/li>\n\n\n\n
  2. Porre il codice sorgente della libreria in una variabile a livello di collection (o environment) e invocare una \u201canonymous function\u201d per ottenere l\u2019accesso ai suoi metodi.<\/li>\n<\/ol>\n\n\n\n

    Sicuramente \u00e8 pi\u00f9 facile a farsi che a dirsi ma, a parer mio, \u00e8 un po\u2019 complesso.<\/p>\n\n\n\n

    In Bruno le cose sono molto pi\u00f9 semplici: la prima cosa da fare \u00e8 quella di creare il file package.json con le librerie che vogliamo includere e metterlo nella root del nostro progetto:<\/p>\n\n\n\n

    \"A<\/figure>\n\n\n\n

    Poi, come se fosse un qualunque progetto NodeJS, installiamo le dipendenze:<\/p>\n\n\n\n

    npm install<\/p>\n\n\n\n

    Da questo momento, le librerie sono a nostra disposizione e possiamo usarle ovunque, nell\u2019ambito della nostra collection.<\/p>\n\n\n\n

    Scripting<\/h3>\n\n\n\n

    Bruno, come Postman, offre la possibilit\u00e0 di customizzare le chiamate nei seguenti eventi:<\/p>\n\n\n\n