Projekte und .restorm-Dateien
Ein Restorm-Projekt lebt auf Ihrer Festplatte. Es gibt keinen entfernten Arbeitsbereich, keine proprietäre Synchronisierung: Sie öffnen eine Datei, speichern sie, committen sie.
Die .restorm-Datei
Section titled “Die .restorm-Datei”Ein Restorm-Projekt ist eine einzige Datei (Datei ▸ Neu, dann Speichern
unter), standardmäßig im YAML-Format. Zwei weitere Serialisierungsformate
sind verfügbar: json und json5.
Was das Projekt enthält
Section titled “Was das Projekt enthält”- den Baum: Ordner, Variablenordner, Anfragen aller Protokolle, Szenarien;
- die Umgebungen und ihre Variablen, einschließlich der Unterumgebungen;
- die benutzerdefinierten Wertelisten und importierte Enumerationen;
- die Tags und ihre Farben;
- die API-Dokumentation, die an Variablenordner angehängt ist;
- die als „im Projekt“ gespeicherten Schnelleinstellungen;
- eine Projektkennung (
_projectUuid) und eine Formatversion.
Was das Projekt nicht enthält
Section titled “Was das Projekt nicht enthält”Absichtlich, damit die Datei teilbar bleibt:
| Daten | Wo sie leben |
|---|---|
| Secrets | Eine Secrets-Datei .env neben dem Projekt – siehe Secrets |
| Antwortverlauf | Ein Archiv <project>.responses.zip, das neben dem Projekt abgelegt wird |
| „Benutzerbezogene“ Schnelleinstellungen | Ihre lokalen Einstellungen |
| Favoriten | Der lokale Speicher der Anwendung, indiziert nach Projektkennung |
| Anordnung des Arbeitsbereichs | Ihre lokalen Einstellungen, indiziert nach Projekt |
| Arbeitsbereichseinstellungen | <project-folder>/.restorm/settings.json |
Praktische Konsequenz: Sie können eine .restorm-Datei committen, ohne ein
Token preiszugeben, und Ihr Kollege bekommt nicht Ihre Tab-Anordnung
mitgeliefert.
Eine für Git gemachte Serialisierung
Section titled “Eine für Git gemachte Serialisierung”Zwei Garantien, die einzig und allein dafür sorgen, dass die Versionierung nutzbar ist:
- Kanonische Schlüsselreihenfolge. Die Identitätsschlüssel stehen
vorne (
id,name,key,type,folderType,method,url), der Rest ist sortiert. Die Reihenfolge der Arrays hingegen wird nie verändert: Das ist Ihre Reihenfolge. - Stabil abgeleitete Kennungen. Die Kennung einer Entität wird aus ihrem semantischen Pfad berechnet, nicht zufällig vergeben. Zwei Personen, die dieselbe Anfrage an derselben Stelle hinzufügen, erzeugen dieselbe Kennung, was es dem Merge erlaubt, die Entitäten korrekt einander zuzuordnen.
Ergebnis: Ein Projekt zu öffnen und ohne Änderung erneut zu speichern erzeugt keinerlei Diff. Siehe Integriertes Git.
Zuletzt geöffnete Projekte
Section titled “Zuletzt geöffnete Projekte”Datei ▸ Zuletzt geöffnete Dateien listet die letzten zehn geöffneten Projekte auf; ungültig gewordene Pfade werden automatisch entfernt. Dieselbe Liste speist auch den Startbildschirm.