hurl

Run requests from a Hurl file

$ hurl [path/to/file.hurl]

$ hurl --test [path/to/file.hurl]

$ hurl --verbose [path/to/file.hurl]

$ hurl --variable [name]=[value] [path/to/file.hurl]

$ hurl --parallel [path/to/file1.hurl] [path/to/file2.hurl]

$ hurl --json [path/to/file.hurl]

$ hurl --retry [3] [path/to/file.hurl]

hurl [options] [FILE ...]

hurl is a command-line tool that runs HTTP requests defined in simple plain text .hurl files. It can chain multiple requests, capture values from responses, and evaluate assertions on headers, status codes, and body content using XPath, JSONPath, and regex queries.
Hurl supports REST, SOAP, GraphQL, and any XML/JSON-based API. It handles authentication, cookies, form data, multipart uploads, and binary bodies. Built in Rust and powered by libcurl, it is a single binary with no runtime dependencies.
Hurl is designed for both fetching data and testing HTTP sessions, with built-in support for assertions on response status, headers, body content, duration, and SSL certificates. Multiple report formats (text, JUnit, TAP, HTML) make it easy to integrate into CI/CD pipelines.

-u, --user user:password

Add basic authentication credentials

Add a custom HTTP header

Follow HTTP redirects

Activate test mode with progress reporting

Output results in JSON format

Run files concurrently

Number of retry attempts on failure

Pause before each request

Define a template variable

Load variables from a file

Define a redacted variable (hidden from logs)

Write response body to file

Allow insecure SSL connections

Enable detailed logging

Enable extra-detailed logging including request/response bodies

Proceed despite assertion failures

Start execution at a specific entry

Stop execution at a specific entry

Hurl files use a custom format that is not compatible with curl command syntax despite the shared libcurl backend. The plain text format requires learning Hurl's specific syntax for assertions and captures. Error messages for malformed .hurl files can be cryptic.

hurl was created by Orange-OpenSource (the French telecommunications company) and first released on GitHub in August 2020. Written in Rust with libcurl as its HTTP engine, it has grown to over 18,000 GitHub stars and is actively maintained.

curl(1), wget(1), httpie(1)