Aller au contenu

Projekti i .restorm datoteke

Restorm projekat živi na vašem disku. Nema udaljenog radnog prostora, nema vlasničke sinhronizacije: otvorite datoteku, sačuvate je, commitujete je.

Podrazumevani režim (Datoteka ▸ Novo, pa Sačuvaj kao). Ceo projekat staje u jednu datoteku, podrazumevano u YAML-u. Dostupna su i dva druga formata serijalizacije: json i json5.

Datoteka ▸ Otvori fasciklu. Projekat je razložen u stablo na disku, što daje mnogo finije diff-ove na velikim projektima:

  • konfiguraciona datoteka restorm.conf u korenu, koja nosi samo format (format: yaml | json | json5);
  • po jedna indeksna datoteka za svaki direktorijum (index.yaml, index.json…);
  • fascikle i datoteke imenovane kao <index> - <naziv>, pri čemu je indeks dopunjen nulama do širine grupe braće, kako bi redosled na ekranu bio i redosled na disku. Zabranjeni znaci (<>:"/\|?*) zamenjuju se sa _, a naziv se skraćuje na 100 znakova.

U režimu fascikle Ctrl+S upisuje samo podstablo aktivne kartice; Ctrl+Shift+S (Sačuvaj sve) upisuje sve.

Projekat otvoren u režimu fascikle: stablo levo prati hijerarhiju fascikle, a statusna traka pokazuje na fasciklu — a ne na .restorm datoteku.

  • stablo: fascikle, fascikle promenljivih, zahteve svih protokola, scenarije;
  • okruženja i njihove promenljive, uključujući i podokruženja;
  • prilagođene liste vrednosti i uvezene enumeracije;
  • oznake i njihove boje;
  • API dokumentaciju priloženu uz fascikle promenljivih;
  • brza podešavanja sačuvana „u projektu”;
  • identifikator projekta (_projectUuid) i verziju formata.

Namerno, da bi datoteka bila deljiva:

PodatakGde živi
Tajne.env datoteka sa tajnama pored projekta — vidite Tajne
Istorija odgovoraArhiva <projet>.responses.zip smeštena pored projekta
„Korisnička” brza podešavanjaVaša lokalna podešavanja
OmiljenoLokalno skladište aplikacije, indeksirano po identifikatoru projekta
Raspored workbenchaVaša lokalna podešavanja, indeksirana po projektu
Podešavanja radnog prostora<dossier-du-projet>/.restorm/settings.json

Praktična posledica: možete da commitujete .restorm a da ne iznesete nijedan token, a vaš kolega ne dobija vaš raspored kartica.

Dve garancije, koje postoje isključivo da bi verzionisanje bilo upotrebljivo:

  1. Kanonski redosled ključeva. Ključevi identiteta dolaze na početku (id, name, key, type, folderType, method, url), ostatak je sortiran. Redosled nizova se, međutim, nikada ne menja: to je vaš redosled.
  2. Stabilno izvedeni identifikatori. Identifikator entiteta izračunava se iz njegove semantičke putanje, a ne nasumično. Dve osobe koje dodaju isti zahtev na istom mestu proizvode isti identifikator, što omogućava spajanju da ispravno upari entitete.

Rezultat: otvaranje pa ponovno čuvanje projekta bez ijedne izmene ne proizvodi nikakav diff. Vidite Ugrađeni git.

Datoteka ▸ Nedavne datoteke navodi poslednjih deset otvorenih projekata; putanje koje su postale nevažeće uklanjaju se automatski. Ista lista puni i ekran dobrodošlice.