설정은 첫 번째 요청 이전에 적용되어 전체 파일에 영향을 미치며, `###`은 요청을 구분하고, 지시문은 요청을 반복하거나 제한하거나 검증할 수 있습니다. 더 많은 예시는 여기에서 확인하세요: [`_examples/`](https://github.com/unkn0wn-root/resterm/blob/main/_examples).

## CLI

`resterm run`은 TUI를 열지 않고 `.http` / `.rest` 파일을 실행하며, 이것이 CI가 실행하는 방식입니다.```bash
resterm run --request CreateUser requests.http

TUI에서 `g Shift+M`을 대신 눌러 워크스페이스에서 동일한 목 서버를 시작하세요.

[CLI 문서](https://github.com/unkn0wn-root/resterm/blob/main/docs/cli.md)는 선택자, 출력 형식 및 더 많은 예제를 다룹니다.

## 키보드 치트 시트

- 창 포커스 및 레이아웃
  - `Tab` / `Shift+Tab`: 사이드바, 편집기 및 응답 사이를 이동합니다.
  - `g+r`, `g+i`, `g+p`: 요청, 편집기 또는 응답으로 이동합니다.
  - `g+h` / `g+l`: 가로로 크기를 조정합니다. 사이드바가 포커스된 경우 사이드바 너비를 변경하고, 그 외에는 편집기/응답 분할을 변경합니다.
  - `g+j` / `g+k`: 세로로 쌓인 경우 편집기/응답 높이를 조정하고, 내비게이터에서 분기를 접거나 펼칩니다.
  - `g+v` / `g+s`: 응답 창을 인라인 레이아웃과 스택 레이아웃 사이에서 전환합니다.
  - `g+1`, `g+2`, `g+3`: 사이드바, 편집기, 응답을 최소화하거나 복원합니다.
  - `g+z` / `g+Z`: 포커스된 창을 확대하고, 확대를 해제합니다.
- 환경 및 전역 변수
  - `Ctrl+E`: 환경을 전환합니다.
  - `Ctrl+G`: 캡처된 전역 변수를 검사합니다.
- 도움말 및 명령
  - `?`: 검색 가능한 오프라인 도움말 색인을 엽니다.
  - `K` (편집기 일반 모드): 커서 아래의 지시문, 템플릿 또는 키워드에 대한 도움말을 엽니다.
  - `:help <topic>` / `:man <topic>`: 임베디드 주제를 엽니다. `:docs <topic>`는 버전에 맞는 전체 매뉴얼을 엽니다.
  - `Ctrl+O`: 파일/워크스페이스 팝업을 엽니다. 입력하여 필터링하고, `Up` / `Down`으로 스크롤하며, `Tab`으로 디렉터리 안으로 들어갑니다.
  - `:`: 명령줄을 엽니다. `Up` / `Down`으로 제안을 선택하고, `Tab`으로 하나를 완성하거나, `Enter`로 선택 항목을 수락하고 실행합니다. `:mock start --source` 및 `:edit`와 같은 경로 인수는 동일한 팝업에서 파일 시스템을 탐색합니다.
- 응답
  - `Ctrl+V` / `Ctrl+U`: 나란히 비교하기 위해 응답 창을 분할합니다.
  - `Ctrl+Shift+C` 또는 `g y` (응답 포커스): 전체 Pretty, Raw 또는 Headers 탭을 복사합니다.
  - `g x`: 요청을 보내지 않고 활성 요청에 대한 Explain 미리보기를 표시합니다.
  - `g e`: 현재 파일을 외부 편집기에서 엽니다.

> [!TIP]
> 세 가지 단축키만 기억한다면:
> - `Ctrl+Enter`는 요청을 보냅니다
> - `Tab` / `Shift+Tab`은 창을 전환합니다
> - `g+p`는 응답으로 이동합니다

## 설치

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

or `wget`를 사용하는 경우:```bash
wget -qO- https://raw.githubusercontent.com/unkn0wn-root/resterm/main/install.sh | bash

스크립트가 사용자의 아키텍처를 감지하여 최신 릴리스를 다운로드하고 바이너리를 설치합니다.

### 수동 설치

> [!NOTE]
> 수동 설치 도우미는 `curl`과 `jq`를 사용합니다. 패키지 관리자로 `jq`를 설치하세요(`brew install jq`, `sudo apt install jq` 등).

**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

### 소스에서```bash
go install github.com/unkn0wn-root/resterm/cmd/resterm@latest

첫 번째 명령은 최신 릴리스가 있는지 보고합니다. 두 번째 명령은 다운로드, 검증 후 제자리에 설치합니다. Windows에서는 이전 바이너리가 `resterm.exe.old`로 새 바이너리 옆에 유지되며 다음 업데이트 시 정리됩니다.

## 구성

- 환경은 요청 디렉터리, 작업 영역 루트 또는 CWD에서 발견되는 JSON 파일(`resterm.env.json`)입니다. 파일은 api, app, credentials와 같은 명명된 환경 또는 독립 그룹을 정의할 수 있으며, 이들은 하나의 환경으로 결합됩니다. Dotenv 파일(`.env`, `.env.*`)은 `--env-file`을 통해 선택적으로 사용하며 단일 작업 영역용입니다. [그룹화된 환경](https://github.com/unkn0wn-root/resterm/blob/main/docs/resterm.md#grouped-environments) 및 `_examples/grouped/`의 실행 가능한 샘플을 참조하세요.
- 구성은 OS별로 저장되며 `RESTERM_CONFIG_DIR`로 재정의할 수 있습니다:
  - macOS: `~/Library/Application Support/resterm`
  - Windows: `%APPDATA%\resterm`
  - Linux/Unix: `~/.config/resterm`

## 모의 서버

요청과 동일한 `.http` 파일에서 모의 응답을 정의할 수 있습니다.

- 쿼리, 헤더 또는 JSON 본문으로 들어오는 요청을 매칭한 다음 명명된 응답 또는 기본 응답을 선택합니다.
- 폴링 및 재시도 테스트를 위해 응답 시퀀스를 반환합니다. 경로, 쿼리, 헤더 또는 쿠키 값을 사용하여 각 시퀀스를 개별적으로 추적합니다.
- 고정 시간만큼 응답을 지연시키거나 `random`, `normal`, `jitter`로 각 요청에 서로 다른 지연을 부여합니다.
- 경로, 쿼리, 헤더 및 본문 값에서 응답을 구성하고 동적 데이터용 생성기를 사용합니다.
- `@expect`로 호출 횟수를 검증하거나 RestermScript에서 수신된 트래픽을 검사합니다.
- 선택적 TLS와 함께 소스 파일 및 픽스처를 핫 리로드합니다.

하나의 경로에 대한 두 가지 시나리오:```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"}

[Mock Servers 참조](https://github.com/unkn0wn-root/resterm/blob/main/docs/resterm.md#mock-servers), [`resterm mock` CLI 가이드](https://github.com/unkn0wn-root/resterm/blob/main/docs/cli.md#resterm-mock) 및 [작동 예제](https://github.com/unkn0wn-root/resterm/blob/main/_examples/mocks.http)에서 자세한 내용을 확인하세요.

## Headless

[`headless`](https://github.com/unkn0wn-root/resterm/blob/main/headless) 패키지는 TUI와 CLI를 구동하는 동일한 엔진을 위한 공개 Go API입니다. 이를 사용하여 자체 Go 코드나 CI에서 요청, 워크플로우, 어서션을 실행하고 실행 결과와 프로필을 비교할 수 있습니다.

직접 러너를 구축하고 싶지 않다면 [resterm-runner](https://github.com/unkn0wn-root/resterm-runner)가 있습니다.

## Collections

워크스페이스를 Git 친화적인 번들로 내보내고 다른 워크스페이스로 가져올 수 있습니다. 번들에는 체크섬이 포함된 `manifest.json`이 포함되어 있어 가져오기 시 파일 무결성을 먼저 검증합니다. 환경 값은 `REPLACE_ME` 자리 표시자로 내보내지므로 비밀 정보가 머신을 벗어나지 않습니다.```bash
resterm collection export --workspace ./my-api --out ./shared/my-api-bundle
resterm collection import --in ./shared/my-api-bundle --workspace ./my-local-api

다음과 같이 됩니다:```http
### POST https://api.example.com/login
# @auth basic demo secret
POST https://api.example.com/login
Content-Type: application/json

{"user":"demo"}

Please provide the Markdown content to translate.```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")) }}

예시: [`_examples/oauth2.http`](https://github.com/unkn0wn-root/resterm/blob/main/_examples/oauth2.http). [OAuth 2.0 문서](https://github.com/unkn0wn-root/resterm/blob/main/docs/resterm.md#oauth-20-directive)를 참조하세요.

### 워크플로 및 스크립팅

워크플로는 명명된 요청을 연결하며 응답에서 다음 단계를 선택할 수 있습니다:```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"

각 폴링 주기는 자체 재시도 예산을 받습니다. 예: [`_examples/polling-retries.http`](https://github.com/unkn0wn-root/resterm/blob/main/_examples/polling-retries.http). [폴링 및 재시도 문서](https://github.com/unkn0wn-root/resterm/blob/main/docs/resterm.md#polling-and-retries)를 참조하세요.

### 실행 비교

`@compare`는 하나의 요청을 최소 두 개의 환경에 대해 실행하고, 그중 하나의 결과를 기준선으로 사용합니다:```http
### Compare health
# @compare dev stage prod base=prod
GET {{services.api.base}}/status

결과는 Timeline 탭에 표시되며 OpenTelemetry로 내보낼 수 있습니다. 예: [`_examples/trace.http`](https://github.com/unkn0wn-root/resterm/blob/main/_examples/trace.http). [추적 문서](https://github.com/unkn0wn-root/resterm/blob/main/docs/resterm.md#timeline--tracing)를 참조하세요.

### 스트리밍(WebSocket 및 SSE)

`@sse`는 서버 이벤트를 기록하고, `@websocket` 및 `@ws`는 WebSocket 프레임을 스크립팅합니다. 둘 다 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

서버 리플렉션은 기본적으로 활성화되어 있습니다. 디스크립터 세트와 스트리밍 호출도 지원됩니다. 예시: [`_examples/grpc.http`](https://github.com/unkn0wn-root/resterm/blob/main/_examples/grpc.http). [gRPC 문서](https://github.com/unkn0wn-root/resterm/blob/main/docs/resterm.md#grpc)를 참조하세요.

### OpenAPI 가져오기

로컬 OpenAPI 문서 또는 `http(s)` URL에서 요청, 목(mock) 또는 둘 다 생성합니다:```bash
resterm --from-openapi _examples/openapi-spec.yml --http-out api.http --openapi-mode both

프로필은 파일 전체 또는 작업공간 전체에 적용할 수 있으며, 일회성 인라인 터널도 지원됩니다. 예시: [`_examples/ssh.http`](https://github.com/unkn0wn-root/resterm/blob/main/_examples/ssh.http). [SSH 문서](https://github.com/unkn0wn-root/resterm/blob/main/docs/resterm.md#ssh-tunnels)를 참조하세요.

### Kubernetes 포트 포워딩

`@k8s`는 파드, 서비스, 디플로이먼트 또는 스테이트풀셋에 대한 관리형 포트 포워딩을 엽니다:```http
### Service health
# @k8s namespace=default service=api port=http
GET http://api.default.svc.cluster.local/health