# SOME DESCRIPTIVE TITLE. # Copyright (C) 2001-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 3.6\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2017-04-02 22:11+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "Language: fr\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #: ../Doc/library/tokenize.rst:2 msgid ":mod:`tokenize` --- Tokenizer for Python source" msgstr "" #: ../Doc/library/tokenize.rst:10 msgid "**Source code:** :source:`Lib/tokenize.py`" msgstr "**Code source :** :source:`Lib/tokenize.py`" #: ../Doc/library/tokenize.rst:14 msgid "" "The :mod:`tokenize` module provides a lexical scanner for Python source " "code, implemented in Python. The scanner in this module returns comments as " "tokens as well, making it useful for implementing \"pretty-printers,\" " "including colorizers for on-screen displays." msgstr "" #: ../Doc/library/tokenize.rst:19 msgid "" "To simplify token stream handling, all :ref:`operators` and :ref:" "`delimiters` tokens are returned using the generic :data:`token.OP` token " "type. The exact type can be determined by checking the ``exact_type`` " "property on the :term:`named tuple` returned from :func:`tokenize.tokenize`." msgstr "" #: ../Doc/library/tokenize.rst:25 msgid "Tokenizing Input" msgstr "" #: ../Doc/library/tokenize.rst:27 msgid "The primary entry point is a :term:`generator`:" msgstr "" #: ../Doc/library/tokenize.rst:31 msgid "" "The :func:`.tokenize` generator requires one argument, *readline*, which " "must be a callable object which provides the same interface as the :meth:`io." "IOBase.readline` method of file objects. Each call to the function should " "return one line of input as bytes." msgstr "" #: ../Doc/library/tokenize.rst:36 msgid "" "The generator produces 5-tuples with these members: the token type; the " "token string; a 2-tuple ``(srow, scol)`` of ints specifying the row and " "column where the token begins in the source; a 2-tuple ``(erow, ecol)`` of " "ints specifying the row and column where the token ends in the source; and " "the line on which the token was found. The line passed (the last tuple item) " "is the *logical* line; continuation lines are included. The 5 tuple is " "returned as a :term:`named tuple` with the field names: ``type string start " "end line``." msgstr "" #: ../Doc/library/tokenize.rst:45 msgid "" "The returned :term:`named tuple` has an additional property named " "``exact_type`` that contains the exact operator type for :data:`token.OP` " "tokens. For all other token types ``exact_type`` equals the named tuple " "``type`` field." msgstr "" #: ../Doc/library/tokenize.rst:50 msgid "Added support for named tuples." msgstr "" #: ../Doc/library/tokenize.rst:53 msgid "Added support for ``exact_type``." msgstr "" #: ../Doc/library/tokenize.rst:56 msgid "" ":func:`.tokenize` determines the source encoding of the file by looking for " "a UTF-8 BOM or encoding cookie, according to :pep:`263`." msgstr "" #: ../Doc/library/tokenize.rst:60 msgid "" "All constants from the :mod:`token` module are also exported from :mod:" "`tokenize`, as are three additional token type values:" msgstr "" #: ../Doc/library/tokenize.rst:65 msgid "Token value used to indicate a comment." msgstr "" #: ../Doc/library/tokenize.rst:70 msgid "" "Token value used to indicate a non-terminating newline. The NEWLINE token " "indicates the end of a logical line of Python code; NL tokens are generated " "when a logical line of code is continued over multiple physical lines." msgstr "" #: ../Doc/library/tokenize.rst:77 msgid "" "Token value that indicates the encoding used to decode the source bytes into " "text. The first token returned by :func:`.tokenize` will always be an " "ENCODING token." msgstr "" #: ../Doc/library/tokenize.rst:82 msgid "" "Another function is provided to reverse the tokenization process. This is " "useful for creating tools that tokenize a script, modify the token stream, " "and write back the modified script." msgstr "" #: ../Doc/library/tokenize.rst:89 msgid "" "Converts tokens back into Python source code. The *iterable* must return " "sequences with at least two elements, the token type and the token string. " "Any additional sequence elements are ignored." msgstr "" #: ../Doc/library/tokenize.rst:93 msgid "" "The reconstructed script is returned as a single string. The result is " "guaranteed to tokenize back to match the input so that the conversion is " "lossless and round-trips are assured. The guarantee applies only to the " "token type and token string as the spacing between tokens (column positions) " "may change." msgstr "" #: ../Doc/library/tokenize.rst:99 msgid "" "It returns bytes, encoded using the ENCODING token, which is the first token " "sequence output by :func:`.tokenize`." msgstr "" #: ../Doc/library/tokenize.rst:103 msgid "" ":func:`.tokenize` needs to detect the encoding of source files it tokenizes. " "The function it uses to do this is available:" msgstr "" #: ../Doc/library/tokenize.rst:108 msgid "" "The :func:`detect_encoding` function is used to detect the encoding that " "should be used to decode a Python source file. It requires one argument, " "readline, in the same way as the :func:`.tokenize` generator." msgstr "" #: ../Doc/library/tokenize.rst:112 msgid "" "It will call readline a maximum of twice, and return the encoding used (as a " "string) and a list of any lines (not decoded from bytes) it has read in." msgstr "" #: ../Doc/library/tokenize.rst:116 msgid "" "It detects the encoding from the presence of a UTF-8 BOM or an encoding " "cookie as specified in :pep:`263`. If both a BOM and a cookie are present, " "but disagree, a SyntaxError will be raised. Note that if the BOM is found, " "``'utf-8-sig'`` will be returned as an encoding." msgstr "" #: ../Doc/library/tokenize.rst:121 msgid "" "If no encoding is specified, then the default of ``'utf-8'`` will be " "returned." msgstr "" #: ../Doc/library/tokenize.rst:124 msgid "" "Use :func:`.open` to open Python source files: it uses :func:" "`detect_encoding` to detect the file encoding." msgstr "" #: ../Doc/library/tokenize.rst:130 msgid "" "Open a file in read only mode using the encoding detected by :func:" "`detect_encoding`." msgstr "" #: ../Doc/library/tokenize.rst:137 msgid "" "Raised when either a docstring or expression that may be split over several " "lines is not completed anywhere in the file, for example::" msgstr "" #: ../Doc/library/tokenize.rst:143 msgid "or::" msgstr "ou : ::" #: ../Doc/library/tokenize.rst:149 msgid "" "Note that unclosed single-quoted strings do not cause an error to be raised. " "They are tokenized as ``ERRORTOKEN``, followed by the tokenization of their " "contents." msgstr "" #: ../Doc/library/tokenize.rst:157 msgid "Command-Line Usage" msgstr "" #: ../Doc/library/tokenize.rst:161 msgid "" "The :mod:`tokenize` module can be executed as a script from the command " "line. It is as simple as:" msgstr "" #: ../Doc/library/tokenize.rst:168 msgid "The following options are accepted:" msgstr "" #: ../Doc/library/tokenize.rst:174 msgid "show this help message and exit" msgstr "" #: ../Doc/library/tokenize.rst:178 msgid "display token names using the exact type" msgstr "" #: ../Doc/library/tokenize.rst:180 msgid "" "If :file:`filename.py` is specified its contents are tokenized to stdout. " "Otherwise, tokenization is performed on stdin." msgstr "" #: ../Doc/library/tokenize.rst:184 msgid "Examples" msgstr "Exemples" #: ../Doc/library/tokenize.rst:186 msgid "" "Example of a script rewriter that transforms float literals into Decimal " "objects::" msgstr "" #: ../Doc/library/tokenize.rst:228 msgid "Example of tokenizing from the command line. The script::" msgstr "" #: ../Doc/library/tokenize.rst:235 msgid "" "will be tokenized to the following output where the first column is the " "range of the line/column coordinates where the token is found, the second " "column is the name of the token, and the final column is the value of the " "token (if any)" msgstr "" #: ../Doc/library/tokenize.rst:263 msgid "The exact token type names can be displayed using the ``-e`` option:" msgstr ""