# Copyright (C) 2001-2018, Python Software Foundation # For licence information, see README file. # msgid "" msgstr "" "Project-Id-Version: Python 3\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2020-08-24 09:01+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: FRENCH \n" "Language: fr\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #: c-api/veryhigh.rst:8 msgid "The Very High Level Layer" msgstr "" #: c-api/veryhigh.rst:10 msgid "" "The functions in this chapter will let you execute Python source code given " "in a file or a buffer, but they will not let you interact in a more detailed " "way with the interpreter." msgstr "" #: c-api/veryhigh.rst:14 msgid "" "Several of these functions accept a start symbol from the grammar as a " "parameter. The available start symbols are :const:`Py_eval_input`, :const:" "`Py_file_input`, and :const:`Py_single_input`. These are described " "following the functions which accept them as parameters." msgstr "" #: c-api/veryhigh.rst:19 msgid "" "Note also that several of these functions take :c:type:`FILE*` parameters. " "One particular issue which needs to be handled carefully is that the :c:type:" "`FILE` structure for different C libraries can be different and " "incompatible. Under Windows (at least), it is possible for dynamically " "linked extensions to actually use different libraries, so care should be " "taken that :c:type:`FILE*` parameters are only passed to these functions if " "it is certain that they were created by the same library that the Python " "runtime is using." msgstr "" #: c-api/veryhigh.rst:30 msgid "" "The main program for the standard interpreter. This is made available for " "programs which embed Python. The *argc* and *argv* parameters should be " "prepared exactly as those which are passed to a C program's :c:func:`main` " "function (converted to wchar_t according to the user's locale). It is " "important to note that the argument list may be modified (but the contents " "of the strings pointed to by the argument list are not). The return value " "will be ``0`` if the interpreter exits normally (i.e., without an " "exception), ``1`` if the interpreter exits due to an exception, or ``2`` if " "the parameter list does not represent a valid Python command line." msgstr "" #: c-api/veryhigh.rst:40 msgid "" "Note that if an otherwise unhandled :exc:`SystemExit` is raised, this " "function will not return ``1``, but exit the process, as long as " "``Py_InspectFlag`` is not set." msgstr "" #: c-api/veryhigh.rst:47 msgid "Similar to :c:func:`Py_Main` but *argv* is an array of bytes strings." msgstr "" #: c-api/veryhigh.rst:54 msgid "" "This is a simplified interface to :c:func:`PyRun_AnyFileExFlags` below, " "leaving *closeit* set to ``0`` and *flags* set to ``NULL``." msgstr "" #: c-api/veryhigh.rst:60 msgid "" "This is a simplified interface to :c:func:`PyRun_AnyFileExFlags` below, " "leaving the *closeit* argument set to ``0``." msgstr "" #: c-api/veryhigh.rst:66 msgid "" "This is a simplified interface to :c:func:`PyRun_AnyFileExFlags` below, " "leaving the *flags* argument set to ``NULL``." msgstr "" #: c-api/veryhigh.rst:72 msgid "" "If *fp* refers to a file associated with an interactive device (console or " "terminal input or Unix pseudo-terminal), return the value of :c:func:" "`PyRun_InteractiveLoop`, otherwise return the result of :c:func:" "`PyRun_SimpleFile`. *filename* is decoded from the filesystem encoding (:" "func:`sys.getfilesystemencoding`). If *filename* is ``NULL``, this function " "uses ``\"???\"`` as the filename." msgstr "" #: c-api/veryhigh.rst:82 msgid "" "This is a simplified interface to :c:func:`PyRun_SimpleStringFlags` below, " "leaving the :c:type:`PyCompilerFlags`\\* argument set to ``NULL``." msgstr "" #: c-api/veryhigh.rst:88 msgid "" "Executes the Python source code from *command* in the :mod:`__main__` module " "according to the *flags* argument. If :mod:`__main__` does not already " "exist, it is created. Returns ``0`` on success or ``-1`` if an exception " "was raised. If there was an error, there is no way to get the exception " "information. For the meaning of *flags*, see below." msgstr "" #: c-api/veryhigh.rst:94 msgid "" "Note that if an otherwise unhandled :exc:`SystemExit` is raised, this " "function will not return ``-1``, but exit the process, as long as " "``Py_InspectFlag`` is not set." msgstr "" #: c-api/veryhigh.rst:101 msgid "" "This is a simplified interface to :c:func:`PyRun_SimpleFileExFlags` below, " "leaving *closeit* set to ``0`` and *flags* set to ``NULL``." msgstr "" #: c-api/veryhigh.rst:107 msgid "" "This is a simplified interface to :c:func:`PyRun_SimpleFileExFlags` below, " "leaving *flags* set to ``NULL``." msgstr "" #: c-api/veryhigh.rst:113 msgid "" "Similar to :c:func:`PyRun_SimpleStringFlags`, but the Python source code is " "read from *fp* instead of an in-memory string. *filename* should be the name " "of the file, it is decoded from the filesystem encoding (:func:`sys." "getfilesystemencoding`). If *closeit* is true, the file is closed before " "PyRun_SimpleFileExFlags returns." msgstr "" #: c-api/veryhigh.rst:120 msgid "" "On Windows, *fp* should be opened as binary mode (e.g. ``fopen(filename, \"rb" "\")``). Otherwise, Python may not handle script file with LF line ending " "correctly." msgstr "" #: c-api/veryhigh.rst:126 msgid "" "This is a simplified interface to :c:func:`PyRun_InteractiveOneFlags` below, " "leaving *flags* set to ``NULL``." msgstr "" #: c-api/veryhigh.rst:132 msgid "" "Read and execute a single statement from a file associated with an " "interactive device according to the *flags* argument. The user will be " "prompted using ``sys.ps1`` and ``sys.ps2``. *filename* is decoded from the " "filesystem encoding (:func:`sys.getfilesystemencoding`)." msgstr "" #: c-api/veryhigh.rst:137 msgid "" "Returns ``0`` when the input was executed successfully, ``-1`` if there was " "an exception, or an error code from the :file:`errcode.h` include file " "distributed as part of Python if there was a parse error. (Note that :file:" "`errcode.h` is not included by :file:`Python.h`, so must be included " "specifically if needed.)" msgstr "" #: c-api/veryhigh.rst:146 msgid "" "This is a simplified interface to :c:func:`PyRun_InteractiveLoopFlags` " "below, leaving *flags* set to ``NULL``." msgstr "" #: c-api/veryhigh.rst:152 msgid "" "Read and execute statements from a file associated with an interactive " "device until EOF is reached. The user will be prompted using ``sys.ps1`` " "and ``sys.ps2``. *filename* is decoded from the filesystem encoding (:func:" "`sys.getfilesystemencoding`). Returns ``0`` at EOF or a negative number " "upon failure." msgstr "" #: c-api/veryhigh.rst:161 msgid "" "Can be set to point to a function with the prototype ``int func(void)``. " "The function will be called when Python's interpreter prompt is about to " "become idle and wait for user input from the terminal. The return value is " "ignored. Overriding this hook can be used to integrate the interpreter's " "prompt with other event loops, as done in the :file:`Modules/_tkinter.c` in " "the Python source code." msgstr "" #: c-api/veryhigh.rst:172 msgid "" "Can be set to point to a function with the prototype ``char *func(FILE " "*stdin, FILE *stdout, char *prompt)``, overriding the default function used " "to read a single line of input at the interpreter's prompt. The function is " "expected to output the string *prompt* if it's not ``NULL``, and then read a " "line of input from the provided standard input file, returning the resulting " "string. For example, The :mod:`readline` module sets this hook to provide " "line-editing and tab-completion features." msgstr "" #: c-api/veryhigh.rst:181 msgid "" "The result must be a string allocated by :c:func:`PyMem_RawMalloc` or :c:" "func:`PyMem_RawRealloc`, or ``NULL`` if an error occurred." msgstr "" #: c-api/veryhigh.rst:184 msgid "" "The result must be allocated by :c:func:`PyMem_RawMalloc` or :c:func:" "`PyMem_RawRealloc`, instead of being allocated by :c:func:`PyMem_Malloc` or :" "c:func:`PyMem_Realloc`." msgstr "" #: c-api/veryhigh.rst:192 msgid "" "This is a simplified interface to :c:func:" "`PyParser_SimpleParseStringFlagsFilename` below, leaving *filename* set to " "``NULL`` and *flags* set to ``0``." msgstr "" #: c-api/veryhigh.rst:201 msgid "" "This is a simplified interface to :c:func:" "`PyParser_SimpleParseStringFlagsFilename` below, leaving *filename* set to " "``NULL``." msgstr "" #: c-api/veryhigh.rst:210 msgid "" "Parse Python source code from *str* using the start token *start* according " "to the *flags* argument. The result can be used to create a code object " "which can be evaluated efficiently. This is useful if a code fragment must " "be evaluated many times. *filename* is decoded from the filesystem encoding " "(:func:`sys.getfilesystemencoding`)." msgstr "" #: c-api/veryhigh.rst:221 msgid "" "This is a simplified interface to :c:func:`PyParser_SimpleParseFileFlags` " "below, leaving *flags* set to ``0``." msgstr "" #: c-api/veryhigh.rst:229 msgid "" "Similar to :c:func:`PyParser_SimpleParseStringFlagsFilename`, but the Python " "source code is read from *fp* instead of an in-memory string." msgstr "" #: c-api/veryhigh.rst:237 msgid "" "This is a simplified interface to :c:func:`PyRun_StringFlags` below, leaving " "*flags* set to ``NULL``." msgstr "" #: c-api/veryhigh.rst:243 msgid "" "Execute Python source code from *str* in the context specified by the " "objects *globals* and *locals* with the compiler flags specified by " "*flags*. *globals* must be a dictionary; *locals* can be any object that " "implements the mapping protocol. The parameter *start* specifies the start " "token that should be used to parse the source code." msgstr "" #: c-api/veryhigh.rst:249 msgid "" "Returns the result of executing the code as a Python object, or ``NULL`` if " "an exception was raised." msgstr "" #: c-api/veryhigh.rst:255 msgid "" "This is a simplified interface to :c:func:`PyRun_FileExFlags` below, leaving " "*closeit* set to ``0`` and *flags* set to ``NULL``." msgstr "" #: c-api/veryhigh.rst:261 msgid "" "This is a simplified interface to :c:func:`PyRun_FileExFlags` below, leaving " "*flags* set to ``NULL``." msgstr "" #: c-api/veryhigh.rst:267 msgid "" "This is a simplified interface to :c:func:`PyRun_FileExFlags` below, leaving " "*closeit* set to ``0``." msgstr "" #: c-api/veryhigh.rst:273 msgid "" "Similar to :c:func:`PyRun_StringFlags`, but the Python source code is read " "from *fp* instead of an in-memory string. *filename* should be the name of " "the file, it is decoded from the filesystem encoding (:func:`sys." "getfilesystemencoding`). If *closeit* is true, the file is closed before :c:" "func:`PyRun_FileExFlags` returns." msgstr "" #: c-api/veryhigh.rst:282 msgid "" "This is a simplified interface to :c:func:`Py_CompileStringFlags` below, " "leaving *flags* set to ``NULL``." msgstr "" #: c-api/veryhigh.rst:288 msgid "" "This is a simplified interface to :c:func:`Py_CompileStringExFlags` below, " "with *optimize* set to ``-1``." msgstr "" #: c-api/veryhigh.rst:294 msgid "" "Parse and compile the Python source code in *str*, returning the resulting " "code object. The start token is given by *start*; this can be used to " "constrain the code which can be compiled and should be :const:" "`Py_eval_input`, :const:`Py_file_input`, or :const:`Py_single_input`. The " "filename specified by *filename* is used to construct the code object and " "may appear in tracebacks or :exc:`SyntaxError` exception messages. This " "returns ``NULL`` if the code cannot be parsed or compiled." msgstr "" #: c-api/veryhigh.rst:302 msgid "" "The integer *optimize* specifies the optimization level of the compiler; a " "value of ``-1`` selects the optimization level of the interpreter as given " "by :option:`-O` options. Explicit levels are ``0`` (no optimization; " "``__debug__`` is true), ``1`` (asserts are removed, ``__debug__`` is false) " "or ``2`` (docstrings are removed too)." msgstr "" #: c-api/veryhigh.rst:313 msgid "" "Like :c:func:`Py_CompileStringObject`, but *filename* is a byte string " "decoded from the filesystem encoding (:func:`os.fsdecode`)." msgstr "" #: c-api/veryhigh.rst:320 msgid "" "This is a simplified interface to :c:func:`PyEval_EvalCodeEx`, with just the " "code object, and global and local variables. The other arguments are set to " "``NULL``." msgstr "" #: c-api/veryhigh.rst:327 msgid "" "Evaluate a precompiled code object, given a particular environment for its " "evaluation. This environment consists of a dictionary of global variables, " "a mapping object of local variables, arrays of arguments, keywords and " "defaults, a dictionary of default values for :ref:`keyword-only ` arguments and a closure tuple of cells." msgstr "" #: c-api/veryhigh.rst:336 #, fuzzy msgid "" "The C structure of the objects used to describe frame objects. The fields of " "this type are subject to change at any time." msgstr "" "La structure C utilisée pour décrire les objets *Code*. Les attributs de " "cette structure sont sujets à changer à tout moment." #: c-api/veryhigh.rst:342 msgid "" "Evaluate an execution frame. This is a simplified interface to :c:func:" "`PyEval_EvalFrameEx`, for backward compatibility." msgstr "" #: c-api/veryhigh.rst:348 msgid "" "This is the main, unvarnished function of Python interpretation. The code " "object associated with the execution frame *f* is executed, interpreting " "bytecode and executing calls as needed. The additional *throwflag* " "parameter can mostly be ignored - if true, then it causes an exception to " "immediately be thrown; this is used for the :meth:`~generator.throw` methods " "of generator objects." msgstr "" #: c-api/veryhigh.rst:355 msgid "" "This function now includes a debug assertion to help ensure that it does not " "silently discard an active exception." msgstr "" "Cette fonction inclut maintenant une assertion de débogage afin d'assurer " "qu'elle ne passe pas sous silence une exception active." #: c-api/veryhigh.rst:362 msgid "" "This function changes the flags of the current evaluation frame, and returns " "true on success, false on failure." msgstr "" #: c-api/veryhigh.rst:370 msgid "" "The start symbol from the Python grammar for isolated expressions; for use " "with :c:func:`Py_CompileString`." msgstr "" #: c-api/veryhigh.rst:378 msgid "" "The start symbol from the Python grammar for sequences of statements as read " "from a file or other source; for use with :c:func:`Py_CompileString`. This " "is the symbol to use when compiling arbitrarily long Python source code." msgstr "" #: c-api/veryhigh.rst:387 msgid "" "The start symbol from the Python grammar for a single statement; for use " "with :c:func:`Py_CompileString`. This is the symbol used for the interactive " "interpreter loop." msgstr "" #: c-api/veryhigh.rst:394 msgid "" "This is the structure used to hold compiler flags. In cases where code is " "only being compiled, it is passed as ``int flags``, and in cases where code " "is being executed, it is passed as ``PyCompilerFlags *flags``. In this " "case, ``from __future__ import`` can modify *flags*." msgstr "" #: c-api/veryhigh.rst:399 msgid "" "Whenever ``PyCompilerFlags *flags`` is ``NULL``, :attr:`cf_flags` is treated " "as equal to ``0``, and any modification due to ``from __future__ import`` is " "discarded." msgstr "" #: c-api/veryhigh.rst:405 msgid "Compiler flags." msgstr "" #: c-api/veryhigh.rst:409 msgid "" "*cf_feature_version* is the minor Python version. It should be initialized " "to ``PY_MINOR_VERSION``." msgstr "" #: c-api/veryhigh.rst:412 msgid "" "The field is ignored by default, it is used if and only if ``PyCF_ONLY_AST`` " "flag is set in *cf_flags*." msgstr "" #: c-api/veryhigh.rst:415 msgid "Added *cf_feature_version* field." msgstr "" #: c-api/veryhigh.rst:421 msgid "" "This bit can be set in *flags* to cause division operator ``/`` to be " "interpreted as \"true division\" according to :pep:`238`." msgstr ""