Projets et fichiers .restorm
Un projet Restorm vit sur votre disque. Il n’y a pas d’espace de travail distant, pas de synchronisation propriétaire : vous ouvrez un fichier, vous l’enregistrez, vous le commitez.
Deux modes de stockage
Section titled “Deux modes de stockage”Fichier unique .restorm
Section titled “Fichier unique .restorm”Le mode par défaut (Fichier ▸ Nouveau, puis Enregistrer sous). Tout le
projet tient dans un seul fichier, YAML par défaut. Deux autres formats de
sérialisation sont disponibles : json et json5.
Mode dossier
Section titled “Mode dossier”Fichier ▸ Ouvrir un dossier. Le projet est éclaté en arborescence sur le disque, ce qui donne des diffs beaucoup plus fins sur les gros projets :
- un fichier de configuration
restorm.confà la racine, qui ne porte que le format (format: yaml | json | json5) ; - un fichier d’index par répertoire (
index.yaml,index.json…) ; - les dossiers et fichiers nommés
<index> - <nom>, l’index étant complété par des zéros sur la largeur de la fratrie, afin que l’ordre à l’écran soit l’ordre sur le disque. Les caractères interdits (<>:"/\|?*) sont remplacés par_et le nom est tronqué à 100 caractères.
En mode dossier, Ctrl+S n’écrit que le sous-arbre de l’onglet actif ;
Ctrl+Shift+S (Enregistrer tout) écrit l’ensemble.
Ce que le projet contient
Section titled “Ce que le projet contient”- l’arbre : dossiers, dossiers de variables, requêtes de tous les protocoles, scénarios ;
- les environnements et leurs variables, y compris les sous-environnements ;
- les listes de valeurs personnalisées et les énumérations importées ;
- les tags et leurs couleurs ;
- la documentation d’API attachée aux dossiers de variables ;
- les paramètres rapides enregistrés « dans le projet » ;
- un identifiant de projet (
_projectUuid) et une version de format.
Ce que le projet ne contient pas
Section titled “Ce que le projet ne contient pas”Volontairement, pour que le fichier soit partageable :
| Donnée | Où elle vit |
|---|---|
| Secrets | Un fichier .env de secrets à côté du projet — voir Secrets |
| Historique des réponses | Une archive <projet>.responses.zip posée à côté du projet |
| Paramètres rapides « utilisateur » | Vos réglages locaux |
| Favoris | Le stockage local de l’application, indexé par identifiant de projet |
| Disposition du workbench | Vos réglages locaux, indexés par projet |
| Réglages d’espace de travail | <dossier-du-projet>/.restorm/settings.json |
Conséquence pratique : vous pouvez commiter un .restorm sans exfiltrer un
jeton, et votre collègue ne reçoit pas votre disposition d’onglets.
Une sérialisation faite pour git
Section titled “Une sérialisation faite pour git”Deux garanties, qui existent uniquement pour que le versionnement soit utilisable :
- Ordre de clés canonique. Les clés d’identité viennent en tête (
id,name,key,type,folderType,method,url), le reste est trié. L’ordre des tableaux, lui, n’est jamais modifié : c’est votre ordre. - Identifiants dérivés de façon stable. L’identifiant d’une entité est calculé à partir de son chemin sémantique, pas tiré au hasard. Deux personnes qui ajoutent la même requête au même endroit produisent le même identifiant, ce qui permet à la fusion d’apparier les entités correctement.
Résultat : ouvrir puis réenregistrer un projet sans rien modifier ne produit aucun diff. Voir Git intégré.
Projets récents
Section titled “Projets récents”Fichier ▸ Fichiers récents liste les dix derniers projets ouverts ; les chemins devenus invalides sont retirés automatiquement. La même liste alimente l’écran d’accueil.