diff --git a/README.md b/README.md index 10df2416e..f6c6f091b 100644 --- a/README.md +++ b/README.md @@ -950,10 +950,16 @@ will follow a redirection only for the second entry. | --file-root <DIR> | Set root file system to import files in Hurl. This is used for both files in multipart form data and request body.
When this is not explicitly defined, the files are relative to the current directory in which Hurl is running.
| | -L, --location | Follow redirect. To limit the amount of redirects to follow use the [`--max-redirs`](#max-redirs) option
| | --glob <GLOB> | Specify input files that match the given glob pattern.

Multiple glob flags may be used. This flag supports common Unix glob patterns like *, ? and [].
However, to avoid your shell accidentally expanding glob patterns before Hurl handles them, you must use single quotes or double quotes around each pattern.
| +| -0, --http1.0 | Tells Hurl to use HTTP version 1.0 instead of using its internally preferred HTTP version.
| +| --http1.1 | Tells Hurl to use HTTP version 1.1.
| +| --http2 | Tells Hurl to use HTTP version 2.
For HTTPS, this means Hurl negotiates HTTP/2 in the TLS handshake. Hurl does this by default.
For HTTP, this means Hurl attempts to upgrade the request to HTTP/2 using the Upgrade: request header.
| +| --http3 | Tells Hurl to try HTTP/3 to the host in the URL, but fallback to earlier HTTP versions if the HTTP/3 connection establishment fails. HTTP/3 is only available for HTTPS and not for HTTP URLs.
| | -i, --include | Include the HTTP headers in the output (last entry).
| | --ignore-asserts | Ignore all asserts defined in the Hurl file.
| | -k, --insecure | This option explicitly allows Hurl to perform "insecure" SSL connections and transfers.
| | --interactive | Stop between requests.
This is similar to a break point, You can then continue (Press C) or quit (Press Q).
| +| -4, --ipv4 | This option tells Hurl to use IPv4 addresses only when resolving host names, and not for example try IPv6.
| +| -6, --ipv6 | This option tells Hurl to use IPv6 addresses only when resolving host names, and not for example try IPv4.
| | --json | Output each hurl file result to JSON. The format is very closed to HAR format.
| | --key <KEY> | Private key file name.
| | --max-redirs <NUM> | Set maximum number of redirection-followings allowed
By default, the limit is set to 50 redirections. Set this option to -1 to make it unlimited.
| @@ -1037,8 +1043,8 @@ For Debian / Ubuntu, Hurl can be installed using a binary .deb file provided in ```shell $ VERSION=4.1.0 -$ curl --location --remote-name https://github.com/Orange-OpenSource/hurl/releases/download/$VERSION/hurl_$VERSION_amd64.deb -$ sudo apt update && sudo apt install ./hurl_$VERSION_amd64.deb +$ curl --location --remote-name https://github.com/Orange-OpenSource/hurl/releases/download/$VERSION/hurl_${VERSION}_amd64.deb +$ sudo apt update && sudo apt install ./hurl_${VERSION}_amd64.deb ``` #### Alpine diff --git a/docs/manual.md b/docs/manual.md index 014af2a27..38612c694 100644 --- a/docs/manual.md +++ b/docs/manual.md @@ -162,10 +162,16 @@ will follow a redirection only for the second entry. | --file-root <DIR> | Set root file system to import files in Hurl. This is used for both files in multipart form data and request body.
When this is not explicitly defined, the files are relative to the current directory in which Hurl is running.
| | -L, --location | Follow redirect. To limit the amount of redirects to follow use the [`--max-redirs`](#max-redirs) option
| | --glob <GLOB> | Specify input files that match the given glob pattern.

Multiple glob flags may be used. This flag supports common Unix glob patterns like *, ? and [].
However, to avoid your shell accidentally expanding glob patterns before Hurl handles them, you must use single quotes or double quotes around each pattern.
| +| -0, --http1.0 | Tells Hurl to use HTTP version 1.0 instead of using its internally preferred HTTP version.
| +| --http1.1 | Tells Hurl to use HTTP version 1.1.
| +| --http2 | Tells Hurl to use HTTP version 2.
For HTTPS, this means Hurl negotiates HTTP/2 in the TLS handshake. Hurl does this by default.
For HTTP, this means Hurl attempts to upgrade the request to HTTP/2 using the Upgrade: request header.
| +| --http3 | Tells Hurl to try HTTP/3 to the host in the URL, but fallback to earlier HTTP versions if the HTTP/3 connection establishment fails. HTTP/3 is only available for HTTPS and not for HTTP URLs.
| | -i, --include | Include the HTTP headers in the output (last entry).
| | --ignore-asserts | Ignore all asserts defined in the Hurl file.
| | -k, --insecure | This option explicitly allows Hurl to perform "insecure" SSL connections and transfers.
| | --interactive | Stop between requests.
This is similar to a break point, You can then continue (Press C) or quit (Press Q).
| +| -4, --ipv4 | This option tells Hurl to use IPv4 addresses only when resolving host names, and not for example try IPv6.
| +| -6, --ipv6 | This option tells Hurl to use IPv6 addresses only when resolving host names, and not for example try IPv4.
| | --json | Output each hurl file result to JSON. The format is very closed to HAR format.
| | --key <KEY> | Private key file name.
| | --max-redirs <NUM> | Set maximum number of redirection-followings allowed
By default, the limit is set to 50 redirections. Set this option to -1 to make it unlimited.
| diff --git a/docs/manual/hurl.1 b/docs/manual/hurl.1 index 691fc3a9c..ac462c3b9 100644 --- a/docs/manual/hurl.1 +++ b/docs/manual/hurl.1 @@ -1,4 +1,4 @@ -.TH hurl 1 "21 Sep 2023" "hurl 4.2.0-SNAPSHOT" " Hurl Manual" +.TH hurl 1 "19 Oct 2023" "hurl 4.2.0-SNAPSHOT" " Hurl Manual" .SH NAME hurl - run and test HTTP requests. @@ -211,6 +211,24 @@ Specify input files that match the given glob pattern. Multiple glob flags may be used. This flag supports common Unix glob patterns like *, ? and []. However, to avoid your shell accidentally expanding glob patterns before Hurl handles them, you must use single quotes or double quotes around each pattern. +.IP "-0, --http1.0 " + +Tells Hurl to use HTTP version 1.0 instead of using its internally preferred HTTP version. + +.IP "--http1.1 " + +Tells Hurl to use HTTP version 1.1. + +.IP "--http2 " + +Tells Hurl to use HTTP version 2. +For HTTPS, this means Hurl negotiates HTTP/2 in the TLS handshake. Hurl does this by default. +For HTTP, this means Hurl attempts to upgrade the request to HTTP/2 using the Upgrade: request header. + +.IP "--http3 " + +Tells Hurl to try HTTP/3 to the host in the URL, but fallback to earlier HTTP versions if the HTTP/3 connection establishment fails. HTTP/3 is only available for HTTPS and not for HTTP URLs. + .IP "-i, --include " Include the HTTP headers in the output (last entry). @@ -228,6 +246,14 @@ This option explicitly allows Hurl to perform "insecure" SSL connections and tra Stop between requests. This is similar to a break point, You can then continue (Press C) or quit (Press Q). +.IP "-4, --ipv4 " + +This option tells Hurl to use IPv4 addresses only when resolving host names, and not for example try IPv6. + +.IP "-6, --ipv6 " + +This option tells Hurl to use IPv6 addresses only when resolving host names, and not for example try IPv4. + .IP "--json " Output each hurl file result to JSON. The format is very closed to HAR format. diff --git a/docs/manual/hurl.md b/docs/manual/hurl.md index f0a632390..534a3de60 100644 --- a/docs/manual/hurl.md +++ b/docs/manual/hurl.md @@ -230,6 +230,24 @@ Specify input files that match the given glob pattern. Multiple glob flags may be used. This flag supports common Unix glob patterns like *, ? and []. However, to avoid your shell accidentally expanding glob patterns before Hurl handles them, you must use single quotes or double quotes around each pattern. +### -0, --http1.0 {#http10} + +Tells Hurl to use HTTP version 1.0 instead of using its internally preferred HTTP version. + +### --http1.1 {#http11} + +Tells Hurl to use HTTP version 1.1. + +### --http2 {#http2} + +Tells Hurl to use HTTP version 2. +For HTTPS, this means Hurl negotiates HTTP/2 in the TLS handshake. Hurl does this by default. +For HTTP, this means Hurl attempts to upgrade the request to HTTP/2 using the Upgrade: request header. + +### --http3 {#http3} + +Tells Hurl to try HTTP/3 to the host in the URL, but fallback to earlier HTTP versions if the HTTP/3 connection establishment fails. HTTP/3 is only available for HTTPS and not for HTTP URLs. + ### -i, --include {#include} Include the HTTP headers in the output (last entry). @@ -247,6 +265,14 @@ This option explicitly allows Hurl to perform "insecure" SSL connections and tra Stop between requests. This is similar to a break point, You can then continue (Press C) or quit (Press Q). +### -4, --ipv4 {#ipv4} + +This option tells Hurl to use IPv4 addresses only when resolving host names, and not for example try IPv6. + +### -6, --ipv6 {#ipv6} + +This option tells Hurl to use IPv6 addresses only when resolving host names, and not for example try IPv4. + ### --json {#json} Output each hurl file result to JSON. The format is very closed to HAR format. diff --git a/docs/manual/hurlfmt.1 b/docs/manual/hurlfmt.1 index e4f9c8846..15316193f 100644 --- a/docs/manual/hurlfmt.1 +++ b/docs/manual/hurlfmt.1 @@ -1,4 +1,4 @@ -.TH hurl 1 "21 Sep 2023" "hurl 4.2.0-SNAPSHOT" " Hurl Manual" +.TH hurl 1 "19 Oct 2023" "hurl 4.2.0-SNAPSHOT" " Hurl Manual" .SH NAME hurlfmt - format Hurl files diff --git a/packages/hurl/README.md b/packages/hurl/README.md index ec1b2a2a3..fe713e3bf 100644 --- a/packages/hurl/README.md +++ b/packages/hurl/README.md @@ -949,10 +949,16 @@ will follow a redirection only for the second entry. | --file-root <DIR> | Set root file system to import files in Hurl. This is used for both files in multipart form data and request body.
When this is not explicitly defined, the files are relative to the current directory in which Hurl is running.
| | -L, --location | Follow redirect. To limit the amount of redirects to follow use the [`--max-redirs`](#max-redirs) option
| | --glob <GLOB> | Specify input files that match the given glob pattern.

Multiple glob flags may be used. This flag supports common Unix glob patterns like *, ? and [].
However, to avoid your shell accidentally expanding glob patterns before Hurl handles them, you must use single quotes or double quotes around each pattern.
| +| -0, --http1.0 | Tells Hurl to use HTTP version 1.0 instead of using its internally preferred HTTP version.
| +| --http1.1 | Tells Hurl to use HTTP version 1.1.
| +| --http2 | Tells Hurl to use HTTP version 2.
For HTTPS, this means Hurl negotiates HTTP/2 in the TLS handshake. Hurl does this by default.
For HTTP, this means Hurl attempts to upgrade the request to HTTP/2 using the Upgrade: request header.
| +| --http3 | Tells Hurl to try HTTP/3 to the host in the URL, but fallback to earlier HTTP versions if the HTTP/3 connection establishment fails. HTTP/3 is only available for HTTPS and not for HTTP URLs.
| | -i, --include | Include the HTTP headers in the output (last entry).
| | --ignore-asserts | Ignore all asserts defined in the Hurl file.
| | -k, --insecure | This option explicitly allows Hurl to perform "insecure" SSL connections and transfers.
| | --interactive | Stop between requests.
This is similar to a break point, You can then continue (Press C) or quit (Press Q).
| +| -4, --ipv4 | This option tells Hurl to use IPv4 addresses only when resolving host names, and not for example try IPv6.
| +| -6, --ipv6 | This option tells Hurl to use IPv6 addresses only when resolving host names, and not for example try IPv4.
| | --json | Output each hurl file result to JSON. The format is very closed to HAR format.
| | --key <KEY> | Private key file name.
| | --max-redirs <NUM> | Set maximum number of redirection-followings allowed
By default, the limit is set to 50 redirections. Set this option to -1 to make it unlimited.
| @@ -1036,8 +1042,8 @@ For Debian / Ubuntu, Hurl can be installed using a binary .deb file provided in ```shell $ VERSION=4.1.0 -$ curl --location --remote-name https://github.com/Orange-OpenSource/hurl/releases/download/$VERSION/hurl_$VERSION_amd64.deb -$ sudo apt update && sudo apt install ./hurl_$VERSION_amd64.deb +$ curl --location --remote-name https://github.com/Orange-OpenSource/hurl/releases/download/$VERSION/hurl_${VERSION}_amd64.deb +$ sudo apt update && sudo apt install ./hurl_${VERSION}_amd64.deb ``` #### Alpine