Progetti e file .restorm
Un progetto Restorm vive sul proprio disco. Non esiste uno spazio di lavoro remoto né una sincronizzazione proprietaria: si apre un file, lo si salva, lo si mette sotto commit.
Il file .restorm
Section titled “Il file .restorm”Un progetto Restorm è un solo file (File ▸ Nuovo, poi Salva con nome), in
YAML per impostazione predefinita. Sono disponibili altri due formati di
serializzazione: json e json5.
Ciò che il progetto contiene
Section titled “Ciò che il progetto contiene”- l’albero: cartelle, cartelle di variabili, richieste di tutti i protocolli, scenari;
- gli ambienti e le loro variabili, compresi i sotto-ambienti;
- gli elenchi di valori personalizzati e le enumerazioni importate;
- i tag e i loro colori;
- la documentazione di API allegata alle cartelle di variabili;
- le impostazioni rapide salvate «nel progetto»;
- un identificatore di progetto (
_projectUuid) e una versione di formato.
Ciò che il progetto non contiene
Section titled “Ciò che il progetto non contiene”Deliberatamente, perché il file sia condivisibile:
| Dato | Dove risiede |
|---|---|
| Segreti | Un file .env di segreti accanto al progetto — si veda Segreti |
| Cronologia delle risposte | Un archivio <project>.responses.zip collocato accanto al progetto |
| Impostazioni rapide «utente» | Le impostazioni locali della macchina |
| Preferiti | L’archiviazione locale dell’applicazione, indicizzata per identificatore di progetto |
| Disposizione del workbench | Le impostazioni locali, indicizzate per progetto |
| Impostazioni dell’area di lavoro | <project-folder>/.restorm/settings.json |
Conseguenza pratica: si può mettere sotto commit un .restorm senza esfiltrare
un token, e il collega non riceve la disposizione delle schede di chi lo ha
creato.
Una serializzazione pensata per git
Section titled “Una serializzazione pensata per git”Due garanzie, che esistono unicamente perché il versionamento sia utilizzabile:
- Ordine canonico delle chiavi. Le chiavi di identità vengono per prime
(
id,name,key,type,folderType,method,url), il resto è ordinato. L’ordine degli array, invece, non viene mai modificato: è l’ordine scelto dall’autore. - Identificatori derivati in modo stabile. L’identificatore di un’entità è calcolato a partire dal suo percorso semantico, non estratto a caso. Due persone che aggiungono la stessa richiesta nello stesso punto producono lo stesso identificatore, il che permette alla fusione di appaiare correttamente le entità.
Risultato: aprire e poi salvare di nuovo un progetto senza modificare nulla non produce nessun diff. Si veda Git integrato.
Progetti recenti
Section titled “Progetti recenti”File ▸ File recenti elenca gli ultimi dieci progetti aperti; i percorsi diventati non validi vengono rimossi automaticamente. Lo stesso elenco alimenta la schermata di benvenuto.