Accepting request 1188330 from network:utilities
OBS-URL: https://build.opensuse.org/request/show/1188330 OBS-URL: https://build.opensuse.org/package/show/openSUSE:Factory/httpie?expand=0&rev=15
This commit is contained in:
commit
f16a7afa9c
15
_service
Normal file
15
_service
Normal file
@ -0,0 +1,15 @@
|
||||
<services>
|
||||
<service name="obs_scm" mode="manual">
|
||||
<param name="versionprefix">3.2.3</param>
|
||||
<param name="url">https://github.com/httpie/cli.git</param>
|
||||
<param name="revision">f4cf43ecdd6c5c52b5c4ba91086d5c6ccfebcd6d</param>
|
||||
<param name="scm">git</param>
|
||||
<param name="submodules">enable</param>
|
||||
<param name="changesgenerate">disable</param>
|
||||
</service>
|
||||
<service name="tar" mode="buildtime"/>
|
||||
<service name="recompress" mode="buildtime">
|
||||
<param name="compression">gz</param>
|
||||
<param name="file">*.tar</param>
|
||||
</service>
|
||||
</services>
|
3
cli-3.2.3.1720621443.f4cf43e.obscpio
Normal file
3
cli-3.2.3.1720621443.f4cf43e.obscpio
Normal file
@ -0,0 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:f3c0ea874cbf202153e32251af4630340d8388c4a7b656174c61c586d10b956d
|
||||
size 2149900
|
4
cli.obsinfo
Normal file
4
cli.obsinfo
Normal file
@ -0,0 +1,4 @@
|
||||
name: cli
|
||||
version: 3.2.3.1720621443.f4cf43e
|
||||
mtime: 1720621443
|
||||
commit: f4cf43ecdd6c5c52b5c4ba91086d5c6ccfebcd6d
|
768
http.1
768
http.1
@ -1,292 +1,600 @@
|
||||
.TH HTTP "1" "February 2016" "http 0.9.2" "User Commands"
|
||||
.\" This file is auto-generated from the parser declaration in httpie/cli/definition.py by extras/scripts/generate_man_pages.py.
|
||||
.TH http 1 "2024-07-10" "HTTPie 3.2.3" "HTTPie Manual"
|
||||
.SH NAME
|
||||
httpie - CLI, cURL-like tool for humans
|
||||
http
|
||||
.SH SYNOPSIS
|
||||
.TP
|
||||
.B http
|
||||
.RI
|
||||
[\-\-json] [\-\-form] [\-\-pretty {all,colors,format,none}] [\-\-style STYLE]
|
||||
[\-\-print WHAT] [\-\-verbose] [\-\-headers] [\-\-body] [\-\-stream]
|
||||
[\-\-output FILE] [\-\-download] [\-\-continue]
|
||||
[\-\-session SESSION_NAME_OR_PATH | \-\-session\-read\-only SESSION_NAME_OR_PATH]
|
||||
[\-\-auth USER[:PASS]] [\-\-auth\-type {basic,digest}]
|
||||
[\-\-proxy PROTOCOL:PROXY_URL] [\-\-follow] [\-\-verify VERIFY]
|
||||
[\-\-cert CERT] [\-\-cert\-key CERT_KEY] [\-\-timeout SECONDS]
|
||||
[\-\-check\-status] [\-\-ignore\-stdin] [\-\-help] [\-\-version]
|
||||
[\-\-traceback] [\-\-debug]
|
||||
.br
|
||||
[METHOD] \fIURL\fR [REQUEST_ITEM [REQUEST_ITEM ...]]
|
||||
http [METHOD] URL [REQUEST_ITEM ...]
|
||||
|
||||
.SH DESCRIPTION
|
||||
\fBHTTPie\fP is a CLI HTTP utility built out of frustration with existing tools.
|
||||
The goal is to make CLI interaction with HTTP-based services as human-friendly
|
||||
as possible.
|
||||
.PP
|
||||
HTTPie does so by providing an http command that allows for issuing arbitrary
|
||||
HTTP requests using a simple and natural syntax and displaying colorized responses.
|
||||
HTTPie: modern, user-friendly command-line HTTP client for the API era. <https://httpie.io>
|
||||
.SH Positional arguments
|
||||
|
||||
.SH OPTIONS
|
||||
.SS Positional Arguments
|
||||
These arguments come after any flags and in the order they are listed here.
|
||||
Only URL is required.
|
||||
.TP
|
||||
METHOD
|
||||
|
||||
.IP "\fB\,METHOD\/\fR"
|
||||
|
||||
|
||||
The HTTP method to be used for the request (GET, POST, PUT, DELETE, ...).
|
||||
.br
|
||||
|
||||
This argument can be omitted in which case HTTPie will use POST if there
|
||||
is some data to be sent, otherwise GET:
|
||||
|
||||
\f(CW$ http example.org # => GET\fR
|
||||
$ http example.org # => GET
|
||||
$ http example.org hello=world # => POST
|
||||
|
||||
\f(CW$ http example.org hello=world # => POST\fR
|
||||
|
||||
.TP
|
||||
URL
|
||||
|
||||
The scheme defaults to 'http://' if the URL does not include one.
|
||||
.IP "\fB\,URL\/\fR"
|
||||
|
||||
|
||||
The request URL. Scheme defaults to \[aq]http://\[aq] if the URL
|
||||
does not include one. (You can override this with: \fB\,--default-scheme\/\fR=http/https)
|
||||
|
||||
You can also use a shorthand for localhost
|
||||
|
||||
\f(CW$ http :3000 # => http://localhost:3000\fR
|
||||
$ http :3000 # => http://localhost:3000
|
||||
$ http :/foo # => http://localhost/foo
|
||||
|
||||
\f(CW$ http :/foo # => http://localhost/foo\fR
|
||||
|
||||
.TP
|
||||
REQUEST_ITEM
|
||||
|
||||
Optional key\-value pairs to be included in the request. The separator used
|
||||
.IP "\fB\,REQUEST_ITEM\/\fR"
|
||||
|
||||
|
||||
Optional key-value pairs to be included in the request. The separator used
|
||||
determines the type:
|
||||
|
||||
\fB':'\fR HTTP headers
|
||||
Referer:http://httpie.org
|
||||
Cookie:foo=bar
|
||||
User\-Agent:bacon/1.0
|
||||
\[aq]:\[aq] HTTP headers:
|
||||
|
||||
\fB'=='\fR URL parameters to be appended to the request URI
|
||||
search==httpie
|
||||
Referer:https://httpie.io Cookie:foo=bar User-Agent:bacon/1.0
|
||||
|
||||
\fB'='\fR Data fields to be serialized into a JSON object
|
||||
(with \fB\-\-json\fR, \fB\-j\fR) or form data (with \fB\-\-form\fR, \fB\-f\fR)
|
||||
name=HTTPie
|
||||
language=Python
|
||||
description='CLI HTTP client'
|
||||
\[aq]==\[aq] URL parameters to be appended to the request URI:
|
||||
|
||||
\fB':='\fR Non\-string JSON data fields (only with \fB\-\-json\fR, \fB\-j\fR)
|
||||
awesome:=true
|
||||
amount:=42
|
||||
colors:='["red", "green", "blue"]'
|
||||
search==httpie
|
||||
|
||||
\fB'@'\fR Form file fields (only with \fB\-\-form\fR, \fB\-f\fR)
|
||||
cs@~/Documents/CV.pdf
|
||||
\[aq]=\[aq] Data fields to be serialized into a JSON object (with \fB\,--json\/\fR, \fB\,-j\/\fR)
|
||||
or form data (with \fB\,--form\/\fR, \fB\,-f\/\fR):
|
||||
|
||||
\fB'=@'\fR A data field like '=', but takes a file path and embeds its content:
|
||||
essay=@Documents/essay.txt
|
||||
name=HTTPie language=Python description=\[aq]CLI HTTP client\[aq]
|
||||
|
||||
\fB':=@'\fR A raw JSON field like ':=', but takes a file path and embeds its content:
|
||||
package:=@./package.json
|
||||
\[aq]:=\[aq] Non-string JSON data fields (only with \fB\,--json\/\fR, \fB\,-j\/\fR):
|
||||
|
||||
awesome:=true amount:=42 colors:=\[aq][\[dq]red\[dq], \[dq]green\[dq], \[dq]blue\[dq]]\[aq]
|
||||
|
||||
\[aq]@\[aq] Form file fields (only with \fB\,--form\/\fR or \fB\,--multipart\/\fR):
|
||||
|
||||
cv@\(ti/Documents/CV.pdf
|
||||
cv@\[aq]\(ti/Documents/CV.pdf;type=application/pdf\[aq]
|
||||
|
||||
\[aq]=@\[aq] A data field like \[aq]=\[aq], but takes a file path and embeds its content:
|
||||
|
||||
essay=@Documents/essay.txt
|
||||
|
||||
\[aq]:=@\[aq] A raw JSON field like \[aq]:=\[aq], but takes a file path and embeds its content:
|
||||
|
||||
package:=@./package.json
|
||||
|
||||
You can use a backslash to escape a colliding separator in the field name:
|
||||
|
||||
field\-name\-with\e:colon=value
|
||||
field-name-with\e:colon=value
|
||||
|
||||
|
||||
|
||||
.PP
|
||||
.SH Predefined content types
|
||||
.IP "\fB\,--json\/\fR, \fB\,-j\/\fR"
|
||||
|
||||
|
||||
.SS "Predefined Content Types:"
|
||||
.HP
|
||||
\fB\-\-json\fR, \fB\-j\fR
|
||||
.IP
|
||||
(default) Data items from the command line are serialized as a JSON object.
|
||||
The Content\-Type and Accept headers are set to application/json
|
||||
The Content-Type and Accept headers are set to application/json
|
||||
(if not specified).
|
||||
.HP
|
||||
\fB\-\-form\fR, \fB\-f\fR
|
||||
.IP
|
||||
|
||||
|
||||
|
||||
.IP "\fB\,--form\/\fR, \fB\,-f\/\fR"
|
||||
|
||||
|
||||
Data items from the command line are serialized as form fields.
|
||||
.IP
|
||||
The Content\-Type is set to application/x\-www\-form\-urlencoded (if not
|
||||
|
||||
The Content-Type is set to application/x-www-form-urlencoded (if not
|
||||
specified). The presence of any file fields results in a
|
||||
multipart/form\-data request.
|
||||
.SS "Output Processing:"
|
||||
.HP
|
||||
\fB\-\-pretty\fR {all,colors,format,none}
|
||||
.IP
|
||||
Controls output processing. The value can be "none" to not prettify
|
||||
the output (default for redirected output), "all" to apply both colors
|
||||
and formatting (default for terminal output), "colors", or "format".
|
||||
.HP
|
||||
\fB\-\-style\fR STYLE, \fB\-s\fR STYLE
|
||||
.IP
|
||||
Output coloring style (default is "solarized"). One of:
|
||||
.IP
|
||||
algol, algol_nu, autumn, borland, bw, colorful, default,
|
||||
emacs, friendly, fruity, igor, lovelace, manni, monokai,
|
||||
murphy, native, paraiso\-dark, paraiso\-light, pastie,
|
||||
perldoc, rrt, solarized, tango, trac, vim, vs, xcode
|
||||
.IP
|
||||
For this option to work properly, please make sure that the $TERM
|
||||
environment variable is set to "xterm\-256color" or similar
|
||||
(e.g., via `export TERM=xterm\-256color' in your ~/.bashrc).
|
||||
.SS "Output Options:"
|
||||
.HP
|
||||
\fB\-\-print\fR WHAT, \fB\-p\fR WHAT
|
||||
.IP
|
||||
multipart/form-data request.
|
||||
|
||||
|
||||
|
||||
.IP "\fB\,--multipart\/\fR"
|
||||
|
||||
|
||||
Similar to \fB\,--form\/\fR, but always sends a multipart/form-data request (i.e., even without files).
|
||||
|
||||
|
||||
.IP "\fB\,--boundary\/\fR"
|
||||
|
||||
|
||||
Specify a custom boundary string for multipart/form-data requests. Only has effect only together with \fB\,--form\/\fR.
|
||||
|
||||
|
||||
.IP "\fB\,--raw\/\fR"
|
||||
|
||||
|
||||
This option allows you to pass raw request data without extra processing
|
||||
(as opposed to the structured request items syntax):
|
||||
|
||||
$ http \fB\,--raw\/\fR=\[aq]data\[aq] pie.dev/post
|
||||
|
||||
You can achieve the same by piping the data via stdin:
|
||||
|
||||
$ echo data | http pie.dev/post
|
||||
|
||||
Or have HTTPie load the raw data from a file:
|
||||
|
||||
$ http pie.dev/post @data.txt
|
||||
|
||||
|
||||
|
||||
|
||||
.PP
|
||||
.SH Content processing options
|
||||
.IP "\fB\,--compress\/\fR, \fB\,-x\/\fR"
|
||||
|
||||
|
||||
Content compressed (encoded) with Deflate algorithm.
|
||||
The Content-Encoding header is set to deflate.
|
||||
|
||||
Compression is skipped if it appears that compression ratio is
|
||||
negative. Compression can be forced by repeating the argument.
|
||||
|
||||
|
||||
|
||||
.PP
|
||||
.SH Output processing
|
||||
.IP "\fB\,--pretty\/\fR"
|
||||
|
||||
|
||||
Controls output processing. The value can be \[dq]none\[dq] to not prettify
|
||||
the output (default for redirected output), \[dq]all\[dq] to apply both colors
|
||||
and formatting (default for terminal output), \[dq]colors\[dq], or \[dq]format\[dq].
|
||||
|
||||
|
||||
|
||||
.IP "\fB\,--style\/\fR, \fB\,-s\/\fR \fI\,STYLE\/\fR"
|
||||
|
||||
|
||||
Output coloring style (default is \[dq]auto\[dq]). It can be one of:
|
||||
|
||||
auto, pie, pie-dark, pie-light, solarized
|
||||
|
||||
|
||||
For finding out all available styles in your system, try:
|
||||
|
||||
$ http \fB\,--style\/\fR
|
||||
|
||||
The \[dq]auto\[dq] style follows your terminal\[aq]s ANSI color styles.
|
||||
For non-auto styles to work properly, please make sure that the
|
||||
$TERM environment variable is set to \[dq]xterm-256color\[dq] or similar
|
||||
(e.g., via `export TERM=xterm-256color\[aq] in your \(ti/.bashrc).
|
||||
|
||||
.IP "\fB\,--unsorted\/\fR"
|
||||
|
||||
|
||||
Disables all sorting while formatting output. It is a shortcut for:
|
||||
|
||||
\fB\,--format-options\/\fR=headers.sort:false,json.sort_keys:false
|
||||
|
||||
|
||||
|
||||
.IP "\fB\,--sorted\/\fR"
|
||||
|
||||
|
||||
Re-enables all sorting options while formatting output. It is a shortcut for:
|
||||
|
||||
\fB\,--format-options\/\fR=headers.sort:true,json.sort_keys:true
|
||||
|
||||
|
||||
|
||||
.IP "\fB\,--response-charset\/\fR \fI\,ENCODING\/\fR"
|
||||
|
||||
|
||||
Override the response encoding for terminal display purposes, e.g.:
|
||||
|
||||
\fB\,--response-charset\/\fR=utf8
|
||||
\fB\,--response-charset\/\fR=big5
|
||||
|
||||
|
||||
|
||||
.IP "\fB\,--response-mime\/\fR \fI\,MIME_TYPE\/\fR"
|
||||
|
||||
|
||||
Override the response mime type for coloring and formatting for the terminal, e.g.:
|
||||
|
||||
\fB\,--response-mime\/\fR=application/json
|
||||
\fB\,--response-mime\/\fR=text/xml
|
||||
|
||||
|
||||
|
||||
.IP "\fB\,--format-options\/\fR"
|
||||
|
||||
|
||||
Controls output formatting. Only relevant when formatting is enabled
|
||||
through (explicit or implied) \fB\,--pretty\/\fR=all or \fB\,--pretty\/\fR=format.
|
||||
The following are the default options:
|
||||
|
||||
headers.sort:true
|
||||
json.format:true
|
||||
json.indent:4
|
||||
json.sort_keys:true
|
||||
xml.format:true
|
||||
xml.indent:2
|
||||
|
||||
You may use this option multiple times, as well as specify multiple
|
||||
comma-separated options at the same time. For example, this modifies the
|
||||
settings to disable the sorting of JSON keys, and sets the indent size to 2:
|
||||
|
||||
\fB\,--format-options\/\fR json.sort_keys:false,json.indent:2
|
||||
|
||||
This is something you will typically put into your config file.
|
||||
|
||||
|
||||
|
||||
.PP
|
||||
.SH Output options
|
||||
.IP "\fB\,--print\/\fR, \fB\,-p\/\fR \fI\,WHAT\/\fR"
|
||||
|
||||
|
||||
String specifying what the output should contain:
|
||||
.IP
|
||||
\&'H' request headers
|
||||
\&'B' request body
|
||||
\&'h' response headers
|
||||
\&'b' response body
|
||||
.IP
|
||||
The default behaviour is 'hb' (i.e., the response headers and body
|
||||
is printed), if standard output is not redirected. If the output is piped
|
||||
to another program or to a file, then only the response body is printed
|
||||
by default.
|
||||
.HP
|
||||
\fB\-\-verbose\fR, \fB\-v\fR
|
||||
.IP
|
||||
Print the whole request as well as the response. Shortcut for \fB\-\-print\fR=\fI\,HBbh\/\fR.
|
||||
.HP
|
||||
\fB\-\-headers\fR, \fB\-h\fR
|
||||
.IP
|
||||
Print only the response headers. Shortcut for \fB\-\-print\fR=\fI\,h\/\fR.
|
||||
.HP
|
||||
\fB\-\-body\fR, \fB\-b\fR
|
||||
.IP
|
||||
Print only the response body. Shortcut for \fB\-\-print\fR=\fI\,b\/\fR.
|
||||
.HP
|
||||
\fB\-\-stream\fR, \fB\-S\fR
|
||||
.IP
|
||||
Always stream the output by line, i.e., behave like `tail \fB\-f\fR'.
|
||||
.IP
|
||||
Without \fB\-\-stream\fR and with \fB\-\-pretty\fR (either set or implied),
|
||||
|
||||
\[aq]H\[aq] request headers
|
||||
\[aq]B\[aq] request body
|
||||
\[aq]h\[aq] response headers
|
||||
\[aq]b\[aq] response body
|
||||
\[aq]m\[aq] response metadata
|
||||
|
||||
The default behaviour is \[aq]hb\[aq] (i.e., the response
|
||||
headers and body is printed), if standard output is not redirected.
|
||||
If the output is piped to another program or to a file, then only the
|
||||
response body is printed by default.
|
||||
|
||||
|
||||
|
||||
.IP "\fB\,--headers\/\fR, \fB\,-h\/\fR"
|
||||
|
||||
|
||||
Print only the response headers. Shortcut for \fB\,--print\/\fR=h.
|
||||
|
||||
|
||||
|
||||
.IP "\fB\,--meta\/\fR, \fB\,-m\/\fR"
|
||||
|
||||
|
||||
Print only the response metadata. Shortcut for \fB\,--print\/\fR=m.
|
||||
|
||||
|
||||
|
||||
.IP "\fB\,--body\/\fR, \fB\,-b\/\fR"
|
||||
|
||||
|
||||
Print only the response body. Shortcut for \fB\,--print\/\fR=b.
|
||||
|
||||
|
||||
|
||||
.IP "\fB\,--verbose\/\fR, \fB\,-v\/\fR"
|
||||
|
||||
|
||||
Verbose output. For the level one (with single `\fB\,-v\/\fR`/`\fB\,--verbose\/\fR`), print
|
||||
the whole request as well as the response. Also print any intermediary
|
||||
requests/responses (such as redirects). For the second level and higher,
|
||||
print these as well as the response metadata.
|
||||
|
||||
Level one is a shortcut for: \fB\,--all\/\fR \fB\,--print\/\fR=BHbh
|
||||
Level two is a shortcut for: \fB\,--all\/\fR \fB\,--print\/\fR=BHbhm
|
||||
|
||||
|
||||
.IP "\fB\,--all\/\fR"
|
||||
|
||||
|
||||
By default, only the final request/response is shown. Use this flag to show
|
||||
any intermediary requests/responses as well. Intermediary requests include
|
||||
followed redirects (with \fB\,--follow\/\fR), the first unauthorized request when
|
||||
Digest auth is used (\fB\,--auth\/\fR=digest), etc.
|
||||
|
||||
|
||||
|
||||
.IP "\fB\,--stream\/\fR, \fB\,-S\/\fR"
|
||||
|
||||
|
||||
Always stream the response body by line, i.e., behave like `tail \fB\,-f\/\fR\[aq].
|
||||
|
||||
Without \fB\,--stream\/\fR and with \fB\,--pretty\/\fR (either set or implied),
|
||||
HTTPie fetches the whole response before it outputs the processed data.
|
||||
.IP
|
||||
|
||||
Set this option when you want to continuously display a prettified
|
||||
long\-lived response, such as one from the Twitter streaming API.
|
||||
.IP
|
||||
It is useful also without \fB\-\-pretty\fR: It ensures that the output is flushed
|
||||
long-lived response, such as one from the Twitter streaming API.
|
||||
|
||||
It is useful also without \fB\,--pretty\/\fR: It ensures that the output is flushed
|
||||
more often and in smaller chunks.
|
||||
.HP
|
||||
\fB\-\-output\fR FILE, \fB\-o\fR FILE
|
||||
.IP
|
||||
Save output to FILE. If \fB\-\-download\fR is set, then only the response body is
|
||||
saved to the file. Other parts of the HTTP exchange are printed to stderr.
|
||||
.HP
|
||||
\fB\-\-download\fR, \fB\-d\fR
|
||||
.IP
|
||||
|
||||
|
||||
|
||||
.IP "\fB\,--output\/\fR, \fB\,-o\/\fR \fI\,FILE\/\fR"
|
||||
|
||||
|
||||
Save output to FILE instead of stdout. If \fB\,--download\/\fR is also set, then only
|
||||
the response body is saved to FILE. Other parts of the HTTP exchange are
|
||||
printed to stderr.
|
||||
|
||||
|
||||
|
||||
.IP "\fB\,--download\/\fR, \fB\,-d\/\fR"
|
||||
|
||||
|
||||
Do not print the response body to stdout. Rather, download it and store it
|
||||
in a file. The filename is guessed unless specified with \fB\-\-output\fR
|
||||
in a file. The filename is guessed unless specified with \fB\,--output\/\fR
|
||||
[filename]. This action is similar to the default behaviour of wget.
|
||||
.HP
|
||||
\fB\-\-continue\fR, \fB\-c\fR
|
||||
.IP
|
||||
Resume an interrupted download. Note that the \fB\-\-output\fR option needs to be
|
||||
|
||||
|
||||
|
||||
.IP "\fB\,--continue\/\fR, \fB\,-c\/\fR"
|
||||
|
||||
|
||||
Resume an interrupted download. Note that the \fB\,--output\/\fR option needs to be
|
||||
specified as well.
|
||||
.SS "Sessions:"
|
||||
.HP
|
||||
\fB\-\-session\fR SESSION_NAME_OR_PATH
|
||||
.IP
|
||||
|
||||
|
||||
|
||||
.IP "\fB\,--quiet\/\fR, \fB\,-q\/\fR"
|
||||
|
||||
|
||||
Do not print to stdout or stderr, except for errors and warnings when provided once.
|
||||
Provide twice to suppress warnings as well.
|
||||
stdout is still redirected if \fB\,--output\/\fR is specified.
|
||||
Flag doesn\[aq]t affect behaviour of download beyond not printing to terminal.
|
||||
|
||||
|
||||
|
||||
.PP
|
||||
.SH Sessions
|
||||
.IP "\fB\,--session\/\fR \fI\,SESSION_NAME_OR_PATH\/\fR"
|
||||
|
||||
|
||||
Create, or reuse and update a session. Within a session, custom headers,
|
||||
auth credential, as well as any cookies sent by the server persist between
|
||||
requests.
|
||||
.IP
|
||||
|
||||
Session files are stored in:
|
||||
.IP
|
||||
/home/gaetano/.httpie/sessions/<HOST>/<SESSION_NAME>.json.
|
||||
.HP
|
||||
\fB\-\-session\-read\-only\fR SESSION_NAME_OR_PATH
|
||||
.IP
|
||||
|
||||
[HTTPIE_CONFIG_DIR]/<HOST>/<SESSION_NAME>.json.
|
||||
|
||||
See the following page to find out your default HTTPIE_CONFIG_DIR:
|
||||
|
||||
https://httpie.io/docs/cli/config-file-directory
|
||||
|
||||
|
||||
.IP "\fB\,--session-read-only\/\fR \fI\,SESSION_NAME_OR_PATH\/\fR"
|
||||
|
||||
|
||||
Create or read a session without updating it form the request/response
|
||||
exchange.
|
||||
.SS "Authentication:"
|
||||
.HP
|
||||
\fB\-\-auth\fR USER[:PASS], \fB\-a\fR USER[:PASS]
|
||||
.IP
|
||||
If only the username is provided (\fB\-a\fR username), HTTPie will prompt
|
||||
for the password.
|
||||
.HP
|
||||
\fB\-\-auth\-type\fR {basic,digest}
|
||||
.IP
|
||||
The authentication mechanism to be used. Defaults to "basic".
|
||||
.IP
|
||||
"basic": Basic HTTP auth
|
||||
"digest": Digest HTTP auth
|
||||
.SS "Network:"
|
||||
.HP
|
||||
\fB\-\-proxy\fR PROTOCOL:PROXY_URL
|
||||
.IP
|
||||
|
||||
|
||||
|
||||
.PP
|
||||
.SH Authentication
|
||||
.IP "\fB\,--auth\/\fR, \fB\,-a\/\fR \fI\,USER[:PASS] | TOKEN\/\fR"
|
||||
|
||||
|
||||
For username/password based authentication mechanisms (e.g
|
||||
basic auth or digest auth) if only the username is provided
|
||||
(\fB\,-a\/\fR username), HTTPie will prompt for the password.
|
||||
|
||||
|
||||
|
||||
.IP "\fB\,--auth-type\/\fR, \fB\,-A\/\fR"
|
||||
|
||||
|
||||
The authentication mechanism to be used. Defaults to \[dq]basic\[dq].
|
||||
|
||||
\[dq]basic\[dq]: Basic HTTP auth
|
||||
|
||||
\[dq]digest\[dq]: Digest HTTP auth
|
||||
|
||||
\[dq]bearer\[dq]: Bearer HTTP Auth
|
||||
|
||||
To see all available auth types on your system, including ones installed via plugins, run:
|
||||
|
||||
$ http \fB\,--auth-type\/\fR
|
||||
|
||||
.IP "\fB\,--ignore-netrc\/\fR"
|
||||
|
||||
|
||||
Ignore credentials from .netrc.
|
||||
|
||||
|
||||
.PP
|
||||
.SH Network
|
||||
.IP "\fB\,--offline\/\fR"
|
||||
|
||||
|
||||
Build the request and print it but don\(gat actually send it.
|
||||
|
||||
|
||||
.IP "\fB\,--proxy\/\fR \fI\,PROTOCOL:PROXY_URL\/\fR"
|
||||
|
||||
|
||||
String mapping protocol to the URL of the proxy
|
||||
(e.g. http:http://foo.bar:3128). You can specify multiple proxies with
|
||||
different protocols.
|
||||
.HP
|
||||
\fB\-\-follow\fR
|
||||
.IP
|
||||
Set this flag if full redirects are allowed (e.g. re\-POST\-ing of data at
|
||||
new Location).
|
||||
.HP
|
||||
\fB\-\-verify\fR VERIFY
|
||||
.IP
|
||||
Set to "no" to skip checking the host's SSL certificate. You can also pass
|
||||
the path to a CA_BUNDLE file for private certs. You can also set the
|
||||
REQUESTS_CA_BUNDLE environment variable. Defaults to "yes".
|
||||
.HP
|
||||
\fB\-\-cert\fR CERT
|
||||
.IP
|
||||
You can specify a local cert to use as client side SSL certificate.
|
||||
This file may either contain both private key and certificate or you may
|
||||
specify \fB\-\-cert\-key\fR separately.
|
||||
.HP
|
||||
\fB\-\-cert\-key\fR CERT_KEY
|
||||
.IP
|
||||
The private key to use with SSL. Only needed if \fB\-\-cert\fR is given and the
|
||||
certificate file does not contain the private key.
|
||||
.HP
|
||||
\fB\-\-timeout\fR SECONDS
|
||||
.IP
|
||||
The connection timeout of the request in seconds. The default value is
|
||||
30 seconds.
|
||||
.HP
|
||||
\fB\-\-check\-status\fR
|
||||
.IP
|
||||
different protocols. The environment variables $ALL_PROXY, $HTTP_PROXY,
|
||||
and $HTTPS_proxy are supported as well.
|
||||
|
||||
|
||||
|
||||
.IP "\fB\,--follow\/\fR, \fB\,-F\/\fR"
|
||||
|
||||
|
||||
Follow 30x Location redirects.
|
||||
|
||||
|
||||
.IP "\fB\,--max-redirects\/\fR"
|
||||
|
||||
|
||||
By default, requests have a limit of 30 redirects (works with \fB\,--follow\/\fR).
|
||||
|
||||
|
||||
|
||||
.IP "\fB\,--max-headers\/\fR"
|
||||
|
||||
|
||||
The maximum number of response headers to be read before giving up (default 0, i.e., no limit).
|
||||
|
||||
|
||||
.IP "\fB\,--timeout\/\fR \fI\,SECONDS\/\fR"
|
||||
|
||||
|
||||
The connection timeout of the request in seconds.
|
||||
The default value is 0, i.e., there is no timeout limit.
|
||||
This is not a time limit on the entire response download;
|
||||
rather, an error is reported if the server has not issued a response for
|
||||
timeout seconds (more precisely, if no bytes have been received on
|
||||
the underlying socket for timeout seconds).
|
||||
|
||||
|
||||
|
||||
.IP "\fB\,--check-status\/\fR"
|
||||
|
||||
|
||||
By default, HTTPie exits with 0 when no network or other fatal errors
|
||||
occur. This flag instructs HTTPie to also check the HTTP status code and
|
||||
exit with an error if the status indicates one.
|
||||
.IP
|
||||
|
||||
When the server replies with a 4xx (Client Error) or 5xx (Server Error)
|
||||
status code, HTTPie exits with 4 or 5 respectively. If the response is a
|
||||
3xx (Redirect) and \fB\-\-follow\fR hasn't been set, then the exit status is 3.
|
||||
3xx (Redirect) and \fB\,--follow\/\fR hasn\[aq]t been set, then the exit status is 3.
|
||||
Also an error message is written to stderr if stdout is redirected.
|
||||
.SS "Troubleshooting:"
|
||||
.HP
|
||||
\fB\-\-ignore\-stdin\fR
|
||||
.IP
|
||||
Do not attempt to read stdin.
|
||||
.HP
|
||||
\fB\-\-help\fR
|
||||
.IP
|
||||
Show this help message and exit.
|
||||
.HP
|
||||
\fB\-\-version\fR
|
||||
.IP
|
||||
Show version and exit.
|
||||
.HP
|
||||
\fB\-\-traceback\fR
|
||||
.IP
|
||||
Prints exception traceback should one occur.
|
||||
.HP
|
||||
\fB\-\-debug\fR
|
||||
.IP
|
||||
Prints exception traceback should one occur, and also other information
|
||||
that is useful for debugging HTTPie itself and for reporting bugs.
|
||||
|
||||
|
||||
|
||||
.IP "\fB\,--path-as-is\/\fR"
|
||||
|
||||
|
||||
Bypass dot segment (/../ or /./) URL squashing.
|
||||
|
||||
|
||||
.IP "\fB\,--chunked\/\fR"
|
||||
|
||||
|
||||
Enable streaming via chunked transfer encoding. The Transfer-Encoding header is set to chunked.
|
||||
|
||||
|
||||
.PP
|
||||
For every \fB\-\-OPTION\fR there is also a \fB\-\-no\-OPTION\fR that reverts OPTION
|
||||
.SH SSL
|
||||
.IP "\fB\,--verify\/\fR"
|
||||
|
||||
|
||||
Set to \[dq]no\[dq] (or \[dq]false\[dq]) to skip checking the host\[aq]s SSL certificate.
|
||||
Defaults to \[dq]yes\[dq] (\[dq]true\[dq]). You can also pass the path to a CA_BUNDLE file
|
||||
for private certs. (Or you can set the REQUESTS_CA_BUNDLE environment
|
||||
variable instead.)
|
||||
|
||||
|
||||
.IP "\fB\,--ssl\/\fR"
|
||||
|
||||
|
||||
The desired protocol version to use. This will default to
|
||||
SSL v2.3 which will negotiate the highest protocol that both
|
||||
the server and your installation of OpenSSL support. Available protocols
|
||||
may vary depending on OpenSSL installation (only the supported ones
|
||||
are shown here).
|
||||
|
||||
|
||||
|
||||
.IP "\fB\,--ciphers\/\fR"
|
||||
|
||||
|
||||
|
||||
A string in the OpenSSL cipher list format.
|
||||
|
||||
|
||||
See `http \fB\,--help\/\fR` for the default ciphers list on you system.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.IP "\fB\,--cert\/\fR"
|
||||
|
||||
|
||||
You can specify a local cert to use as client side SSL certificate.
|
||||
This file may either contain both private key and certificate or you may
|
||||
specify \fB\,--cert-key\/\fR separately.
|
||||
|
||||
|
||||
|
||||
.IP "\fB\,--cert-key\/\fR"
|
||||
|
||||
|
||||
The private key to use with SSL. Only needed if \fB\,--cert\/\fR is given and the
|
||||
certificate file does not contain the private key.
|
||||
|
||||
|
||||
|
||||
.IP "\fB\,--cert-key-pass\/\fR"
|
||||
|
||||
|
||||
The passphrase to be used to with the given private key. Only needed if \fB\,--cert-key\/\fR
|
||||
is given and the key file requires a passphrase.
|
||||
If not provided, you\(gall be prompted interactively.
|
||||
|
||||
|
||||
.PP
|
||||
.SH Troubleshooting
|
||||
.IP "\fB\,--ignore-stdin\/\fR, \fB\,-I\/\fR"
|
||||
|
||||
|
||||
Do not attempt to read stdin
|
||||
|
||||
|
||||
.IP "\fB\,--help\/\fR"
|
||||
|
||||
|
||||
Show this help message and exit.
|
||||
|
||||
|
||||
.IP "\fB\,--manual\/\fR"
|
||||
|
||||
|
||||
Show the full manual.
|
||||
|
||||
|
||||
.IP "\fB\,--version\/\fR"
|
||||
|
||||
|
||||
Show version and exit.
|
||||
|
||||
|
||||
.IP "\fB\,--traceback\/\fR"
|
||||
|
||||
|
||||
Prints the exception traceback should one occur.
|
||||
|
||||
|
||||
.IP "\fB\,--default-scheme\/\fR"
|
||||
|
||||
|
||||
The default scheme to use if not specified in the URL.
|
||||
|
||||
|
||||
.IP "\fB\,--debug\/\fR"
|
||||
|
||||
|
||||
Prints the exception traceback should one occur, as well as other
|
||||
information useful for debugging HTTPie itself and for reporting bugs.
|
||||
|
||||
|
||||
|
||||
.PP
|
||||
.SH SEE ALSO
|
||||
|
||||
For every \fB\,--OPTION\/\fR there is also a \fB\,--no-OPTION\/\fR that reverts OPTION
|
||||
to its default value.
|
||||
|
||||
.SH REPORTING BUGS
|
||||
Suggestions and bug reports are greatly appreciated: <https://github.com/jakubroztocil/httpie/issues>
|
||||
|
||||
.SH AUTHOR
|
||||
httpie was written by Jakub Roztocil <jakub@roztocil.name>.
|
||||
.PP
|
||||
This manual page was written for the Debian project (and may be used by others).
|
||||
|
||||
Suggestions and bug reports are greatly appreciated:
|
||||
https://github.com/httpie/cli/issues
|
@ -1,3 +0,0 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:797fe33afe3bf0a4364a869a7d73f5c728f67d4ac47039be41e08bd564f86bb0
|
||||
size 1279185
|
@ -1,3 +1,14 @@
|
||||
-------------------------------------------------------------------
|
||||
Wed Jul 10 15:52:33 UTC 2024 - Simon Vogl <simon.vogl@gmx.net>
|
||||
|
||||
- Update to version 3.2.3
|
||||
* Fix SSL connections by pinning the requests version to 2.31.0.
|
||||
* Make it possible to unset the User-Agent and Accept-Encoding
|
||||
request headers.
|
||||
- Update manpage to version 3.2.3
|
||||
- Switch to generating tarball directly from git to harden package
|
||||
against supply chain attacks
|
||||
|
||||
-------------------------------------------------------------------
|
||||
Fri Jun 23 20:18:48 UTC 2023 - Simon Vogl <simon.vogl@gmx.net>
|
||||
|
||||
|
13
httpie.spec
13
httpie.spec
@ -1,7 +1,7 @@
|
||||
#
|
||||
# spec file for package httpie
|
||||
#
|
||||
# Copyright (c) 2023 SUSE LLC
|
||||
# Copyright (c) 2024 SUSE LLC
|
||||
#
|
||||
# All modifications and additions to the file contributed by third parties
|
||||
# remain the property of their copyright owners, unless otherwise agreed
|
||||
@ -16,14 +16,17 @@
|
||||
#
|
||||
|
||||
|
||||
%define _mtime 1720621443
|
||||
%define _commit f4cf43e
|
||||
|
||||
Name: httpie
|
||||
Version: 3.2.2
|
||||
Version: 3.2.3
|
||||
Release: 0
|
||||
Summary: CLI, cURL-like tool for humans
|
||||
License: BSD-3-Clause
|
||||
Group: Productivity/Networking/Web/Utilities
|
||||
URL: https://httpie.org/
|
||||
Source: https://github.com/jakubroztocil/httpie/archive/%{version}.tar.gz#/%{name}-%{version}.tar.gz
|
||||
Source: cli-%{version}.%{_mtime}.%{_commit}.tar.gz
|
||||
Source1: http.1
|
||||
BuildRequires: %{primary_python}
|
||||
BuildRequires: %{primary_python}-Jinja2
|
||||
@ -70,7 +73,7 @@ Obsoletes: %{primary_python}-httpie < 2.3.0
|
||||
Obsoletes: python3-httpie < 2.3.0
|
||||
BuildArch: noarch
|
||||
Requires(post): update-alternatives
|
||||
Requires(postun):update-alternatives
|
||||
Requires(postun): update-alternatives
|
||||
|
||||
%description
|
||||
HTTPie consists of a single "http" command designed for debugging and
|
||||
@ -80,7 +83,7 @@ It allows for issuing arbitrary HTTP requests and displays colorized
|
||||
responses.
|
||||
|
||||
%prep
|
||||
%setup -q
|
||||
%setup -q -n cli-%{version}.%{_mtime}.%{_commit}
|
||||
#drop shebang
|
||||
sed -i -e '/^#!\//, 1d' httpie/__main__.py
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user