GitHub - jossephus/hurlbox: A web-based single-binary hurl tests runner

A web-based single-binary hurl tests runner: run tests individually, see responses in real time.

I love Hurl and its file based testing mechanisms, but I don't like that it doesn't have a proper way to run tests individually and see responses in real time. This is my attempt to build a web based Hurl runner that is a single Rust binary which uses the hurl_core crate (so having Hurl installed is not a requirement) and can also run as a Docker service.

Features

Monaco Editor with Hurl syntax highlighting and code lens
File Explorer with create, read, write operations
Run & Test individual entries or entire files
Build Assertions - auto-generate JSONPath assertions from responses
Environment Variables - load .env files for request substitution
Response Viewer with JSON formatting
Request/Headers/Response tabs for detailed inspection

Installation

macOS / Linux

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/jossephus/hurlbox/releases/latest/download/hurlbox-installer.sh | sh

Quick Start

Start the Server

The server runs on http://localhost:3030 by default.

Docker image (Docker Hub)

The public image is available on Docker Hub:

jossephus/hurlbox:latest

Pull it directly:

docker pull jossephus/hurlbox:latest

Run it locally:

docker run --rm -p 3030:3030 \
  -v "$(pwd):/workspace" \
  jossephus/hurlbox:latest \
  --dir /workspace

You can checkout the setup at @examples/docker-compose.yml to see an example.

CLI Options

# Specify server directory
hurlbox --dir /path/to/hurl/files

# Custom port
hurlbox --port 8080

# Load environment file
hurlbox --env-file .env

Frontend Development

cd web
pnpm install
pnpm dev

Desktop App (Work in Progress)

A native desktop application is in development using GPUI, the GPU-accelerated UI framework from Zed Industries.

Preview

License

MIT