Projekty a soubory .restorm

Projekt Restorm žije na vašem disku. Neexistuje žádný vzdálený pracovní prostor ani proprietární synchronizace: soubor otevřete, uložíte a commitnete.

Dva režimy ukládání

Jediný soubor .restorm

Výchozí režim (Soubor ▸ Nový, potom Uložit jako). Celý projekt se vejde do jednoho souboru, ve výchozím stavu v YAML. K dispozici jsou další dva serializační formáty: json a json5.

Režim složky

Soubor ▸ Otevřít složku. Projekt je na disku rozložen do stromu, což u velkých projektů dává mnohem podrobnější diffy:

• konfigurační soubor restorm.conf v korunu projektu, který nese pouze formát (format: yaml | json | json5);
• indexový soubor v každém adresáři (index.yaml, index.json…);
• složky a soubory pojmenované <index> - <nom>, kde je index doplněn nulami na šířku dané skupiny sourozenců, aby pořadí na obrazovce odpovídalo pořadí na disku. Zakázané znaky (<>:"/\|?*) se nahradí _ a název se zkrátí na 100 znaků.

V režimu složky Ctrl+S zapíše jen podstrom aktivní karty; Ctrl+Shift+S (Uložit vše) zapíše celek.

Co projekt obsahuje

• strom: složky, složky proměnných, požadavky všech protokolů, scénáře;
• prostředí a jejich proměnné, včetně podprostředí;
• vlastní seznamy hodnot a naimportované výčtové typy;
• štítky a jejich barvy;
• dokumentaci API připojenou ke složkám proměnných;
• rychlá nastavení uložená „do projektu“;
• identifikátor projektu (_projectUuid) a verzi formátu.

Co projekt neobsahuje

Záměrně, aby byl soubor sdílitelný:

Data	Kde žijí
Tajemství	Soubor .env s tajemstvími vedle projektu — viz Tajemství
Historie odpovědí	Archiv <projet>.responses.zip umístěný vedle projektu
Rychlá nastavení „uživatele“	Vaše lokální nastavení
Oblíbené	Lokální úložiště aplikace, indexované podle identifikátoru projektu
Rozvržení workbenchu	Vaše lokální nastavení, indexovaná podle projektu
Nastavení pracovního prostoru	<dossier-du-projet>/.restorm/settings.json

Praktický důsledek: soubor .restorm můžete commitnout, aniž byste vyzradili token, a váš kolega nedostane vaše rozvržení karet.

Serializace udělaná pro git

Dvě záruky, které existují výhradně proto, aby bylo verzování použitelné:

1. Kanonické pořadí klíčů. Identifikační klíče jdou první (id, name, key, type, folderType, method, url), zbytek je seřazený. Pořadí v polích se naopak nikdy nemění: je to vaše pořadí.
2. Stabilně odvozené identifikátory. Identifikátor entity se vypočítá z její sémantické cesty, nevytáhne se náhodně. Dva lidé, kteří přidají stejný požadavek na stejné místo, vytvoří stejný identifikátor, což umožňuje slučování správně entity spárovat.

Výsledek: otevřít projekt a znovu ho uložit bez jakékoli změny nevytvoří žádný diff. Viz Integrovaný git.

Naposledy otevřené projekty

Soubor ▸ Naposledy otevřené vypisuje deset posledních otevřených projektů; cesty, které přestaly být platné, se automaticky odeberou. Tentýž seznam plní úvodní obrazovku.