# SOME DESCRIPTIVE TITLE. # Copyright (C) 1990-2016, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 2.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2016-10-30 10:44+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "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:14 msgid "**Source code:** :source:`Lib/shlex.py`" msgstr "**Code source :** :source:`Lib/shlex.py`" #: ../Doc/library/shlex.rst:19 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:24 msgid "Prior to Python 2.7.3, this module did not support Unicode input." msgstr "" #: ../Doc/library/shlex.rst:26 msgid "The :mod:`shlex` module defines the following functions:" msgstr "" #: ../Doc/library/shlex.rst:31 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:40 msgid "Added the *posix* parameter." msgstr "" #: ../Doc/library/shlex.rst:45 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:49 msgid "The :mod:`shlex` module defines the following class:" msgstr "" #: ../Doc/library/shlex.rst:54 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 " "(strings are accepted since Python 2.3). 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 was " "introduced in Python 2.3, and 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." msgstr "" #: ../Doc/library/shlex.rst:71 msgid "Module :mod:`ConfigParser`" msgstr "" #: ../Doc/library/shlex.rst:72 msgid "" "Parser for configuration files similar to the Windows :file:`.ini` files." msgstr "" #: ../Doc/library/shlex.rst:78 msgid "shlex Objects" msgstr "" #: ../Doc/library/shlex.rst:80 msgid "A :class:`~shlex.shlex` instance has the following methods:" msgstr "" #: ../Doc/library/shlex.rst:85 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 "" #: ../Doc/library/shlex.rst:93 msgid "Push the argument onto the token stack." msgstr "" #: ../Doc/library/shlex.rst:98 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 "" #: ../Doc/library/shlex.rst:105 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 "" #: ../Doc/library/shlex.rst:109 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 "" #: ../Doc/library/shlex.rst:117 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 "" #: ../Doc/library/shlex.rst:122 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 "" #: ../Doc/library/shlex.rst:128 msgid "" "For more explicit control of source stacking, use the :meth:`push_source` " "and :meth:`pop_source` methods." msgstr "" #: ../Doc/library/shlex.rst:134 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 "" #: ../Doc/library/shlex.rst:143 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 "" #: ../Doc/library/shlex.rst:151 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 "" #: ../Doc/library/shlex.rst:156 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 "" #: ../Doc/library/shlex.rst:160 msgid "" "Instances of :class:`~shlex.shlex` subclasses have some public instance " "variables which either control lexical analysis or can be used for debugging:" msgstr "" #: ../Doc/library/shlex.rst:166 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 "" #: ../Doc/library/shlex.rst:173 msgid "" "The string of characters that will accumulate into multi-character tokens. " "By default, includes all ASCII alphanumerics and underscore." msgstr "" #: ../Doc/library/shlex.rst:179 msgid "" "Characters that will be considered whitespace and skipped. Whitespace " "bounds tokens. By default, includes space, tab, linefeed and carriage-" "return." msgstr "" #: ../Doc/library/shlex.rst:185 msgid "" "Characters that will be considered as escape. This will be only used in " "POSIX mode, and includes just ``'\\'`` by default." msgstr "" #: ../Doc/library/shlex.rst:193 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 "" #: ../Doc/library/shlex.rst:200 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 "" #: ../Doc/library/shlex.rst:209 msgid "" "If ``True``, tokens will only be split in whitespaces. This is useful, for " "example, for parsing command lines with :class:`~shlex.shlex`, getting " "tokens in a similar way to shell arguments." msgstr "" #: ../Doc/library/shlex.rst:218 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 "" #: ../Doc/library/shlex.rst:225 msgid "" "The input stream from which this :class:`~shlex.shlex` instance is reading " "characters." msgstr "" #: ../Doc/library/shlex.rst:231 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 "" #: ../Doc/library/shlex.rst:243 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 "" #: ../Doc/library/shlex.rst:250 msgid "Source line number (count of newlines seen so far plus one)." msgstr "" #: ../Doc/library/shlex.rst:255 msgid "" "The token buffer. It may be useful to examine this when catching exceptions." msgstr "" #: ../Doc/library/shlex.rst:260 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 "" #: ../Doc/library/shlex.rst:269 msgid "Parsing Rules" msgstr "" #: ../Doc/library/shlex.rst:271 msgid "" "When operating in non-POSIX mode, :class:`~shlex.shlex` will try to obey to " "the following rules." msgstr "" #: ../Doc/library/shlex.rst:274 msgid "" "Quote characters are not recognized within words (``Do\"Not\"Separate`` is " "parsed as the single word ``Do\"Not\"Separate``);" msgstr "" #: ../Doc/library/shlex.rst:277 msgid "Escape characters are not recognized;" msgstr "" #: ../Doc/library/shlex.rst:279 msgid "" "Enclosing characters in quotes preserve the literal value of all characters " "within the quotes;" msgstr "" #: ../Doc/library/shlex.rst:282 msgid "" "Closing quotes separate words (``\"Do\"Separate`` is parsed as ``\"Do\"`` " "and ``Separate``);" msgstr "" #: ../Doc/library/shlex.rst:285 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 "" #: ../Doc/library/shlex.rst:290 msgid "EOF is signaled with an empty string (``''``);" msgstr "" #: ../Doc/library/shlex.rst:292 msgid "It's not possible to parse empty strings, even if quoted." msgstr "" #: ../Doc/library/shlex.rst:294 msgid "" "When operating in POSIX mode, :class:`~shlex.shlex` will try to obey to the " "following parsing rules." msgstr "" #: ../Doc/library/shlex.rst:297 msgid "" "Quotes are stripped out, and do not separate words (``\"Do\"Not\"Separate" "\"`` is parsed as the single word ``DoNotSeparate``);" msgstr "" #: ../Doc/library/shlex.rst:300 msgid "" "Non-quoted escape characters (e.g. ``'\\'``) preserve the literal value of " "the next character that follows;" msgstr "" #: ../Doc/library/shlex.rst:303 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 "" #: ../Doc/library/shlex.rst:307 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 "" #: ../Doc/library/shlex.rst:315 msgid "EOF is signaled with a :const:`None` value;" msgstr "" #: ../Doc/library/shlex.rst:317 msgid "Quoted empty strings (``''``) are allowed;" msgstr ""