Hoppa till innehåll

Projekt och .restorm-filer

Ett Restorm-projekt bor på din disk. Det finns ingen fjärrarbetsyta och ingen proprietär synkronisering: du öppnar en fil, du sparar den, du lägger den i en commit.

Ett Restorm-projekt är en enda fil (Arkiv ▸ Ny, sedan Spara som), i YAML som standard. Två andra serialiseringsformat finns tillgängliga: json och json5.

  • trädet: mappar, variabelmappar, begäranden för alla protokoll, scenarier;
  • miljöerna och deras variabler, inklusive undermiljöerna;
  • de anpassade värdelistorna och de importerade uppräkningarna;
  • taggarna och deras färger;
  • API-dokumentationen som är kopplad till variabelmapparna;
  • de snabbinställningar som sparats ”i projektet”;
  • en projektidentifierare (_projectUuid) och en formatversion.

Med avsikt, så att filen ska gå att dela:

DataVar den bor
HemligheterEn .env-fil med hemligheter vid sidan av projektet — se Hemligheter
SvarshistorikEtt arkiv <projekt>.responses.zip som läggs vid sidan av projektet
Snabbinställningar av typen ”användare”Dina lokala inställningar
FavoriterApplikationens lokala lagring, indexerad per projektidentifierare
Workbench-layoutDina lokala inställningar, indexerade per projekt
Arbetsyteinställningar<projektmapp>/.restorm/settings.json

Praktisk konsekvens: du kan lägga en .restorm i en commit utan att läcka en token, och din kollega får inte din flikuppställning.

Två garantier, som bara finns för att versionshanteringen ska gå att använda:

  1. Kanonisk nyckelordning. Identitetsnycklarna kommer först (id, name, key, type, folderType, method, url), resten sorteras. Ordningen i listorna ändras däremot aldrig: den är din.
  2. Identifierare som härleds på ett stabilt sätt. En entitets identifierare beräknas från dess semantiska sökväg, den slumpas inte fram. Två personer som lägger till samma begäran på samma plats får samma identifierare, vilket gör att sammanslagningen kan parhopa entiteterna korrekt.

Resultat: att öppna och spara om ett projekt utan att ändra något ger ingen diff alls. Se Inbyggd git.

Arkiv ▸ Senaste filer listar de tio senast öppnade projekten; sökvägar som blivit ogiltiga tas bort automatiskt. Samma lista matar välkomstskärmen.