[3.13] GH-54732: Tweak wording around empty lines in argument files (GH-150980) (#151167)

GH-54732: Tweak wording around empty lines in argument files (GH-150980)
(cherry picked from commit 528550e0e7)

Co-authored-by: Savannah Ostrowski <savannah@python.org>
This commit is contained in:
Miss Islington (bot)
2026-06-09 17:44:18 +02:00
committed by GitHub
parent 558764600f
commit b032f3fa17
+5 -3
View File
@@ -423,9 +423,8 @@ is considered equivalent to the expression ``['-f', 'foo', '-f', 'bar']``.
.. note::
Empty lines are treated as empty strings (``''``), which are allowed as values but
not as arguments. Empty lines that are read as arguments will result in an
"unrecognized arguments" error.
Each line is treated as a single argument, so an empty line is read as an
empty string (``''``).
:class:`ArgumentParser` uses :term:`filesystem encoding and error handler`
to read the file containing arguments.
@@ -2092,6 +2091,9 @@ Customizing file parsing
def convert_arg_line_to_args(self, arg_line):
return arg_line.split()
Note that with this override an argument can no longer contain spaces, since
each space-separated word becomes a separate argument.
Exiting methods
^^^^^^^^^^^^^^^