Projektek és .restorm fájlok
Egy Restorm-projekt a saját lemezen él. Nincs távoli munkaterület, nincs zárt szinkronizáció: a fájl megnyitható, elmenthető, commitolható.
A .restorm fájl
Section titled “A .restorm fájl”A Restorm-projekt egyetlen fájl (Fájl ▸ Új, majd Mentés másként), alapból
YAML formátumban. Két további sorosítási formátum is rendelkezésre áll:
json és json5.
Amit a projekt tartalmaz
Section titled “Amit a projekt tartalmaz”- a fát: mappák, változómappák, minden protokoll kérései, forgatókönyvek;
- a környezeteket és a változóikat, az alkörnyezetekkel együtt;
- az egyéni értéklistákat és az importált enumerációkat;
- a címkéket és a színeiket;
- a változómappákhoz csatolt API-dokumentációt;
- a „projektbe” mentett gyorsbeállításokat;
- egy projektazonosítót (
_projectUuid) és egy formátumverziót.
Amit a projekt nem tartalmaz
Section titled “Amit a projekt nem tartalmaz”Szándékosan, hogy a fájl megosztható maradjon:
| Adat | Hol él |
|---|---|
| Titkok | A projekt mellett álló .env titokfájlban — lásd: Titkok |
| Válaszok előzményei | A projekt mellé helyezett <project>.responses.zip archívumban |
| „Felhasználói” gyorsbeállítások | A helyi beállításokban |
| Kedvencek | Az alkalmazás helyi tárolójában, projektazonosító szerint indexelve |
| A workbench elrendezése | A helyi beállításokban, projektenként indexelve |
| Munkaterület-beállítások | <project-folder>/.restorm/settings.json |
Gyakorlati következmény: egy .restorm fájl commitolható anélkül, hogy token
szivárogna ki, a kollégához pedig nem jut el a lapelrendezés.
Git-re szabott sorosítás
Section titled “Git-re szabott sorosítás”Két garancia, amely kizárólag azért létezik, hogy a verziókezelés használható legyen:
- Kanonikus kulcssorrend. Az identitáskulcsok kerülnek előre (
id,name,key,type,folderType,method,url), a többi rendezve követi őket. A tömbök sorrendje viszont soha nem módosul: az a felhasználó sorrendje. - Stabilan származtatott azonosítók. Egy entitás azonosítója a szemantikus útvonalából számítódik, nem véletlenszerűen jön. Két ember, aki ugyanazt a kérést ugyanoda adja hozzá, ugyanazt az azonosítót állítja elő, ami lehetővé teszi, hogy az összefésülés helyesen párosítsa az entitásokat.
Az eredmény: egy projekt megnyitása, majd változtatás nélküli újramentése semmilyen diffet nem eredményez. Lásd: Beépített git.
Legutóbbi projektek
Section titled “Legutóbbi projektek”A Fájl ▸ Legutóbbi fájlok felsorolja a tíz utoljára megnyitott projektet; az érvénytelenné vált útvonalak automatikusan kikerülnek belőle. Ugyanez a lista táplálja a kezdőképernyőt is.