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.
Två lagringslägen
Section titled “Två lagringslägen”En enda .restorm-fil
Section titled “En enda .restorm-fil”Standardläget (Arkiv ▸ Ny, sedan Spara som). Hela projektet ryms i en
enda fil, i YAML som standard. Två andra serialiseringsformat finns
tillgängliga: json och json5.
Mappläge
Section titled “Mappläge”Arkiv ▸ Öppna en mapp. Projektet delas upp i ett träd på disken, vilket ger mycket finare diffar i stora projekt:
- en konfigurationsfil
restorm.confi roten, som bara innehåller formatet (format: yaml | json | json5); - en indexfil per katalog (
index.yaml,index.json…); - mappar och filer med namnet
<index> - <namn>, där indexet fylls ut med nollor till syskonskarans bredd så att ordningen på skärmen är ordningen på disken. Otillåtna tecken (<>:"/\|?*) ersätts med_och namnet kapas vid 100 tecken.
I mappläge skriver Ctrl+S bara det underträd som hör till den aktiva fliken;
Ctrl+Shift+S (Spara allt) skriver alltihop.
Vad projektet innehåller
Section titled “Vad projektet innehåller”- 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.
Vad projektet inte innehåller
Section titled “Vad projektet inte innehåller”Med avsikt, så att filen ska gå att dela:
| Data | Var den bor |
|---|---|
| Hemligheter | En .env-fil med hemligheter vid sidan av projektet — se Hemligheter |
| Svarshistorik | Ett arkiv <projekt>.responses.zip som läggs vid sidan av projektet |
| Snabbinställningar av typen ”användare” | Dina lokala inställningar |
| Favoriter | Applikationens lokala lagring, indexerad per projektidentifierare |
| Workbench-layout | Dina 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.
En serialisering gjord för git
Section titled “En serialisering gjord för git”Två garantier, som bara finns för att versionshanteringen ska gå att använda:
- 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. - 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.
Senaste projekt
Section titled “Senaste projekt”Arkiv ▸ Senaste filer listar de tio senast öppnade projekten; sökvägar som blivit ogiltiga tas bort automatiskt. Samma lista matar välkomstskärmen.