Resterm

Un workbench API-as-code per il terminale.
resterm.app · docs

Resterm è un client API che utilizza file .http/.rest come codice sorgente. Quasi tutte le funzionalità risiedono nei file .http, quindi sono facili da revisionare in Git o in qualsiasi altro sistema di controllo versione. Puoi inviare richieste, testare flussi API, registrare traffico HTTP ed eseguire server mock locali direttamente dalla TUI oppure eseguire le stesse definizioni in script e CI con il comando resterm run.

Perché Resterm

• Testa flussi API completi. Effettua il login, cattura un token, crea una risorsa e verifica il risultato. Aggiungi asserzioni, cicli, condizioni, retry e script direttamente nei tuoi file di richiesta.
• Trasforma il traffico reale in mock locali. Registra richieste e risposte HTTP, poi salvale come richieste eseguibili o definizioni di mock. Mantieni i mock accanto alle richieste che li utilizzano.
• Scopri cosa è cambiato. Confronta le risposte tra ambienti diversi, esegui il diff rispetto a risultati precedenti, ispeziona i tempi delle richieste e profila esecuzioni ripetute.
• Esegui gli stessi controlli in locale e in CI. Usa l'interfaccia terminale durante lo sviluppo, poi esegui quei file con resterm run. Esporta report JSON o JUnit.
• Lavora su più protocolli. Invia richieste HTTP, GraphQL e gRPC, e lavora con stream WebSocket e SSE.

I tunnel SSH e i port-forward Kubernetes integrati ti permettono di raggiungere API dietro un bastion host o all'interno di un cluster.

Nessun account, nessuna telemetria, nessuna funzionalità AI.

Screenshot

Trace e timeline

Clicca per vedere altre parti dell'interfaccia

Workflow

Profiler

Explain

RestermScript

Installazione

macOS e Linux:

brew install resterm
# or
curl -fsSL https://raw.githubusercontent.com/unkn0wn-root/resterm/main/install.sh | bash

Windows:

iwr -useb https://raw.githubusercontent.com/unkn0wn-root/resterm/main/install.ps1 | iex

Con Go 1.25 o successivo:

go install github.com/unkn0wn-root/resterm/cmd/resterm@latest

I binari precompilati per macOS, Linux e Windows sono disponibili nella pagina delle release. I binari Linux richiedono glibc 2.32 o successivo.

Per aggiornare, esegui brew upgrade resterm se hai installato con Homebrew. Altrimenti esegui resterm --update. Maggiori informazioni nella guida all'installazione.

Avvio rapido

mkdir my-api && cd my-api
resterm init
resterm

resterm init crea un file requests.http con alcune richieste di esempio e mock locali per rispondere ad esse, così non hai bisogno di una vera API per provarlo. Premi g Shift+M per avviare il server mock, sposta il cursore su una richiesta e premi Ctrl+Enter per inviarla. Premi ? per l'aiuto in qualsiasi momento.

Non hai bisogno nemmeno di init. Esegui resterm, digita un URL o incolla un comando curl e premi Ctrl+Enter.

Lo stesso file funziona anche senza l'interfaccia. Avvia i mock in un terminale ed esegui una richiesta in un altro:

resterm mock requests.http                       # terminal 1
resterm run --request CreateUser requests.http   # terminal 2

File di richiesta

Resterm legge il formato standard .http e aggiunge direttive # @ per impostazioni e automazione:

# @setting base-url https://api.example.com/v1/

### Create users
// Send this request once for each name in the list.
# @for-each ["david", "tom"] as name
# @when env.mode == "development"
# @assert response.statusCode == 201
POST users
Content-Type: application/json

{"name":"{{= name }}"}

Un @setting prima della prima richiesta si applica all'intero file. ### avvia una nuova richiesta. Le direttive sopra una richiesta possono ripeterla, saltarla o controllare la risposta.

Ci sono altri esempi in _examples/, e ogni direttiva è elencata nel riferimento dei file di richiesta.

Documentazione

La documentazione completa è su resterm.app/docs. Buoni punti di partenza sono workflow, server mock, registrazione, la CLI e RestermScript.

All'interno della TUI, :help <topic> apre il manuale integrato e :docs <topic> apre la stessa pagina sul sito web.

Per eseguire file di richiesta dal tuo codice Go, vedi il pacchetto headless.

Sponsor

Resterm è e sarà sempre gratuito e open source. Se ti piace il mio lavoro, puoi sponsorizzarlo su GitHub.

Licenza

Apache License 2.0.