# 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/import.rst:6 msgid "Importing Modules" msgstr "Importer des modules" #: c-api/import.rst:16 msgid "" "This is a simplified interface to :c:func:`PyImport_ImportModuleEx` below, " "leaving the *globals* and *locals* arguments set to ``NULL`` and *level* set " "to 0. When the *name* argument contains a dot (when it specifies a " "submodule of a package), the *fromlist* argument is set to the list " "``['*']`` so that the return value is the named module rather than the top-" "level package containing it as would otherwise be the case. (Unfortunately, " "this has an additional side effect when *name* in fact specifies a " "subpackage instead of a submodule: the submodules specified in the package's " "``__all__`` variable are loaded.) Return a new reference to the imported " "module, or ``NULL`` with an exception set on failure. A failing import of a " "module doesn't leave the module in :data:`sys.modules`." msgstr "" #: c-api/import.rst:28 c-api/import.rst:89 msgid "This function always uses absolute imports." msgstr "" #: c-api/import.rst:33 msgid "This function is a deprecated alias of :c:func:`PyImport_ImportModule`." msgstr "" #: c-api/import.rst:35 msgid "" "This function used to fail immediately when the import lock was held by " "another thread. In Python 3.3 though, the locking scheme switched to per-" "module locks for most purposes, so this function's special behaviour isn't " "needed anymore." msgstr "" #: c-api/import.rst:46 msgid "" "Import a module. This is best described by referring to the built-in Python " "function :func:`__import__`." msgstr "" #: c-api/import.rst:49 c-api/import.rst:65 msgid "" "The return value is a new reference to the imported module or top-level " "package, or ``NULL`` with an exception set on failure. Like for :func:" "`__import__`, the return value when a submodule of a package was requested " "is normally the top-level package, unless a non-empty *fromlist* was given." msgstr "" #: c-api/import.rst:55 msgid "" "Failing imports remove incomplete module objects, like with :c:func:" "`PyImport_ImportModule`." msgstr "" #: c-api/import.rst:61 msgid "" "Import a module. This is best described by referring to the built-in Python " "function :func:`__import__`, as the standard :func:`__import__` function " "calls this function directly." msgstr "" #: c-api/import.rst:75 msgid "" "Similar to :c:func:`PyImport_ImportModuleLevelObject`, but the name is a " "UTF-8 encoded string instead of a Unicode object." msgstr "" #: c-api/import.rst:78 msgid "Negative values for *level* are no longer accepted." msgstr "" #: c-api/import.rst:83 msgid "" "This is a higher-level interface that calls the current \"import hook " "function\" (with an explicit *level* of 0, meaning absolute import). It " "invokes the :func:`__import__` function from the ``__builtins__`` of the " "current globals. This means that the import is done using whatever import " "hooks are installed in the current environment." msgstr "" #: c-api/import.rst:94 msgid "" "Reload a module. Return a new reference to the reloaded module, or ``NULL`` " "with an exception set on failure (the module still exists in this case)." msgstr "" #: c-api/import.rst:100 msgid "" "Return the module object corresponding to a module name. The *name* " "argument may be of the form ``package.module``. First check the modules " "dictionary if there's one there, and if not, create a new one and insert it " "in the modules dictionary. Return ``NULL`` with an exception set on failure." msgstr "" #: c-api/import.rst:107 msgid "" "This function does not load or import the module; if the module wasn't " "already loaded, you will get an empty module object. Use :c:func:" "`PyImport_ImportModule` or one of its variants to import a module. Package " "structures implied by a dotted name for *name* are not created if not " "already present." msgstr "" #: c-api/import.rst:117 msgid "" "Similar to :c:func:`PyImport_AddModuleObject`, but the name is a UTF-8 " "encoded string instead of a Unicode object." msgstr "" #: c-api/import.rst:125 msgid "" "Given a module name (possibly of the form ``package.module``) and a code " "object read from a Python bytecode file or obtained from the built-in " "function :func:`compile`, load the module. Return a new reference to the " "module object, or ``NULL`` with an exception set if an error occurred. " "*name* is removed from :attr:`sys.modules` in error cases, even if *name* " "was already in :attr:`sys.modules` on entry to :c:func:" "`PyImport_ExecCodeModule`. Leaving incompletely initialized modules in :" "attr:`sys.modules` is dangerous, as imports of such modules have no way to " "know that the module object is an unknown (and probably damaged with respect " "to the module author's intents) state." msgstr "" #: c-api/import.rst:135 msgid "" "The module's :attr:`__spec__` and :attr:`__loader__` will be set, if not set " "already, with the appropriate values. The spec's loader will be set to the " "module's ``__loader__`` (if set) and to an instance of :class:" "`SourceFileLoader` otherwise." msgstr "" #: c-api/import.rst:140 msgid "" "The module's :attr:`__file__` attribute will be set to the code object's :c:" "member:`co_filename`. If applicable, :attr:`__cached__` will also be set." msgstr "" #: c-api/import.rst:144 msgid "" "This function will reload the module if it was already imported. See :c:" "func:`PyImport_ReloadModule` for the intended way to reload a module." msgstr "" #: c-api/import.rst:147 msgid "" "If *name* points to a dotted name of the form ``package.module``, any " "package structures not already created will still not be created." msgstr "" #: c-api/import.rst:150 msgid "" "See also :c:func:`PyImport_ExecCodeModuleEx` and :c:func:" "`PyImport_ExecCodeModuleWithPathnames`." msgstr "" #: c-api/import.rst:156 msgid "" "Like :c:func:`PyImport_ExecCodeModule`, but the :attr:`__file__` attribute " "of the module object is set to *pathname* if it is non-``NULL``." msgstr "" #: c-api/import.rst:159 msgid "See also :c:func:`PyImport_ExecCodeModuleWithPathnames`." msgstr "" #: c-api/import.rst:164 msgid "" "Like :c:func:`PyImport_ExecCodeModuleEx`, but the :attr:`__cached__` " "attribute of the module object is set to *cpathname* if it is non-``NULL``. " "Of the three functions, this is the preferred one to use." msgstr "" #: c-api/import.rst:173 msgid "" "Like :c:func:`PyImport_ExecCodeModuleObject`, but *name*, *pathname* and " "*cpathname* are UTF-8 encoded strings. Attempts are also made to figure out " "what the value for *pathname* should be from *cpathname* if the former is " "set to ``NULL``." msgstr "" #: c-api/import.rst:179 msgid "" "Uses :func:`imp.source_from_cache()` in calculating the source path if only " "the bytecode path is provided." msgstr "" #: c-api/import.rst:186 msgid "" "Return the magic number for Python bytecode files (a.k.a. :file:`.pyc` " "file). The magic number should be present in the first four bytes of the " "bytecode file, in little-endian byte order. Returns ``-1`` on error." msgstr "" #: c-api/import.rst:190 msgid "Return value of ``-1`` upon failure." msgstr "" #: c-api/import.rst:196 msgid "" "Return the magic tag string for :pep:`3147` format Python bytecode file " "names. Keep in mind that the value at ``sys.implementation.cache_tag`` is " "authoritative and should be used instead of this function." msgstr "" #: c-api/import.rst:204 msgid "" "Return the dictionary used for the module administration (a.k.a. ``sys." "modules``). Note that this is a per-interpreter variable." msgstr "" #: c-api/import.rst:209 msgid "" "Return the already imported module with the given name. If the module has " "not been imported yet then returns ``NULL`` but does not set an error. " "Returns ``NULL`` and sets an error if the lookup failed." msgstr "" #: c-api/import.rst:217 msgid "" "Return a finder object for a :data:`sys.path`/:attr:`pkg.__path__` item " "*path*, possibly by fetching it from the :data:`sys.path_importer_cache` " "dict. If it wasn't yet cached, traverse :data:`sys.path_hooks` until a hook " "is found that can handle the path item. Return ``None`` if no hook could; " "this tells our caller that the :term:`path based finder` could not find a " "finder for this path item. Cache the result in :data:`sys." "path_importer_cache`. Return a new reference to the finder object." msgstr "" #: c-api/import.rst:228 msgid "" "Load a frozen module named *name*. Return ``1`` for success, ``0`` if the " "module is not found, and ``-1`` with an exception set if the initialization " "failed. To access the imported module on a successful load, use :c:func:" "`PyImport_ImportModule`. (Note the misnomer --- this function would reload " "the module if it was already imported.)" msgstr "" #: c-api/import.rst:236 msgid "The ``__file__`` attribute is no longer set on the module." msgstr "" #: c-api/import.rst:242 msgid "" "Similar to :c:func:`PyImport_ImportFrozenModuleObject`, but the name is a " "UTF-8 encoded string instead of a Unicode object." msgstr "" #: c-api/import.rst:250 msgid "" "This is the structure type definition for frozen module descriptors, as " "generated by the :program:`freeze` utility (see :file:`Tools/freeze/` in the " "Python source distribution). Its definition, found in :file:`Include/import." "h`, is::" msgstr "" #: c-api/import.rst:264 msgid "" "This pointer is initialized to point to an array of :c:type:`struct _frozen` " "records, terminated by one whose members are all ``NULL`` or zero. When a " "frozen module is imported, it is searched in this table. Third-party code " "could play tricks with this to provide a dynamically created collection of " "frozen modules." msgstr "" "Ce pointeur est initialisé de manière à pointer sur un tableau d'entrées de :" "c:type:`struct _frozen`, dont tous les membres de la dernière valent " "``NULL`` ou zéro. Quand un module figé est importé, il est cherché dans ce " "tableau. Du code tiers peut jouer avec pour construire dynamiquement une " "collection de module figés." #: c-api/import.rst:272 msgid "" "Add a single module to the existing table of built-in modules. This is a " "convenience wrapper around :c:func:`PyImport_ExtendInittab`, returning " "``-1`` if the table could not be extended. The new module can be imported " "by the name *name*, and uses the function *initfunc* as the initialization " "function called on the first attempted import. This should be called " "before :c:func:`Py_Initialize`." msgstr "" #: c-api/import.rst:282 msgid "" "Structure describing a single entry in the list of built-in modules. Each " "of these structures gives the name and initialization function for a module " "built into the interpreter. The name is an ASCII encoded string. Programs " "which embed Python may use an array of these structures in conjunction with :" "c:func:`PyImport_ExtendInittab` to provide additional built-in modules. The " "structure is defined in :file:`Include/import.h` as::" msgstr "" #: c-api/import.rst:297 msgid "" "Add a collection of modules to the table of built-in modules. The *newtab* " "array must end with a sentinel entry which contains ``NULL`` for the :attr:" "`name` field; failure to provide the sentinel value can result in a memory " "fault. Returns ``0`` on success or ``-1`` if insufficient memory could be " "allocated to extend the internal table. In the event of failure, no modules " "are added to the internal table. This should be called before :c:func:" "`Py_Initialize`." msgstr ""