Coleções

Workspaces

Um workspace é a caixa de fora: coleções próprias, ambientes próprios, auth padrão própria e seu próprio pote de cookies, então estar logado em um projeto nunca vaza para outro. O Mariner começa com um chamado Personal.

• Troque com ⌘⇧] e ⌘⇧[, pelo seletor no topo da barra lateral, ou com ⌘K → Switch Workspace › nome.
• O seletor também oferece New Workspace…, Rename… e Delete….
• O Mariner lembra qual workspace e qual ambiente estavam ativos e os restaura no próximo início.

A árvore

Uma coleção contém pastas e requisições, aninhadas quanto você quiser. Os itens novos recebem um nome no seu idioma — Nova coleção, Nova pasta, Nova requisição — e abrem em modo renomear.

• Coleção (botão direito): Add Request, Add Folder, Import from cURL…, Run Collection…, Edit Auth…, Export as Mariner…, Export as Postman…, Rename, Duplicate, Delete.
• Pasta: Add Request, Add Folder, Import from cURL…, Rename, Duplicate, Move to…, Run Folder…, Edit Auth…, Delete.
• Requisição: Open in new tab, Rename, Duplicate, Move to…, Run request, Generate Code… (⌘⇧C), Copy as cURL (⌘⌥C), Delete.

As duplicatas se chamam X copy e depois X copy 2. Duplo clique em qualquer nome para renomear; ↩ confirma, ⎋ cancela. Apagar uma coleção ou pasta com conteúdo pede confirmação.

Ordem e busca

O cabeçalho acima da árvore tem um controle de ordem (↑↓) à esquerda do +. Ele fica sempre visível, e assume a cor de destaque assim que a lista sai da ordem de repouso — então o próprio ícone responde “por que elas estão nesta ordem?”.

• Name — a ordem do Finder: ignora maiúsculas e acentos, e compara os dígitos como números, então api-v9 vem antes de api-v10.
• Recently used — o executado mais recentemente primeiro. Uma coleção cuja última execução já saiu da janela do histórico conta como nunca usada, e essas vão para o fim em ordem alfabética — também ao inverter, porque “mais antigo primeiro” não quer dizer “primeiro aquilo de que não sei nada”.
• Number of requests — contando a subárvore inteira, não só a raiz.
• Manual — a ordem em que você as deixou, e o estado de repouso. É também a que precisa estar ativa enquanto você arrasta linhas: em qualquer outro critério, a linha que você solta volta na hora para o lugar.

Cada critério pode ser invertido — A→Z / Z→A, Newest first / Oldest first, Most requests first / Fewest requests first — e a escolha é salva por workspace, então mudar de projeto nunca herda a ordem do anterior. Enquanto houver algo diferente de Manual, o rodapé da barra lateral nomeia a ordem ao lado da contagem de coleções, e serve como o mesmo menu.

O campo de busca acima da árvore alcança coleções, pastas e requisições — uma requisição também responde pela URL e pelo método. Os contêineres vêm listados primeiro: digitar o nome de uma coleção deve levar você até ela, e não a tudo que está dentro.

Arrastar e soltar

Todas as linhas podem ser arrastadas. Cada linha tem três zonas de destino: a borda de cima insere antes, a de baixo insere depois, e o centro solta dentro de uma pasta (ou depois de uma requisição). Soltar no cabeçalho de uma coleção move o item para a raiz dela. Move to… faz o mesmo por uma folha quando o destino está longe.

Auth e variáveis no nível da coleção

Uma coleção ou pasta pode ter a própria autenticação, herdada por tudo que está abaixo, e uma requisição pode sobrescrevê-la. A cadeia completa está em Autenticação. Os ambientes são por workspace, não por coleção — veja Configurar ambientes.

Executar, exportar, importar

• Run Collection… (⌘R) ou Run Folder… executa a subárvore em ordem; veja Runner.
• Export as Mariner… (⌘⇧X) escreve um pacote .mariner que você pode commitar ou mandar para um colega; Export as Postman… escreve uma coleção v2.1. Os segredos são removidos dos dois. Os formatos estão em Formato de arquivos.
• Importar de cURL, Postman, OpenAPI ou de outra exportação do Mariner está em Importar de outros clientes.