hurl/docs/manual/hurlfmt.1
2024-04-24 14:48:27 +00:00

137 lines
1.9 KiB
Groff

.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)