←back to thread

Hurl: Run and test HTTP requests with plain text

(github.com)
460 points flykespice | 2 comments | 20 Jun 25 03:55 UTC | HN request time: 0.557s | source
Show context
jicea ◴[20 Jun 25 05:13 UTC] No.44324928[source]▶
Hi Hurl maintainer here, happy to answer any question and get feedbacks!
replies(7): >>44325286 #>>44325359 #>>44325931 #>>44325991 #>>44326925 #>>44328252 #>>44328285 #
gavinray ◴[20 Jun 25 09:17 UTC] No.44325931[source]▶
So, myself and many folks I know have taken to writing tests in the form of ".http" files that can be executed by IDE extensions in VS Code/IDEA.

Those basically go in the form

   POST http://localhost:8080/api/foo
   Content-Type: application/json

   { "some": "body" }
And then we have a 1-to-1 mapping of "expected.json" outputs for integration tests.

We use a bespoke bash script to run these .http file with cURL, and then compare the outputs with jq, log success/failure to console, and write "actual.json"

Can I use HURL in a similar way? Essentially an IDE-runnable example HTTP request that references a JSON file as the expected output?

And then run HURL over a directory of these files?

replies(2): >>44327779 #>>44328947 #
1. digikata ◴[20 Jun 25 15:55 UTC] No.44328947[source]▶
You can use hurl in this way. I have projects with a test directory of hurl files, one hurl file per test case. The cases can run one or more http requests. The hurl file can reference external files, capture values from responses for subsequent requests, validate status and outputs. Hurl has various test runner modes and will optionally output overall test results in various parsable formats if you have a larger reporting framework that you would like to hook into.
replies(1): >>44329272 #
2. gavinray ◴[20 Jun 25 16:21 UTC] No.44329272[source]▶
That's great to know! Do you have an example on-hand by chance?

If that's possible, I guess the only thing I'd request is interopability with the REST Client ".http" files that VS Code/JetBrains IDE's support then.

UPDATE: Found it, looks like you can do it via the below

    POST https://example.org/api/tests
    Content-Type: application/json
    file,insert_user.request.json;

    [Asserts]
    body == file,insert_user.expected.json;
So that just leaves the IDE integration bit.