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.
Le fichier .restorm
Section titled “Le fichier .restorm”Un projet Restorm est un fichier unique (Fichier ▸ Nouveau, puis
Enregistrer sous), YAML par défaut. Deux autres formats de sérialisation
sont disponibles : json et json5.
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.