Bruno

Bruno est un logiciel (client) qui permet de tester des API REST et de mémoriser les requêtes avec les paramètres associées telle que les paramètres de questionnement, le token (JWT) d'accès pour les requêtes POST

Depuis la version 3.0, Bruno supporte OpenCollection pour décrire les collections/requêtes, dans des fichiers YAML au lieu des fichiers .bru précédemment utilisés !

Bruno a l'avantage d'enregistrer les collections et les requêtes sous forme de fichiers YAML, cela permet de facilement versionner ces fichiers et de les partager. Lors de la création d'une collection, il est important de bien définir le répertoire sont sauvegarder les fichiers de cette collection.

Du fait du versionnement, se pose la question de comment ne pas versionner les clés(JWT) et autres mots de passe. Il y a plusieurs solutions, dont celle de créer un fichier .env dans le répertoire de la collection, d'y mettre les secrets et dans les paramètres de la requête, au lieu de la valeur, de mettre

{{process.env.nom-de-la-clé-dans-le-fichier-env}}

On peut documenter les collections, il suffit d'éditer la partie Documentation de chaque collection

On peut aussi documenter chaque requêtes d'une collection en saisissant le texte dans l'onglet Docs

À partir d'une requête, on peut cliquer sur l'icone </> à droite de la barre de l'URL de la requête, puis dans la fenêtre Generate Code qui s'ouvre, sélectionner le language (Shell, JavaScript, Python…) et éventuellement la méthode (boutons à côté de la liste de choix), par exemple pour JavaScript : fetch, axios…

Lorsqu'on veut définir le chemin d'une collection, Bruno ouvre la fenêtre de l'explorateur d'Ubuntu (Files, nemo…) et on peut se retrouver avec des caractères illisibles.

La solution ¹⁾ consiste à vider le cache des polices de caractères :

sudo rm /var/cache/fontconfig/*
rm ~/.cache/fontconfig/*
fc-cache -r

• site officiel (EN)
• doc site officiel (EN)
• dépôt github (EN)

Contributeurs : bcag2