Projecten en .restorm-bestanden

Een Restorm-project leeft op uw eigen schijf. Er is geen externe werkruimte en geen eigen synchronisatiedienst: u opent een bestand, u slaat het op, u commit het.

Het `.restorm`-bestand

Een Restorm-project is één bestand (Bestand ▸ Nieuw, daarna Opslaan als), standaard in YAML. Er zijn twee andere serialisatieformaten beschikbaar: json en json5.

Wat het project bevat

de boom: mappen, omgevingsmappen, verzoeken van alle protocollen, scenario’s;
de omgevingen en hun variabelen, inclusief de subomgevingen;
de aangepaste waardelijsten en de geïmporteerde enumeraties;
de tags en hun kleuren;
de API-documentatie die aan de omgevingsmappen hangt;
de snelle instellingen die “in het project” zijn opgeslagen;
een project-identificator (_projectUuid) en een formaatversie.

Wat het project niet bevat

Bewust niet, zodat het bestand deelbaar blijft:

Gegeven	Waar het leeft
Geheimen	Een `.env`-bestand met geheimen naast het project — zie Geheimen
Responsgeschiedenis	Een archief `<project>.responses.zip` naast het project
Snelle instellingen op “gebruiker”-niveau	Uw lokale instellingen
Favorieten	De lokale opslag van de applicatie, geïndexeerd op project-identificator
Indeling van de workbench	Uw lokale instellingen, geïndexeerd per project
Werkruimte-instellingen	`<projectmap>/.restorm/settings.json`

Het praktische gevolg: u kunt een .restorm committen zonder een token te laten weglekken, en uw collega krijgt niet uw tabbladindeling mee.

Een serialisatie die voor git is gemaakt

Twee garanties, die uitsluitend bestaan om versiebeheer bruikbaar te maken:

Canonieke sleutelvolgorde. De identiteitssleutels komen vooraan (id, name, key, type, folderType, method, url), de rest wordt gesorteerd. De volgorde van arrays wordt echter nooit gewijzigd: dat is uw volgorde.
Stabiel afgeleide identificatoren. De identificator van een entiteit wordt berekend uit haar semantische pad, niet willekeurig gekozen. Twee mensen die hetzelfde verzoek op dezelfde plek toevoegen, produceren dezelfde identificator, waardoor de merge de entiteiten correct kan koppelen.

Het resultaat: een project openen en opnieuw opslaan zonder iets te wijzigen levert geen enkele diff op. Zie Geïntegreerde git.

Recente projecten

Bestand ▸ Recente bestanden toont de tien laatst geopende projecten; paden die ongeldig zijn geworden, worden automatisch verwijderd. Dezelfde lijst voedt het welkomstscherm.