Workspaces
Un workspace es la caja exterior: sus propias colecciones, sus propios entornos, su auth por defecto y su propio tarro de cookies, así que estar logueado en un proyecto nunca se filtra a otro. Mariner arranca con uno llamado Personal.
- Cambia con ⌘⇧] y ⌘⇧[, desde el selector en la parte superior de la barra lateral, o con ⌘K → Switch Workspace › nombre.
- El selector también ofrece New Workspace…, Rename… y Delete….
- Mariner recuerda qué workspace y qué entorno estaban activos y los restaura en el siguiente arranque.
El árbol
Una colección contiene carpetas y peticiones, anidadas tanto como quieras. Los elementos nuevos reciben un nombre en tu idioma — Nueva colección, Nueva carpeta, Nueva petición — y se abren en modo renombrar.
- Colección (clic derecho): Add Request, Add Folder, Import from cURL…, Run Collection…, Edit Auth…, Export as Mariner…, Export as Postman…, Rename, Duplicate, Delete.
- Carpeta: Add Request, Add Folder, Import from cURL…, Rename, Duplicate, Move to…, Run Folder…, Edit Auth…, Delete.
- Petición: Open in new tab, Rename, Duplicate, Move to…, Run request, Generate Code… (⌘⇧C), Copy as cURL (⌘⌥C), Delete.
Los duplicados se llaman X copy y luego X copy 2. Doble clic sobre cualquier nombre para renombrarlo; ↩ confirma, ⎋ cancela. Borrar una colección o una carpeta con contenido pide confirmación.
Orden y búsqueda
La cabecera sobre el árbol lleva un control de orden (↑↓) a la izquierda del +. Está siempre visible, y toma el color de acento en cuanto la lista no está en su orden de reposo — así el propio icono responde a “¿por qué están en este orden?”.
- Name — el orden del Finder: ignora mayúsculas y acentos, y compara los dígitos como números, así que
api-v9va antes queapi-v10. - Recently used — lo ejecutado más recientemente primero. Una colección cuya última ejecución ya salió de la ventana del historial cuenta como nunca usada, y ésas van al final por orden alfabético — también al invertir, porque “lo más viejo primero” no significa “primero aquello de lo que no sé nada”.
- Number of requests — contando el subárbol entero, no solo la raíz.
- Manual — el orden en que las dejaste, y el estado de reposo. Es también el que hay que tener puesto mientras arrastras filas: con cualquier otro criterio, la fila que sueltas vuelve de un salto a su sitio.
Cada criterio se puede invertir — A→Z / Z→A, Newest first / Oldest first, Most requests first / Fewest requests first — y la elección se guarda por workspace, así que pasar a otro proyecto nunca hereda el orden del anterior. Mientras haya algo distinto de Manual, el pie de la barra lateral lo nombra junto al número de colecciones, y sirve como el mismo menú.
El campo de búsqueda sobre el árbol alcanza colecciones, carpetas y peticiones — una petición además responde a su URL y a su método. Los contenedores se listan primero: escribir el nombre de una colección debería llevarte a esa colección, no a todo lo que hay dentro.
Arrastrar y soltar
Todas las filas se pueden arrastrar. Cada fila tiene tres zonas de destino: el borde superior inserta antes, el inferior inserta después, y el centro suelta dentro de una carpeta (o después de una petición). Soltar sobre la cabecera de una colección mueve el elemento a la raíz de esa colección. Move to… hace lo mismo desde una hoja cuando el destino está lejos.
Auth y variables a nivel de colección
Una colección o carpeta puede llevar su propia autenticación, que hereda cada petición por debajo, y una petición puede sobrescribirla. La cadena completa está en Autenticación. Los entornos son por workspace, no por colección — ver Configurar entornos.
Ejecutar, exportar, importar
- Run Collection… (⌘R) o Run Folder… ejecuta el subárbol en orden; ver Runner.
- Export as Mariner… (⌘⇧X) escribe un paquete
.marinerque puedes commitear o enviar a un compañero; Export as Postman… escribe una colección v2.1. Los secretos se eliminan de ambos. Los formatos están en Formato de archivos. - Importar desde cURL, Postman, OpenAPI u otra exportación de Mariner está en Importar de otros clientes.