https://github.com/python/cpython/commit/528550e0e753d64714f65a02d567bdc1d63ae3f1
commit: 528550e0e753d64714f65a02d567bdc1d63ae3f1
branch: main
author: Savannah Ostrowski <[email protected]>
committer: savannahostrowski <[email protected]>
date: 2026-06-09T15:37:15Z
summary:
GH-54732: Tweak wording around empty lines in argument files (#150980)
files:
M Doc/library/argparse.rst
diff --git a/Doc/library/argparse.rst b/Doc/library/argparse.rst
index db5fae2006678a..622f844a4a0b82 100644
--- a/Doc/library/argparse.rst
+++ b/Doc/library/argparse.rst
@@ -442,9 +442,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.
@@ -2232,6 +2231,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
^^^^^^^^^^^^^^^
_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]
