As configurações antes da primeira solicitação aplicam-se a todo o arquivo, `###` separa solicitações, e diretivas podem repetir, limitar ou validar uma solicitação. Mais exemplos aqui: [`_examples/`](https://github.com/unkn0wn-root/resterm/blob/main/_examples).

## CLI

`resterm run` executa arquivos `.http` / `.rest` sem abrir a TUI, que é o que o CI executa.```bash
resterm run --request CreateUser requests.http

No TUI, pressione `g Shift+M` para iniciar o mesmo servidor mock a partir do workspace.

A [documentação da CLI](https://github.com/unkn0wn-root/resterm/blob/main/docs/cli.md) cobre seletores, formatos de saída e mais exemplos.

## Folha de referência do teclado

- Foco e layout dos painéis
  - `Tab` / `Shift+Tab`: mover entre a barra lateral, o editor e a resposta.
  - `g+r`, `g+i`, `g+p`: saltar para requisições, editor ou resposta.
  - `g+h` / `g+l`: redimensionar horizontalmente. Altera a largura da barra lateral quando ela está focada; caso contrário, altera a divisão editor/resposta.
  - `g+j` / `g+k`: redimensionar a altura do editor/resposta quando empilhados, recolher ou expandir ramos no navegador.
  - `g+v` / `g+s`: alternar o painel de resposta entre layout inline e empilhado.
  - `g+1`, `g+2`, `g+3`: minimizar ou restaurar barra lateral, editor, resposta.
  - `g+z` / `g+Z`: ampliar o painel focado, limpar a ampliação.
- Ambientes e globais
  - `Ctrl+E`: alternar ambientes.
  - `Ctrl+G`: inspecionar globais capturados.
- Ajuda e comandos
  - `?`: abrir o índice de ajuda offline pesquisável.
  - `K` (modo normal do editor): abrir ajuda para a diretiva, template ou palavra-chave sob o cursor.
  - `:help <topic>` / `:man <topic>`: abrir um tópico incorporado; `:docs <topic>` abre o manual completo correspondente à versão.
  - `Ctrl+O`: abrir o popup de arquivo/workspace. Digite para filtrar, role com `Up` / `Down` e use `Tab` para descer em diretórios.
  - `:`: abrir a linha de comando. Use `Up` / `Down` para selecionar sugestões, `Tab` para completar uma, ou `Enter` para aceitar e executar uma seleção. Argumentos de caminho como `:mock start --source` e `:edit` navegam pelo sistema de arquivos no mesmo popup.
- Respostas
  - `Ctrl+V` / `Ctrl+U`: dividir o painel de resposta para comparação lado a lado.
  - `Ctrl+Shift+C` ou `g y` (resposta focada): copiar a aba inteira Pretty, Raw ou Headers.
  - `g x`: mostrar a pré-visualização Explain para a requisição ativa sem enviá-la.
  - `g e`: abrir o arquivo atual no seu editor externo.

> [!TIP]
> Se você lembrar apenas de três atalhos:
> - `Ctrl+Enter` envia a requisição
> - `Tab` / `Shift+Tab` alterna painéis
> - `g+p` salta para a resposta

## Instalação

**Linux / macOS (Homebrew)**```bash
brew install resterm

or com `wget`:```bash
wget -qO- https://raw.githubusercontent.com/unkn0wn-root/resterm/main/install.sh | bash

Os scripts detetam a sua arquitetura, transferem a versão mais recente e instalam o binário.

### Instalação manual

> [!NOTE]
> O assistente de instalação manual utiliza `curl` e `jq`. Instale o `jq` com o seu gestor de pacotes (`brew install jq`, `sudo apt install jq`, etc.).

**Linux / macOS**```bash
# Detect latest tag
LATEST_TAG=$(curl -fsSL https://api.github.com/repos/unkn0wn-root/resterm/releases/latest | jq -r .tag_name)

# Download the matching binary (Darwin/Linux + amd64/arm64)
curl -fL -o resterm "https://github.com/unkn0wn-root/resterm/releases/download/${LATEST_TAG}/resterm_$(uname -s)_$(uname -m)"

# Make it executable and move it onto your PATH
chmod +x resterm
sudo install -m 0755 resterm /usr/local/bin/resterm

### Da fonte```bash
go install github.com/unkn0wn-root/resterm/cmd/resterm@latest

O primeiro comando informa se uma versão mais recente está disponível. O segundo baixa, verifica e instala no lugar. No Windows, o binário antigo permanece ao lado do novo como `resterm.exe.old` e é removido na próxima atualização.

## Configuração

- Ambientes são arquivos JSON (`resterm.env.json`) descobertos no diretório da requisição, na raiz do workspace ou no diretório de trabalho atual (CWD). Um arquivo pode definir ambientes nomeados ou grupos independentes, por exemplo api, app e credentials, que se combinam em um único ambiente. Arquivos Dotenv (`.env`, `.env.*`) são opcionais via `--env-file` e são de workspace único. Consulte [ambientes agrupados](https://github.com/unkn0wn-root/resterm/blob/main/docs/resterm.md#grouped-environments) e o exemplo executável em `_examples/grouped/`.
- A configuração é armazenada por sistema operacional e pode ser substituída com `RESTERM_CONFIG_DIR`:
  - macOS: `~/Library/Application Support/resterm`
  - Windows: `%APPDATA%\resterm`
  - Linux/Unix: `~/.config/resterm`

## Servidores Mock

Você pode definir respostas mock nos mesmos arquivos `.http` das suas requisições.

- Corresponda requisições recebidas por query, cabeçalhos ou corpo JSON e, em seguida, escolha uma resposta nomeada ou padrão.
- Retorne uma sequência de respostas para testes de polling e retry. Use um caminho, query, cabeçalho ou valor de cookie para rastrear cada sequência separadamente.
- Atrase respostas por um valor fixo ou dê a cada requisição um atraso diferente com `random`, `normal` ou `jitter`.
- Construa respostas a partir de valores de caminho, query, cabeçalho e corpo, com geradores para dados dinâmicos.
- Verifique contagens de chamadas com `@expect` ou inspecione o tráfego recebido a partir do RestermScript.
- Recarregue a quente arquivos de origem e fixtures, com TLS opcional.

Dois cenários em uma única rota:```http
### Payment accepted
# @mock method=POST path=/payments name=accepted default=true latency=150ms
HTTP/1.1 202 Accepted
Content-Type: application/json

{"id":"pay_123","status":"pending"}

### Payment declined
# @mock method=POST path=/payments name=declined
# @match query={"mode":"decline"} headers={"X-Tenant":"demo"} json={"amount":0}
HTTP/1.1 422 Unprocessable Entity
Content-Type: application/json

{"error":"amount must be positive"}

Mais na [referência de Mock Servers](https://github.com/unkn0wn-root/resterm/blob/main/docs/resterm.md#mock-servers), no [guia de CLI do `resterm mock`](https://github.com/unkn0wn-root/resterm/blob/main/docs/cli.md#resterm-mock) e no [exemplo funcional](https://github.com/unkn0wn-root/resterm/blob/main/_examples/mocks.http).

## Headless

O pacote [`headless`](https://github.com/unkn0wn-root/resterm/blob/main/headless) é a API pública em Go para o mesmo mecanismo que alimenta a TUI e a CLI. Use-o para executar requisições, fluxos de trabalho, asserções, comparar execuções e perfis a partir do seu próprio código Go ou CI.

Se preferir não criar um executor você mesmo, existe o [resterm-runner](https://github.com/unkn0wn-root/resterm-runner).

## Collections

Exporte um workspace como um pacote amigável ao Git e importe-o em outro. Os pacotes carregam um `manifest.json` com somas de verificação, para que as importações verifiquem a integridade dos arquivos primeiro. Os valores de ambiente são exportados como espaços reservados `REPLACE_ME`, para que segredos nunca saiam da sua máquina.```bash
resterm collection export --workspace ./my-api --out ./shared/my-api-bundle
resterm collection import --in ./shared/my-api-bundle --workspace ./my-local-api

torna-se isto:```http
### POST https://api.example.com/login
# @auth basic demo secret
POST https://api.example.com/login
Content-Type: application/json

{"user":"demo"}

Aqui está a tradução do conteúdo fornecido:

---

**Nota:** O conteúdo de entrada está vazio. Nenhum texto foi fornecido para tradução.```http
# @use ./rts/helpers.rts
# @when env.has("feature")
# @assert response.statusCode == 200
GET https://api.example.com/users/{{= vars.get("user") }}
Authorization: {{= helpers.authHeader(vars.get("auth.token")) }}

Exemplo: [`_examples/oauth2.http`](https://github.com/unkn0wn-root/resterm/blob/main/_examples/oauth2.http). Consulte a [documentação do OAuth 2.0](https://github.com/unkn0wn-root/resterm/blob/main/docs/resterm.md#oauth-20-directive).

### Workflows e scripting

Workflows encadeiam requisições nomeadas e podem escolher o próximo passo a partir de uma resposta:```http
### Sign in
# @workflow sign-in
# @step Login using=Login
// GetProfile and RefreshToken are request names.
// The first true condition runs the named request.
# @if last.statusCode == 200 run=GetProfile
# @elif last.statusCode == 401 run=RefreshToken
# @else fail="unexpected login response"

Cada ciclo de polling recebe seu próprio orçamento de tentativas. Exemplo: [`_examples/polling-retries.http`](https://github.com/unkn0wn-root/resterm/blob/main/_examples/polling-retries.http). Consulte a [documentação sobre polling e tentativas](https://github.com/unkn0wn-root/resterm/blob/main/docs/resterm.md#polling-and-retries).

### Comparar execuções

`@compare` executa uma requisição contra pelo menos dois ambientes e usa um resultado como linha de base:```http
### Compare health
# @compare dev stage prod base=prod
GET {{services.api.base}}/status

Os resultados aparecem no separador Timeline e podem ser exportados para OpenTelemetry. Exemplo: [`_examples/trace.http`](https://github.com/unkn0wn-root/resterm/blob/main/_examples/trace.http). Consulte a [documentação de tracing](https://github.com/unkn0wn-root/resterm/blob/main/docs/resterm.md#timeline--tracing).

### Streaming (WebSocket e SSE)

`@sse` regista eventos do servidor, enquanto `@websocket` e `@ws` fazem script de frames WebSocket. Ambos produzem transcrições no separador Stream:```http
### Events
# @sse duration=30s idle=10s max-events=5
GET https://api.example.com/events

### Chat
# @websocket idle=3s
# @ws send Hello
# @ws close 1000 done
GET wss://api.example.com/chat

A reflexão do servidor está habilitada por padrão. Conjuntos de descritores e chamadas de streaming também são suportados. Exemplo: [`_examples/grpc.http`](https://github.com/unkn0wn-root/resterm/blob/main/_examples/grpc.http). Consulte a [documentação do gRPC](https://github.com/unkn0wn-root/resterm/blob/main/docs/resterm.md#grpc).

### Importação OpenAPI

Gere requisições, mocks ou ambos a partir de um documento OpenAPI local ou de uma URL `http(s)`:```bash
resterm --from-openapi _examples/openapi-spec.yml --http-out api.http --openapi-mode both

Perfis podem ser de arquivo ou de workspace, e túneis inline pontuais também são suportados. Exemplo: [`_examples/ssh.http`](https://github.com/unkn0wn-root/resterm/blob/main/_examples/ssh.http). Consulte a [documentação SSH](https://github.com/unkn0wn-root/resterm/blob/main/docs/resterm.md#ssh-tunnels).

### Port-forwards do Kubernetes

`@k8s` abre um port-forward gerenciado para um pod, service, deployment ou statefulset:```http
### Service health
# @k8s namespace=default service=api port=http
GET http://api.default.svc.cluster.local/health