mirror of
https://github.com/httpie/cli.git
synced 2025-02-18 10:30:48 +01:00
README
This commit is contained in:
parent
6dee49357d
commit
fd6e87914c
14
README.rst
14
README.rst
@ -1313,16 +1313,16 @@ is being saved to a file.
|
|||||||
Done. 251.30 kB in 2.73862s (91.76 kB/s)
|
Done. 251.30 kB in 2.73862s (91.76 kB/s)
|
||||||
|
|
||||||
|
|
||||||
Downloaded file name
|
Downloaded filename
|
||||||
--------------------
|
--------------------
|
||||||
|
|
||||||
There are three mutually exclusive ways through which HTTPie determines
|
There are three mutually exclusive ways through which HTTPie determines
|
||||||
the output file name (with decreasing priority):
|
the output filename (with decreasing priority):
|
||||||
|
|
||||||
1. You can explicitly provide the exact output file name via ``--output, -o``.
|
1. You can explicitly provide it via ``--output, -o``.
|
||||||
The file gets overwritten if it already exists
|
The file gets overwritten if it already exists
|
||||||
(or appended to with ``--continue, -c``).
|
(or appended to with ``--continue, -c``).
|
||||||
2. The server may specify the file name in the optional ``Content-Disposition``
|
2. The server may specify the filename in the optional ``Content-Disposition``
|
||||||
response header. Any leading dots are stripped from a server-provided filename.
|
response header. Any leading dots are stripped from a server-provided filename.
|
||||||
3. The last resort HTTPie uses is to generate the filename from a combination
|
3. The last resort HTTPie uses is to generate the filename from a combination
|
||||||
of the request URL and the response ``Content-Type``.
|
of the request URL and the response ``Content-Type``.
|
||||||
@ -1330,8 +1330,8 @@ the output file name (with decreasing priority):
|
|||||||
the generated filename — even if there has been one or more redirects.
|
the generated filename — even if there has been one or more redirects.
|
||||||
|
|
||||||
|
|
||||||
To prevent data loss, HTTPie adds a unique numerical suffix to the
|
To prevent data loss by overwriting, HTTPie adds a unique numerical suffix to the
|
||||||
filename, unless the name has been explicitly provided via ``--output, -o``.
|
filename when necessary (unless specified with ``--output, -o``).
|
||||||
|
|
||||||
|
|
||||||
Piping while downloading
|
Piping while downloading
|
||||||
@ -1578,7 +1578,7 @@ Best practices
|
|||||||
--------------
|
--------------
|
||||||
|
|
||||||
The default behaviour of automatically reading ``stdin`` is typically not
|
The default behaviour of automatically reading ``stdin`` is typically not
|
||||||
desirable during non-interactive invocations. You most likely want to
|
desirable during non-interactive invocations. You most likely want to
|
||||||
use the ``--ignore-stdin`` option to disable it.
|
use the ``--ignore-stdin`` option to disable it.
|
||||||
|
|
||||||
It is a common gotcha that without this option HTTPie seemingly hangs.
|
It is a common gotcha that without this option HTTPie seemingly hangs.
|
||||||
|
Loading…
Reference in New Issue
Block a user