Gå til innholdet

Prosjekter og .restorm-filer

Et Restorm-prosjekt lever på din egen disk. Det finnes ingen ekstern arbeidsflate og ingen proprietær synkronisering: du åpner en fil, du lagrer den, du committer den.

Standardmodusen (Fil ▸ Ny, deretter Lagre som). Hele prosjektet ligger i én eneste fil, som standard i YAML. To andre serialiseringsformater er tilgjengelige: json og json5.

Fil ▸ Åpne mappe. Prosjektet spres ut som et tre på disken, noe som gir langt finere differ på store prosjekter:

  • en konfigurasjonsfil restorm.conf i roten, som bare bærer formatet (format: yaml | json | json5);
  • én indeksfil per katalog (index.yaml, index.json …);
  • mapper og filer navngitt <index> - <name>, der indeksen fylles med nuller opp til bredden av søskengruppen, slik at rekkefølgen på skjermen er rekkefølgen på disken. Ulovlige tegn (<>:"/\|?*) erstattes med _, og navnet kuttes ved 100 tegn.

I mappemodus skriver Ctrl+S bare undertreet til den aktive fanen; Ctrl+Shift+S (Lagre alle) skriver alt.

Et prosjekt åpnet i mappemodus: treet til venstre gjenspeiler mappehierarkiet, og statuslinjen peker på en mappe — ikke på en .restorm-fil.

  • treet: mapper, miljømapper, forespørsler for alle protokoller, scenarioer;
  • miljøene og variablene deres, inkludert undermiljøene;
  • de egendefinerte verdilistene og de importerte enumerasjonene;
  • taggene og fargene deres;
  • API-dokumentasjonen som er knyttet til miljømappene;
  • hurtiginnstillingene som er lagret «i prosjektet»;
  • en prosjekt-ID (_projectUuid) og en formatversjon.

Bevisst utelatt, slik at filen kan deles:

DataHvor det ligger
HemmeligheterEn .env-fil med hemmeligheter ved siden av prosjektet — se Hemmeligheter
SvarhistorikkEt <project>.responses.zip-arkiv plassert ved siden av prosjektet
Hurtiginnstillinger av typen «bruker»Dine lokale innstillinger
FavoritterApplikasjonens lokale lager, indeksert etter prosjekt-ID
Workbench-oppsettDine lokale innstillinger, indeksert etter prosjekt
Arbeidsområdeinnstillinger<project-folder>/.restorm/settings.json

Den praktiske konsekvensen: du kan committe en .restorm uten å lekke et token, og kollegaen din arver ikke faneoppsettet ditt.

To garantier, som bare finnes for at versjonskontroll skal være brukbart:

  1. Kanonisk nøkkelrekkefølge. Identitetsnøklene kommer først (id, name, key, type, folderType, method, url), resten sorteres. Rekkefølgen i tabeller endres derimot aldri: det er din rekkefølge.
  2. Stabilt utledede identifikatorer. IDen til en entitet beregnes fra dens semantiske sti, ikke trukket tilfeldig. To personer som legger til samme forespørsel på samme sted, produserer samme ID, og det er dette som lar sammenslåingen parre entitetene riktig.

Resultatet: å åpne og lagre et prosjekt på nytt uten å endre noe gir ingen diff i det hele tatt. Se Innebygd git.

Fil ▸ Nylige filer lister de ti sist åpnede prosjektene; stier som er blitt ugyldige, fjernes automatisk. Den samme listen mater velkomstskjermen.