PROVIDER - HTTP tests written in plain text

Hurl

Hurl describes HTTP requests and assertions in 1 plain text file, supporting 6 or more assertion families with chained requests and variable passing, running as a single binary in 3 or more pipelines under Apache 2.0 from Orange; the gaps are no GUI and limited expressiveness.

Developer Tools France 2026.11.19
4.1pts

Detailed Notes

Pros 5 items

Describes requests and assertions in 1 plain text .hurl file that stays in version control
Supports 6 or more assertion families covering status codes, headers, JSON and XML
Chains multiple requests while passing variables, covering 1 complete business flow
Runs as a single binary that fits 3 or more mainstream pipelines
Released under Apache 2.0 and maintained by the Orange open source team

Cons 4 items

No graphical debugger, so the text syntax must be learned
Complex logic relies on templates and scripts, less expressive than code-based tests
The community is small, limiting third-party material
Report visualisation needs CI tooling alongside

Service Overview

Hurl is an HTTP testing tool maintained by the Orange open source team, describing requests, assertions and variable passing in plain text files.

In the development tools category it is interface regression tooling: write tests in a request file format, yet assert, chain and run them in CI.

Key Strengths

  • Plain text cases: versionable and reviewable
  • Strong assertions: 6 or more families
  • Flow chaining: variables across requests
  • Single binary: simple install
  • Auditable open source: Apache 2.0

Product Ecosystem

Platform capabilities

Request definition and assertions, variables and templates, chained calls, HTML report export and request syntax conversion.

Integrations

Fits GitHub Actions, GitLab CI and Jenkins pipelines and combines with Docker and Kubernetes health checks.

Typical scenarios

Interface regression tests, contract smoke checks, post-release verification and monitoring script reuse.

Limitations

  • No GUI: debugging is command line based
  • Expressiveness: complex logic needs scripting
  • Community size: relatively few resources
  • Reporting: visualisation needs external tools

Use Cases

  • Interface regression and smoke tests (★★★★★): text cases age well
  • Post-release verification (★★★★☆): scripts get reused
  • Complex business flows (★★★☆☆): pair with scripts
  • Low-code test platforms needs (★★☆☆☆): not applicable

Pricing

Item Price Notes
Hurl $0 Apache 2.0, free and open source
Installation $0 brew, apt or cargo
Enterprise support Community No commercial licence fee

FAQ

How is it different from curl?

Hurl extends a plain request syntax with assertions, variables and chained execution.

Does it support file uploads?

Yes, multipart requests and file fields are supported.

Can it produce reports?

JUnit and HTML report formats are available for CI integration.

Does it handle HTTPS and certificates?

Yes, client certificates and verification options are configurable.

Code Examples

# demo.hurl
GET https://api.example.com/orders/1
HTTP 200
[Asserts]
jsonpath "$.id" == 1
header "Content-Type" contains "application/json"

POST https://api.example.com/orders
{
  "sku": "demo-1",
  "qty": 2
}
HTTP 201
[Captures]
order_id: jsonpath "$.id"

GET https://api.example.com/orders/{{order_id}}
HTTP 200
[Asserts]
jsonpath "$.qty" == 2
# Run tests and export an HTML report
hurl --test --report-html report demo.hurl

# Run a whole directory in parallel
hurl --test --parallel --jobs 4 tests/

Community & Resources

Visit Hurl Website → https://hurl.dev/
Visit Website ↗