hurl/docs/manual/hurlfmt.1

.TH hurl 1 "24 Apr 2024" "hurl 5.0.0-SNAPSHOT" " Hurl Manual"
.SH NAME

hurlfmt - format Hurl files


.SH SYNOPSIS

.B hurlfmt
[options] [FILE...]


.SH DESCRIPTION

.B hurlfmt
formats Hurl files and converts them from/to other formats.

With no FILE, read standard input.


By default, hurlfmt outputs a formatted and colorized version of the input hurl file.

    $ hurl hello.hurl
    GET http://localhost:8000/hello

    HTTP/1.0 200



hurlfmt can be used to convert to other format.


    $ hurl hello.hurl --output json | jq
    {
      "entries": [
        {
          "request": {
            "method": "GET",
            "url": "http://localhost:8000/hello"
          },
          "response": {
            "version": "HTTP/1.0",
            "status": 200
          }
        }
      ]
    }



hurlfmt can also be used to convert a curl command-line to Hurl

    $ echo "curl http://localhost:8000/custom-headers -H 'Fruit:Raspberry'" | hurlfmt --in curl
    GET http://localhost:8000/custom-headers
    Fruit: Raspberry


.SH OPTIONS


.IP "--check "

Run in 'check' mode. Exits with 0 if input is formatted correctly, 1 otherwise.

This can not be used with \fI--output\fP.

This option is not stable yet.

.IP "--color "

Colorize Output.

This can not be used \fI--in-place\fP.

.IP "--in <FORMAT> "

Specify input format: hurl or curl.

.IP "--in-place "

Modify file in place.

This can be used only with text output.

.IP "--no-color "

Do not colorize output.

.IP "--out <FORMAT> "

Specify output format: hurl, json or html.

.IP "-o, --output <FILE> "

Write output to FILE instead of stdout.

.IP "--standalone "

Output full html file with css instead of html fragment (default).

This can be used only with html output.

.IP "-h, --help "

Usage help.


.IP "-V, --version "

Prints version information




.SH EXIT CODES

.IP "1"

Failed to parse command-line options.


.IP "2"

Input File Parsing Error.


.SH WWW

\fIhttps://hurl.dev\fP


.SH SEE ALSO

hurl(1)