Projekter og .restorm-filer
Et Restorm-projekt lever på din egen disk. Der er intet fjernarbejdsområde og ingen proprietær synkronisering: du åbner en fil, du gemmer den, du committer den.
To måder at gemme på
Section titled “To måder at gemme på”Én enkelt .restorm-fil
Section titled “Én enkelt .restorm-fil”Standardtilstanden (Fil ▸ Ny, derefter Gem som). Hele projektet ligger i
én fil, som standard i YAML. To andre serialiseringsformater er
tilgængelige: json og json5.
Mappetilstand
Section titled “Mappetilstand”Fil ▸ Åbn mappe. Projektet spredes ud i en mappestruktur på disken, hvilket giver langt finere diffs i store projekter:
- en konfigurationsfil
restorm.confi roden, som kun bærer formatet (format: yaml | json | json5); - én indeksfil pr. mappe (
index.yaml,index.json…); - mapper og filer med navnet
<index> - <name>, hvor indekset udfyldes med nuller op til søskendegruppens bredde, så rækkefølgen på skærmen er rækkefølgen på disken. Forbudte tegn (<>:"/\|?*) erstattes med_, og navnet afkortes til 100 tegn.
I mappetilstand skriver Ctrl+S kun undertræet for den aktive fane;
Ctrl+Shift+S (Gem alle) skriver det hele.
Hvad projektet indeholder
Section titled “Hvad projektet indeholder”- træet: mapper, miljømapper, anmodninger for alle protokoller, scenarier;
- miljøerne og deres variabler, inklusive undermiljøerne;
- de brugerdefinerede værdilister og de importerede enumerationer;
- tags og deres farver;
- den API-dokumentation, der er knyttet til miljømapperne;
- de hurtigindstillinger, der er gemt »i projektet«;
- et projekt-id (
_projectUuid) og en formatversion.
Hvad projektet ikke indeholder
Section titled “Hvad projektet ikke indeholder”Bevidst, så filen kan deles:
| Data | Hvor det lever |
|---|---|
| Hemmeligheder | En .env-fil med hemmeligheder ved siden af projektet — se Hemmeligheder |
| Svarhistorik | Et arkiv <project>.responses.zip, der ligger ved siden af projektet |
| Hurtigindstillinger på »bruger«-niveau | Dine lokale indstillinger |
| Favoritter | Programmets lokale lager, indekseret efter projekt-id |
| Workbench-layout | Dine lokale indstillinger, indekseret pr. projekt |
| Arbejdsområdeindstillinger | <project-folder>/.restorm/settings.json |
Den praktiske konsekvens: du kan committe en .restorm-fil uden at lække et
token, og din kollega arver ikke dit fanelayout.
En serialisering, der er bygget til git
Section titled “En serialisering, der er bygget til git”To garantier, som udelukkende findes for at gøre versionsstyring brugbar:
- Kanonisk nøglerækkefølge. Identitetsnøglerne kommer først (
id,name,key,type,folderType,method,url), resten sorteres. Rækkefølgen i arrays røres derimod aldrig: det er din rækkefølge. - Stabilt udledte id’er. En entitets id beregnes ud fra dens semantiske sti, ikke tilfældigt. To personer, der tilføjer samme anmodning på samme sted, får samme id, og det gør, at fletningen kan parre entiteterne korrekt.
Resultatet: at åbne et projekt og gemme det igen uden at ændre noget giver slet ingen diff. Se Indbygget Git.
Seneste projekter
Section titled “Seneste projekter”Fil ▸ Seneste filer viser de ti senest åbnede projekter; stier, der er blevet ugyldige, fjernes automatisk. Samme liste fodrer velkomstskærmen.