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.
.restorm-filen
Section titled “.restorm-filen”Et Restorm-projekt er én enkelt fil (Fil ▸ Ny, derefter Gem som), som
standard i YAML. To andre serialiseringsformater er tilgængelige: json og
json5.
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.