Proyectos y archivos .restorm
Un proyecto Restorm vive en su disco. No hay espacio de trabajo remoto ni sincronización propietaria: usted abre un archivo, lo guarda y lo confirma en git.
El archivo .restorm
Section titled “El archivo .restorm”Un proyecto de Restorm es un solo archivo (Archivo ▸ Nuevo y luego Guardar
como), en YAML por defecto. Hay otros dos formatos de serialización
disponibles: json y json5.
Lo que contiene el proyecto
Section titled “Lo que contiene el proyecto”- el árbol: carpetas, carpetas de variables, peticiones de todos los protocolos, escenarios;
- los entornos y sus variables, incluidos los subentornos;
- las listas de valores personalizadas y las enumeraciones importadas;
- las etiquetas y sus colores;
- la documentación de API adjunta a las carpetas de variables;
- los ajustes rápidos guardados «en el proyecto»;
- un identificador de proyecto (
_projectUuid) y una versión de formato.
Lo que el proyecto no contiene
Section titled “Lo que el proyecto no contiene”De forma deliberada, para que el archivo sea compartible:
| Dato | Dónde vive |
|---|---|
| Secretos | Un archivo .env de secretos junto al proyecto — consulte Secretos |
| Historial de respuestas | Un archivo comprimido <proyecto>.responses.zip colocado junto al proyecto |
| Ajustes rápidos «de usuario» | Su configuración local |
| Favoritos | El almacenamiento local de la aplicación, indexado por identificador de proyecto |
| Disposición del workbench | Su configuración local, indexada por proyecto |
| Ajustes del espacio de trabajo | <carpeta-del-proyecto>/.restorm/settings.json |
Consecuencia práctica: puede confirmar un .restorm en git sin filtrar ningún
token, y su compañero no recibe su disposición de pestañas.
Una serialización hecha para git
Section titled “Una serialización hecha para git”Dos garantías, que existen únicamente para que el control de versiones sea utilizable:
- Orden de claves canónico. Las claves de identidad van primero (
id,name,key,type,folderType,method,url) y el resto se ordena alfabéticamente. El orden de los arreglos, en cambio, no se modifica nunca: es su orden. - Identificadores derivados de forma estable. El identificador de una entidad se calcula a partir de su ruta semántica, no se sortea al azar. Dos personas que añaden la misma petición en el mismo lugar producen el mismo identificador, lo que permite que la fusión empareje correctamente las entidades.
Resultado: abrir y volver a guardar un proyecto sin cambiar nada no produce ningún diff. Consulte Git integrado.
Proyectos recientes
Section titled “Proyectos recientes”Archivo ▸ Archivos recientes enumera los diez últimos proyectos abiertos; las rutas que han dejado de ser válidas se retiran automáticamente. La misma lista alimenta la pantalla de bienvenida.