2018-07-04 09:06:45 +00:00
|
|
|
# Copyright (C) 2001-2018, Python Software Foundation
|
2018-07-04 09:08:42 +00:00
|
|
|
# For licence information, see README file.
|
2016-10-30 09:46:26 +00:00
|
|
|
#
|
|
|
|
msgid ""
|
|
|
|
msgstr ""
|
|
|
|
"Project-Id-Version: Python 3.6\n"
|
|
|
|
"Report-Msgid-Bugs-To: \n"
|
2019-10-09 16:10:12 +00:00
|
|
|
"POT-Creation-Date: 2019-10-09 17:54+0200\n"
|
2016-10-30 09:46:26 +00:00
|
|
|
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
|
|
|
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
2018-07-04 09:14:25 +00:00
|
|
|
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
|
2017-05-23 22:40:56 +00:00
|
|
|
"Language: fr\n"
|
2016-10-30 09:46:26 +00:00
|
|
|
"MIME-Version: 1.0\n"
|
|
|
|
"Content-Type: text/plain; charset=UTF-8\n"
|
|
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
|
|
|
|
|
|
#: ../Doc/library/shlex.rst:2
|
|
|
|
msgid ":mod:`shlex` --- Simple lexical analysis"
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../Doc/library/shlex.rst:12
|
|
|
|
msgid "**Source code:** :source:`Lib/shlex.py`"
|
|
|
|
msgstr "**Code source :** :source:`Lib/shlex.py`"
|
|
|
|
|
|
|
|
#: ../Doc/library/shlex.rst:16
|
|
|
|
msgid ""
|
|
|
|
"The :class:`~shlex.shlex` class makes it easy to write lexical analyzers for "
|
|
|
|
"simple syntaxes resembling that of the Unix shell. This will often be "
|
|
|
|
"useful for writing minilanguages, (for example, in run control files for "
|
|
|
|
"Python applications) or for parsing quoted strings."
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../Doc/library/shlex.rst:21
|
|
|
|
msgid "The :mod:`shlex` module defines the following functions:"
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../Doc/library/shlex.rst:26
|
|
|
|
msgid ""
|
|
|
|
"Split the string *s* using shell-like syntax. If *comments* is :const:"
|
|
|
|
"`False` (the default), the parsing of comments in the given string will be "
|
|
|
|
"disabled (setting the :attr:`~shlex.commenters` attribute of the :class:"
|
|
|
|
"`~shlex.shlex` instance to the empty string). This function operates in "
|
|
|
|
"POSIX mode by default, but uses non-POSIX mode if the *posix* argument is "
|
|
|
|
"false."
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../Doc/library/shlex.rst:35
|
|
|
|
msgid ""
|
|
|
|
"Since the :func:`split` function instantiates a :class:`~shlex.shlex` "
|
|
|
|
"instance, passing ``None`` for *s* will read the string to split from "
|
|
|
|
"standard input."
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../Doc/library/shlex.rst:42
|
|
|
|
msgid ""
|
2019-09-04 09:35:23 +00:00
|
|
|
"Concatenate the tokens of the list *split_command* and return a string. This "
|
|
|
|
"function is the inverse of :func:`split`."
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../Doc/library/shlex.rst:49
|
|
|
|
msgid ""
|
|
|
|
"The returned value is shell-escaped to protect against injection "
|
|
|
|
"vulnerabilities (see :func:`quote`)."
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../Doc/library/shlex.rst:57
|
|
|
|
msgid ""
|
2016-10-30 09:46:26 +00:00
|
|
|
"Return a shell-escaped version of the string *s*. The returned value is a "
|
|
|
|
"string that can safely be used as one token in a shell command line, for "
|
|
|
|
"cases where you cannot use a list."
|
|
|
|
msgstr ""
|
|
|
|
|
2019-09-04 09:35:23 +00:00
|
|
|
#: ../Doc/library/shlex.rst:61
|
2018-06-28 13:32:56 +00:00
|
|
|
msgid "This idiom would be unsafe:"
|
2016-10-30 09:46:26 +00:00
|
|
|
msgstr ""
|
|
|
|
|
2019-09-04 09:35:23 +00:00
|
|
|
#: ../Doc/library/shlex.rst:68
|
2018-06-28 13:32:56 +00:00
|
|
|
msgid ":func:`quote` lets you plug the security hole:"
|
2016-10-30 09:46:26 +00:00
|
|
|
msgstr ""
|
|
|
|
|
2019-09-04 09:35:23 +00:00
|
|
|
#: ../Doc/library/shlex.rst:78
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "The quoting is compatible with UNIX shells and with :func:`split`:"
|
|
|
|
msgstr ""
|
|
|
|
|
2019-09-04 09:35:23 +00:00
|
|
|
#: ../Doc/library/shlex.rst:90
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "The :mod:`shlex` module defines the following class:"
|
|
|
|
msgstr ""
|
|
|
|
|
2019-09-04 09:35:23 +00:00
|
|
|
#: ../Doc/library/shlex.rst:95
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"A :class:`~shlex.shlex` instance or subclass instance is a lexical analyzer "
|
|
|
|
"object. The initialization argument, if present, specifies where to read "
|
|
|
|
"characters from. It must be a file-/stream-like object with :meth:`~io."
|
|
|
|
"TextIOBase.read` and :meth:`~io.TextIOBase.readline` methods, or a string. "
|
|
|
|
"If no argument is given, input will be taken from ``sys.stdin``. The second "
|
|
|
|
"optional argument is a filename string, which sets the initial value of the :"
|
|
|
|
"attr:`~shlex.infile` attribute. If the *instream* argument is omitted or "
|
|
|
|
"equal to ``sys.stdin``, this second argument defaults to \"stdin\". The "
|
|
|
|
"*posix* argument defines the operational mode: when *posix* is not true "
|
|
|
|
"(default), the :class:`~shlex.shlex` instance will operate in compatibility "
|
|
|
|
"mode. When operating in POSIX mode, :class:`~shlex.shlex` will try to be as "
|
|
|
|
"close as possible to the POSIX shell parsing rules. The *punctuation_chars* "
|
|
|
|
"argument provides a way to make the behaviour even closer to how real shells "
|
|
|
|
"parse. This can take a number of values: the default value, ``False``, "
|
|
|
|
"preserves the behaviour seen under Python 3.5 and earlier. If set to "
|
|
|
|
"``True``, then parsing of the characters ``();<>|&`` is changed: any run of "
|
|
|
|
"these characters (considered punctuation characters) is returned as a single "
|
|
|
|
"token. If set to a non-empty string of characters, those characters will be "
|
|
|
|
"used as the punctuation characters. Any characters in the :attr:`wordchars` "
|
|
|
|
"attribute that appear in *punctuation_chars* will be removed from :attr:"
|
2019-10-09 16:10:12 +00:00
|
|
|
"`wordchars`. See :ref:`improved-shell-compatibility` for more information. "
|
|
|
|
"*punctuation_chars* can be set only upon :class:`~shlex.shlex` instance "
|
|
|
|
"creation and can't be modified later."
|
2016-10-30 09:46:26 +00:00
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:120
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "The *punctuation_chars* parameter was added."
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:125
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "Module :mod:`configparser`"
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:126
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Parser for configuration files similar to the Windows :file:`.ini` files."
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:132
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "shlex Objects"
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:134
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "A :class:`~shlex.shlex` instance has the following methods:"
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:139
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Return a token. If tokens have been stacked using :meth:`push_token`, pop a "
|
|
|
|
"token off the stack. Otherwise, read one from the input stream. If reading "
|
|
|
|
"encounters an immediate end-of-file, :attr:`eof` is returned (the empty "
|
|
|
|
"string (``''``) in non-POSIX mode, and ``None`` in POSIX mode)."
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:147
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "Push the argument onto the token stack."
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:152
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Read a raw token. Ignore the pushback stack, and do not interpret source "
|
|
|
|
"requests. (This is not ordinarily a useful entry point, and is documented "
|
|
|
|
"here only for the sake of completeness.)"
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:159
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"When :class:`~shlex.shlex` detects a source request (see :attr:`source` "
|
|
|
|
"below) this method is given the following token as argument, and expected to "
|
|
|
|
"return a tuple consisting of a filename and an open file-like object."
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:163
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Normally, this method first strips any quotes off the argument. If the "
|
|
|
|
"result is an absolute pathname, or there was no previous source request in "
|
|
|
|
"effect, or the previous source was a stream (such as ``sys.stdin``), the "
|
|
|
|
"result is left alone. Otherwise, if the result is a relative pathname, the "
|
|
|
|
"directory part of the name of the file immediately before it on the source "
|
|
|
|
"inclusion stack is prepended (this behavior is like the way the C "
|
|
|
|
"preprocessor handles ``#include \"file.h\"``)."
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:171
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"The result of the manipulations is treated as a filename, and returned as "
|
|
|
|
"the first component of the tuple, with :func:`open` called on it to yield "
|
|
|
|
"the second component. (Note: this is the reverse of the order of arguments "
|
|
|
|
"in instance initialization!)"
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:176
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"This hook is exposed so that you can use it to implement directory search "
|
|
|
|
"paths, addition of file extensions, and other namespace hacks. There is no "
|
|
|
|
"corresponding 'close' hook, but a shlex instance will call the :meth:`~io."
|
|
|
|
"IOBase.close` method of the sourced input stream when it returns EOF."
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:182
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"For more explicit control of source stacking, use the :meth:`push_source` "
|
|
|
|
"and :meth:`pop_source` methods."
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:188
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Push an input source stream onto the input stack. If the filename argument "
|
|
|
|
"is specified it will later be available for use in error messages. This is "
|
|
|
|
"the same method used internally by the :meth:`sourcehook` method."
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:195
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Pop the last-pushed input source from the input stack. This is the same "
|
|
|
|
"method used internally when the lexer reaches EOF on a stacked input stream."
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:201
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"This method generates an error message leader in the format of a Unix C "
|
|
|
|
"compiler error label; the format is ``'\"%s\", line %d: '``, where the ``"
|
|
|
|
"%s`` is replaced with the name of the current source file and the ``%d`` "
|
|
|
|
"with the current input line number (the optional arguments can be used to "
|
|
|
|
"override these)."
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:206
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"This convenience is provided to encourage :mod:`shlex` users to generate "
|
|
|
|
"error messages in the standard, parseable format understood by Emacs and "
|
|
|
|
"other Unix tools."
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:210
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Instances of :class:`~shlex.shlex` subclasses have some public instance "
|
|
|
|
"variables which either control lexical analysis or can be used for debugging:"
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:216
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"The string of characters that are recognized as comment beginners. All "
|
|
|
|
"characters from the comment beginner to end of line are ignored. Includes "
|
|
|
|
"just ``'#'`` by default."
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:223
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"The string of characters that will accumulate into multi-character tokens. "
|
|
|
|
"By default, includes all ASCII alphanumerics and underscore. In POSIX mode, "
|
|
|
|
"the accented characters in the Latin-1 set are also included. If :attr:"
|
|
|
|
"`punctuation_chars` is not empty, the characters ``~-./*?=``, which can "
|
|
|
|
"appear in filename specifications and command line parameters, will also be "
|
|
|
|
"included in this attribute, and any characters which appear in "
|
|
|
|
"``punctuation_chars`` will be removed from ``wordchars`` if they are present "
|
2019-09-04 09:35:23 +00:00
|
|
|
"there. If :attr:`whitespace_split` is set to ``True``, this will have no "
|
|
|
|
"effect."
|
2016-10-30 09:46:26 +00:00
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:236
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Characters that will be considered whitespace and skipped. Whitespace "
|
|
|
|
"bounds tokens. By default, includes space, tab, linefeed and carriage-"
|
|
|
|
"return."
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:242
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Characters that will be considered as escape. This will be only used in "
|
|
|
|
"POSIX mode, and includes just ``'\\'`` by default."
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:248
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Characters that will be considered string quotes. The token accumulates "
|
|
|
|
"until the same quote is encountered again (thus, different quote types "
|
|
|
|
"protect each other as in the shell.) By default, includes ASCII single and "
|
|
|
|
"double quotes."
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:255
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Characters in :attr:`quotes` that will interpret escape characters defined "
|
|
|
|
"in :attr:`escape`. This is only used in POSIX mode, and includes just "
|
|
|
|
"``'\"'`` by default."
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:262
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"If ``True``, tokens will only be split in whitespaces. This is useful, for "
|
|
|
|
"example, for parsing command lines with :class:`~shlex.shlex`, getting "
|
2019-09-04 09:35:23 +00:00
|
|
|
"tokens in a similar way to shell arguments. When used in combination with :"
|
|
|
|
"attr:`punctuation_chars`, tokens will be split on whitespace in addition to "
|
|
|
|
"those characters."
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:268
|
2019-09-04 09:35:23 +00:00
|
|
|
msgid ""
|
|
|
|
"The :attr:`punctuation_chars` attribute was made compatible with the :attr:"
|
|
|
|
"`whitespace_split` attribute."
|
2016-10-30 09:46:26 +00:00
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:275
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"The name of the current input file, as initially set at class instantiation "
|
|
|
|
"time or stacked by later source requests. It may be useful to examine this "
|
|
|
|
"when constructing error messages."
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:282
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"The input stream from which this :class:`~shlex.shlex` instance is reading "
|
|
|
|
"characters."
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:288
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"This attribute is ``None`` by default. If you assign a string to it, that "
|
|
|
|
"string will be recognized as a lexical-level inclusion request similar to "
|
|
|
|
"the ``source`` keyword in various shells. That is, the immediately "
|
|
|
|
"following token will be opened as a filename and input will be taken from "
|
|
|
|
"that stream until EOF, at which point the :meth:`~io.IOBase.close` method of "
|
|
|
|
"that stream will be called and the input source will again become the "
|
|
|
|
"original input stream. Source requests may be stacked any number of levels "
|
|
|
|
"deep."
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:299
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"If this attribute is numeric and ``1`` or more, a :class:`~shlex.shlex` "
|
|
|
|
"instance will print verbose progress output on its behavior. If you need to "
|
|
|
|
"use this, you can read the module source code to learn the details."
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:306
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "Source line number (count of newlines seen so far plus one)."
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:311
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"The token buffer. It may be useful to examine this when catching exceptions."
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:316
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Token used to determine end of file. This will be set to the empty string "
|
|
|
|
"(``''``), in non-POSIX mode, and to ``None`` in POSIX mode."
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:322
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
2019-10-09 16:10:12 +00:00
|
|
|
"A read-only property. Characters that will be considered punctuation. Runs "
|
|
|
|
"of punctuation characters will be returned as a single token. However, note "
|
|
|
|
"that no semantic validity checking will be performed: for example, '>>>' "
|
|
|
|
"could be returned as a token, even though it may not be recognised as such "
|
|
|
|
"by shells."
|
2016-10-30 09:46:26 +00:00
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:333
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "Parsing Rules"
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:335
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"When operating in non-POSIX mode, :class:`~shlex.shlex` will try to obey to "
|
|
|
|
"the following rules."
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:338
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Quote characters are not recognized within words (``Do\"Not\"Separate`` is "
|
|
|
|
"parsed as the single word ``Do\"Not\"Separate``);"
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:341
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "Escape characters are not recognized;"
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:343
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Enclosing characters in quotes preserve the literal value of all characters "
|
|
|
|
"within the quotes;"
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:346
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Closing quotes separate words (``\"Do\"Separate`` is parsed as ``\"Do\"`` "
|
|
|
|
"and ``Separate``);"
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:349
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"If :attr:`~shlex.whitespace_split` is ``False``, any character not declared "
|
|
|
|
"to be a word character, whitespace, or a quote will be returned as a single-"
|
|
|
|
"character token. If it is ``True``, :class:`~shlex.shlex` will only split "
|
|
|
|
"words in whitespaces;"
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:354
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "EOF is signaled with an empty string (``''``);"
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:356
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "It's not possible to parse empty strings, even if quoted."
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:358
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"When operating in POSIX mode, :class:`~shlex.shlex` will try to obey to the "
|
|
|
|
"following parsing rules."
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:361
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Quotes are stripped out, and do not separate words (``\"Do\"Not\"Separate"
|
|
|
|
"\"`` is parsed as the single word ``DoNotSeparate``);"
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:364
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Non-quoted escape characters (e.g. ``'\\'``) preserve the literal value of "
|
|
|
|
"the next character that follows;"
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:367
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Enclosing characters in quotes which are not part of :attr:`~shlex."
|
|
|
|
"escapedquotes` (e.g. ``\"'\"``) preserve the literal value of all characters "
|
|
|
|
"within the quotes;"
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:371
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Enclosing characters in quotes which are part of :attr:`~shlex."
|
|
|
|
"escapedquotes` (e.g. ``'\"'``) preserves the literal value of all characters "
|
|
|
|
"within the quotes, with the exception of the characters mentioned in :attr:"
|
|
|
|
"`~shlex.escape`. The escape characters retain its special meaning only when "
|
|
|
|
"followed by the quote in use, or the escape character itself. Otherwise the "
|
|
|
|
"escape character will be considered a normal character."
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:379
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "EOF is signaled with a :const:`None` value;"
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:381
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "Quoted empty strings (``''``) are allowed."
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:386
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "Improved Compatibility with Shells"
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:390
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"The :class:`shlex` class provides compatibility with the parsing performed "
|
|
|
|
"by common Unix shells like ``bash``, ``dash``, and ``sh``. To take "
|
|
|
|
"advantage of this compatibility, specify the ``punctuation_chars`` argument "
|
|
|
|
"in the constructor. This defaults to ``False``, which preserves pre-3.6 "
|
|
|
|
"behaviour. However, if it is set to ``True``, then parsing of the characters "
|
|
|
|
"``();<>|&`` is changed: any run of these characters is returned as a single "
|
|
|
|
"token. While this is short of a full parser for shells (which would be out "
|
|
|
|
"of scope for the standard library, given the multiplicity of shells out "
|
|
|
|
"there), it does allow you to perform processing of command lines more easily "
|
|
|
|
"than you could otherwise. To illustrate, you can see the difference in the "
|
2017-04-02 20:14:06 +00:00
|
|
|
"following snippet:"
|
2016-10-30 09:46:26 +00:00
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:416
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"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."
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:419
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"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::"
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:428
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"When ``punctuation_chars`` is specified, the :attr:`~shlex.wordchars` "
|
|
|
|
"attribute is augmented with the characters ``~-./*?=``. That is because "
|
|
|
|
"these characters can appear in file names (including wildcards) and command-"
|
|
|
|
"line arguments (e.g. ``--color=auto``). Hence::"
|
|
|
|
msgstr ""
|
2017-04-02 20:14:06 +00:00
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:439
|
2019-09-04 09:35:23 +00:00
|
|
|
msgid ""
|
|
|
|
"However, to match the shell as closely as possible, it is recommended to "
|
|
|
|
"always use ``posix`` and :attr:`~shlex.whitespace_split` when using :attr:"
|
|
|
|
"`~shlex.punctuation_chars`, which will negate :attr:`~shlex.wordchars` "
|
|
|
|
"entirely."
|
|
|
|
msgstr ""
|
|
|
|
|
2019-10-09 16:10:12 +00:00
|
|
|
#: ../Doc/library/shlex.rst:444
|
2017-04-02 20:14:06 +00:00
|
|
|
msgid ""
|
|
|
|
"For best effect, ``punctuation_chars`` should be set in conjunction with "
|
|
|
|
"``posix=True``. (Note that ``posix=False`` is the default for :class:`~shlex."
|
|
|
|
"shlex`.)"
|
|
|
|
msgstr ""
|