Projekty i pliki .restorm
Projekt Restorm żyje na własnym dysku. Nie ma zdalnego obszaru roboczego ani zamkniętej synchronizacji: plik się otwiera, zapisuje i commituje.
Plik .restorm
Section titled “Plik .restorm”Projekt Restorm to jeden plik (Plik ▸ Nowy, następnie Zapisz jako),
domyślnie w formacie YAML. Dostępne są też dwa inne formaty serializacji:
json i json5.
Co projekt zawiera
Section titled “Co projekt zawiera”- drzewo: foldery, foldery zmiennych, żądania wszystkich protokołów, scenariusze;
- środowiska i ich zmienne, w tym podśrodowiska;
- własne listy wartości oraz zaimportowane wyliczenia;
- tagi i ich kolory;
- dokumentację API dołączoną do folderów zmiennych;
- szybkie ustawienia zapisane „w projekcie”;
- identyfikator projektu (
_projectUuid) i wersję formatu.
Czego projekt nie zawiera
Section titled “Czego projekt nie zawiera”Celowo, aby plik nadawał się do udostępniania:
| Dane | Gdzie się znajdują |
|---|---|
| Sekrety | Plik sekretów .env obok projektu — zob. Sekrety |
| Historia odpowiedzi | Archiwum <project>.responses.zip umieszczone obok projektu |
| Szybkie ustawienia „użytkownika” | Lokalne ustawienia danej osoby |
| Ulubione | Lokalna pamięć aplikacji, indeksowana identyfikatorem projektu |
| Układ workbencha | Lokalne ustawienia, indeksowane według projektu |
| Ustawienia obszaru roboczego | <project-folder>/.restorm/settings.json |
Praktyczna konsekwencja: plik .restorm można commitować bez wyprowadzania
tokenu, a współpracownicy nie otrzymują cudzego układu zakładek.
Serializacja stworzona z myślą o git
Section titled “Serializacja stworzona z myślą o git”Dwie gwarancje, które istnieją wyłącznie po to, aby wersjonowanie było użyteczne:
- Kanoniczna kolejność kluczy. Klucze tożsamości występują na początku
(
id,name,key,type,folderType,method,url), pozostałe są sortowane. Kolejność tablic natomiast nigdy nie jest zmieniana: pozostaje ona taka, jak ją ustawiono. - Identyfikatory wyprowadzane w stabilny sposób. Identyfikator encji jest obliczany na podstawie jej ścieżki semantycznej, a nie losowany. Dwie osoby, które dodadzą to samo żądanie w tym samym miejscu, otrzymają ten sam identyfikator, co pozwala scalaniu poprawnie sparować encje.
Efekt: otwarcie i ponowne zapisanie projektu bez żadnej zmiany nie daje żadnego diffa. Zob. Wbudowany git.
Ostatnie projekty
Section titled “Ostatnie projekty”Plik ▸ Ostatnie pliki wymienia dziesięć ostatnio otwartych projektów; ścieżki, które przestały być poprawne, są automatycznie usuwane. Ta sama lista zasila ekran powitalny.