https://github.com/python/cpython/commit/dd724239dd759879b9b6981114db25256449fc42
commit: dd724239dd759879b9b6981114db25256449fc42
branch: main
author: Hugo van Kemenade <[email protected]>
committer: hugovk <[email protected]>
date: 2024-04-13T05:31:01-06:00
summary:
gh-117840: Fix indent to fix shlex syntax highlighting (#117843)
files:
M Doc/library/shlex.rst
diff --git a/Doc/library/shlex.rst b/Doc/library/shlex.rst
index f94833ad5331a9..716420f5e74ffa 100644
--- a/Doc/library/shlex.rst
+++ b/Doc/library/shlex.rst
@@ -412,17 +412,17 @@ otherwise. To illustrate, you can see the difference in
the following snippet:
.. doctest::
:options: +NORMALIZE_WHITESPACE
- >>> import shlex
- >>> text = "a && b; c && d || e; f >'abc'; (def \"ghi\")"
- >>> s = shlex.shlex(text, posix=True)
- >>> s.whitespace_split = True
- >>> list(s)
- ['a', '&&', 'b;', 'c', '&&', 'd', '||', 'e;', 'f', '>abc;', '(def', 'ghi)']
- >>> s = shlex.shlex(text, posix=True, punctuation_chars=True)
- >>> s.whitespace_split = True
- >>> list(s)
- ['a', '&&', 'b', ';', 'c', '&&', 'd', '||', 'e', ';', 'f', '>', 'abc', ';',
- '(', 'def', 'ghi', ')']
+ >>> import shlex
+ >>> text = "a && b; c && d || e; f >'abc'; (def \"ghi\")"
+ >>> s = shlex.shlex(text, posix=True)
+ >>> s.whitespace_split = True
+ >>> list(s)
+ ['a', '&&', 'b;', 'c', '&&', 'd', '||', 'e;', 'f', '>abc;', '(def', 'ghi)']
+ >>> s = shlex.shlex(text, posix=True, punctuation_chars=True)
+ >>> s.whitespace_split = True
+ >>> list(s)
+ ['a', '&&', 'b', ';', 'c', '&&', 'd', '||', 'e', ';', 'f', '>', 'abc', ';',
+ '(', 'def', 'ghi', ')']
Of course, tokens will be returned which are not valid for shells, and you'll
need to implement your own error checks on the returned tokens.
@@ -431,10 +431,10 @@ Instead of passing ``True`` as the value for the
punctuation_chars parameter,
you can pass a string with specific characters, which will be used to determine
which characters constitute punctuation. For example::
- >>> import shlex
- >>> s = shlex.shlex("a && b || c", punctuation_chars="|")
- >>> list(s)
- ['a', '&', '&', 'b', '||', 'c']
+ >>> import shlex
+ >>> s = shlex.shlex("a && b || c", punctuation_chars="|")
+ >>> list(s)
+ ['a', '&', '&', 'b', '||', 'c']
.. note:: When ``punctuation_chars`` is specified, the :attr:`~shlex.wordchars`
attribute is augmented with the characters ``~-./*?=``. That is because
these
_______________________________________________
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]
