LU07d - Bruno
Bruno ist ein Open-Source-Tool zum Entwickeln und Testen von Programmierschnittstellen (API). Im Unterricht nutzen wir Bruno, um die API einer Webapplikation zu testen.
Bruno ermöglicht es uns, API-Tests zu definieren und manuell oder automatisiert durchzuführen. Da alle Testfälle als Textdateien gespeichert werden, können sie sehr einfach versioniert (z. B. mit Git) und geteilt werden.
Bruno nutzen
Bruno ist vollständig gratis und benötigt kein Benutzerkonto. Alle Daten liegen lokal in deinem Projektordner und können von dir in ein Git-Repository aufgenommen werden.
Du kannst Bruno für Windows, macOS und Linux herunterladen und installieren. Eine Web-Version gibt es bewusst nicht, da Bruno auf lokale Dateien setzt.
Wichtige Begriffe
Workspace
In Bruno gibt es keinen „Cloud-Workspace“ wie bei Postman. Ein Workspace entspricht einfach einem lokalen Projektordner auf deinem Computer. Alles, was du anlegst, liegt darin als Dateien vor.
Collection
Eine Collection ist in Bruno ein Unterordner innerhalb deines Workspaces. Jede Collection steht für eine Applikation oder ein Projekt, das du testen willst.
Request
Ein Request ist eine einzelne `.bru`-Datei. Darin stehen alle Informationen zu deinem API-Aufruf (Methode, URL, Header, Body). Zusätzlich kannst du in der Request-Datei auch Tests und Pre-Request-Scripts in Javascript definieren.
Environment
In Bruno sind Environments einfache JSON-Dateien (z. B. `dev.json`, `prod.json`), in denen Variablen gespeichert sind. So kannst du denselben Request mit verschiedenen Umgebungen ausführen, ohne jedes Mal die URL oder die Tokens manuell anzupassen.
Tests
Tests sind kleine Javascript-Skripte, die du direkt in einer `.bru`-Datei anlegst. Sie verwenden die `expect()`-Syntax, um Antworten der API automatisch zu überprüfen (z. B. Statuscode = 200).
Dokumentation
Im Bruno Docs findest du alle Funktionen von Bruno beschrieben und mit Beispielen erklärt.