Proiecte și fișiere .restorm
Un proiect Restorm trăiește pe discul dumneavoastră. Nu există spațiu de lucru la distanță, nu există sincronizare proprietară: deschideți un fișier, îl salvați, îl puneți în commit.
Două moduri de stocare
Section titled “Două moduri de stocare”Fișier unic .restorm
Section titled “Fișier unic .restorm”Modul implicit (Fișier ▸ Nou, apoi Salvează ca). Tot proiectul încape
într-un singur fișier, YAML implicit. Sunt disponibile alte două formate de
serializare: json și json5.
Mod folder
Section titled “Mod folder”Fișier ▸ Deschide folderul. Proiectul este desfăcut într-un arbore pe disc, ceea ce dă diferențe mult mai fine pe proiectele mari:
- un fișier de configurare
restorm.confîn rădăcină, care poartă doar formatul (format: yaml | json | json5); - un fișier de index pentru fiecare director (
index.yaml,index.json…); - folderele și fișierele denumite
<index> - <name>, indexul fiind completat cu zerouri pe lățimea grupului de elemente-frați, astfel încât ordinea de pe ecran să fie ordinea de pe disc. Caracterele interzise (<>:"/\|?*) sunt înlocuite cu_, iar numele este trunchiat la 100 de caractere.
În mod folder, Ctrl+S scrie numai subarborele filei active;
Ctrl+Shift+S (Salvează tot) scrie întregul ansamblu.
Ce conține proiectul
Section titled “Ce conține proiectul”- arborele: foldere, foldere de variabile, cereri pentru toate protocoalele, scenarii;
- mediile și variabilele lor, inclusiv submediile;
- listele de valori personalizate și enumerările importate;
- etichetele și culorile lor;
- documentația de API atașată folderelor de variabile;
- setările rapide salvate „în proiect”;
- un identificator de proiect (
_projectUuid) și o versiune de format.
Ce nu conține proiectul
Section titled “Ce nu conține proiectul”În mod voit, pentru ca fișierul să fie partajabil:
| Date | Unde trăiesc |
|---|---|
| Secrete | Un fișier .env de secrete lângă proiect — vedeți Secrete |
| Istoricul răspunsurilor | O arhivă <project>.responses.zip așezată lângă proiect |
| Setări rapide „utilizator” | Setările dumneavoastră locale |
| Favorite | Stocarea locală a aplicației, indexată după identificatorul proiectului |
| Dispunerea workbench-ului | Setările dumneavoastră locale, indexate pe proiect |
| Setările spațiului de lucru | <project-folder>/.restorm/settings.json |
Consecință practică: puteți pune în commit un .restorm fără să exfiltrați un
token, iar colegul dumneavoastră nu primește dispunerea dumneavoastră de file.
O serializare făcută pentru git
Section titled “O serializare făcută pentru git”Două garanții, care există exclusiv pentru ca versionarea să fie utilizabilă:
- Ordine canonică a cheilor. Cheile de identitate vin în frunte (
id,name,key,type,folderType,method,url), restul este sortat. Ordinea tablourilor, în schimb, nu este niciodată modificată: este ordinea dumneavoastră. - Identificatori derivați în mod stabil. Identificatorul unei entități este calculat din calea sa semantică, nu tras la sorți. Două persoane care adaugă aceeași cerere în același loc produc același identificator, ceea ce permite contopirii să împerecheze corect entitățile.
Rezultat: deschiderea și apoi resalvarea unui proiect fără nicio modificare nu produce nicio diferență. Vedeți Git integrat.
Proiecte recente
Section titled “Proiecte recente”Fișier ▸ Fișiere recente listează ultimele zece proiecte deschise; căile devenite invalide sunt eliminate automat. Aceeași listă alimentează ecranul de bun venit.