Projektit ja .restorm-tiedostot
Restorm-projekti asuu omalla levylläsi. Etätyötilaa ei ole eikä omistajakohtaista synkronointia: avaat tiedoston, tallennat sen ja commitoit sen.
Kaksi tallennustapaa
Section titled “Kaksi tallennustapaa”Yksi .restorm-tiedosto
Section titled “Yksi .restorm-tiedosto”Oletustapa (Tiedosto ▸ Uusi ja sitten Tallenna nimellä). Koko projekti
mahtuu yhteen tiedostoon, oletuksena YAML-muodossa. Kaksi muuta
sarjallistusmuotoa on saatavilla: json ja json5.
Kansiotila
Section titled “Kansiotila”Tiedosto ▸ Avaa kansio. Projekti hajautetaan puurakenteeksi levylle, mikä tuottaa suurissa projekteissa paljon tarkempia diffejä:
- juuressa oleva kokoonpanotiedosto
restorm.conf, joka kantaa vain muodon (format: yaml | json | json5); - indeksitiedosto jokaisessa hakemistossa (
index.yaml,index.json…); - kansiot ja tiedostot nimettyinä muotoon
<index> - <name>, jossa indeksi täytetään nollilla sisarusjoukon leveyteen, jotta järjestys näytöllä on sama kuin levyllä. Kielletyt merkit (<>:"/\|?*) korvataan merkillä_ja nimi katkaistaan 100 merkkiin.
Kansiotilassa Ctrl+S kirjoittaa vain aktiivisen välilehden alipuun;
Ctrl+Shift+S (Tallenna kaikki) kirjoittaa koko kokonaisuuden.
Mitä projekti sisältää
Section titled “Mitä projekti sisältää”- puun: kansiot, muuttujakansiot, kaikkien protokollien pyynnöt, skenaariot;
- ympäristöt ja niiden muuttujat, aliympäristöt mukaan lukien;
- mukautetut arvoluettelot ja tuodut luettelotyypit;
- tagit ja niiden värit;
- muuttujakansioihin liitetyn API-dokumentaation;
- ”projektiin” tallennetut pika-asetukset;
- projektin tunnisteen (
_projectUuid) ja muotoversion.
Mitä projekti ei sisällä
Section titled “Mitä projekti ei sisällä”Tarkoituksella, jotta tiedosto olisi jaettavissa:
| Tieto | Missä se asuu |
|---|---|
| Salaisuudet | Salaisuuksien .env-tiedosto projektin vieressä — katso Salaisuudet |
| Vastaushistoria | Projektin viereen sijoitettu arkisto <project>.responses.zip |
| ”Käyttäjä”-pika-asetukset | Paikalliset asetuksesi |
| Suosikit | Sovelluksen paikallinen tallennus, indeksoituna projektin tunnisteen mukaan |
| Workbenchin asettelu | Paikalliset asetuksesi, indeksoituna projektin mukaan |
| Työtilan asetukset | <project-folder>/.restorm/settings.json |
Käytännön seuraus: voit commitoida .restorm-tiedoston vuotamatta tokenia,
eikä työtoverisi saa välilehtiasetteluasi.
Gitiä varten tehty sarjallistus
Section titled “Gitiä varten tehty sarjallistus”Kaksi takuuta, jotka ovat olemassa vain siksi, että versionhallinta olisi käyttökelpoinen:
- Kanoninen avainjärjestys. Identiteettiavaimet tulevat ensin (
id,name,key,type,folderType,method,url), loput lajitellaan. Taulukoiden järjestystä ei sen sijaan koskaan muuteta: se on sinun järjestyksesi. - Vakaasti johdetut tunnisteet. Entiteetin tunniste lasketaan sen semanttisesta polusta, sitä ei arvota. Kaksi henkilöä, jotka lisäävät saman pyynnön samaan paikkaan, tuottavat saman tunnisteen, minkä ansiosta yhdistys osaa parittaa entiteetit oikein.
Tulos: projektin avaaminen ja uudelleen tallentaminen ilman muutoksia ei tuota lainkaan diffiä. Katso Sisäänrakennettu git.
Viimeisimmät projektit
Section titled “Viimeisimmät projektit”Tiedosto ▸ Viimeisimmät tiedostot luettelee kymmenen viimeksi avattua projektia; kelvottomiksi muuttuneet polut poistetaan automaattisesti. Sama luettelo syöttää aloitusnäytön.