Aller au contenu

Projektet dhe skedarët .restorm

Një projekt Restorm jeton në diskun tuaj. Nuk ka hapësirë pune të largët, as sinkronizim pronësor: ju hapni një skedar, e ruani dhe e bëni commit.

Modaliteti i parazgjedhur (Skedar ▸ I ri, pastaj Ruaj si). I gjithë projekti zë një skedar të vetëm, në YAML si parazgjedhje. Janë të disponueshme edhe dy formate të tjera serializimi: json dhe json5.

Skedar ▸ Hap dosjen. Projekti shpërndahet si strukturë pemësore në disk, gjë që jep diff-e shumë më të imta në projektet e mëdha:

  • një skedar konfigurimi restorm.conf në rrënjë, që mban vetëm formatin (format: yaml | json | json5);
  • një skedar indeksi për çdo drejtori (index.yaml, index.json…);
  • dosjet dhe skedarët të emërtuar <index> - <name>, ku indeksi plotësohet me zero sipas gjerësisë së grupit vëllazëror, që renditja në ekran të jetë renditja në disk. Karakteret e ndaluara (<>:"/\|?*) zëvendësohen me _ dhe emri shkurtohet në 100 karaktere.

Në modalitetin dosje, Ctrl+S shkruan vetëm nënpemën e skedës aktive; Ctrl+Shift+S (Ruaj të gjitha) shkruan gjithçka.

Një projekt i hapur në modalitetin dosje: pema majtas pasqyron hierarkinë e dosjes dhe shiriti i gjendjes tregon një dosje — jo një skedar .restorm.

  • pema: dosje, dosje variablash, kërkesa të të gjitha protokolleve, skenarë;
  • mjediset dhe variablat e tyre, përfshirë nënmjediset;
  • listat e vlerave të personalizuara dhe numërimet e importuara;
  • etiketat dhe ngjyrat e tyre;
  • dokumentacioni i API-së i bashkëngjitur dosjeve të variablave;
  • cilësimet e shpejta të ruajtura «në projekt»;
  • një identifikues projekti (_projectUuid) dhe një version formati.

Me qëllim, që skedari të jetë i ndashëm:

E dhënaKu jeton
SekretetNjë skedar .env sekretesh pranë projektit — shihni Sekretet
Historiku i përgjigjeveNjë arkiv <project>.responses.zip i vendosur pranë projektit
Cilësimet e shpejta «të përdoruesit»Rregullimet tuaja lokale
Të preferuaratRuajtja lokale e aplikacionit, e indeksuar sipas identifikuesit të projektit
Paraqitja e workbench-itRregullimet tuaja lokale, të indeksuara sipas projektit
Rregullimet e hapësirës së punës<project-folder>/.restorm/settings.json

Pasojë praktike: mund të bëni commit një .restorm pa nxjerrë jashtë asnjë token, dhe kolegu juaj nuk merr paraqitjen tuaj të skedave.

Dy garanci, që ekzistojnë vetëm që versionimi të jetë i përdorshëm:

  1. Renditje kanonike e çelësave. Çelësat e identitetit vijnë të parët (id, name, key, type, folderType, method, url), pjesa tjetër renditet. Renditja e vargjeve, nga ana e saj, nuk ndryshohet kurrë: është renditja juaj.
  2. Identifikues të nxjerrë në mënyrë të qëndrueshme. Identifikuesi i një entiteti llogaritet nga shtegu i tij semantik, nuk nxirret rastësisht. Dy persona që shtojnë të njëjtën kërkesë në të njëjtin vend prodhojnë të njëjtin identifikues, gjë që i lejon bashkimit t’i çiftëzojë entitetet siç duhet.

Rezultati: hapja dhe rimbajtja e një projekti pa ndryshuar asgjë nuk prodhon asnjë diff. Shihni Git-in e integruar.

Skedar ▸ Skedarët e fundit rendit dhjetë projektet e fundit të hapura; shtigjet që janë bërë të pavlefshme hiqen automatikisht. E njëjta listë ushqen edhe ekranin e mirëseardhjes.