python-docs-fr/library/imp.po

# SOME DESCRIPTIVE TITLE.
# Copyright (C) 1990-2016, Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 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 <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#: ../Doc/library/imp.rst:3
msgid ":mod:`imp` --- Access the :keyword:`import` internals"
msgstr ""

#: ../Doc/library/imp.rst:11
msgid ""
"This module provides an interface to the mechanisms used to implement the :"
"keyword:`import` statement.  It defines the following constants and "
"functions:"
msgstr ""

#: ../Doc/library/imp.rst:19
msgid ""
"Return the magic string value used to recognize byte-compiled code files (:"
"file:`.pyc` files).  (This value may be different for each Python version.)"
msgstr ""

#: ../Doc/library/imp.rst:25
msgid ""
"Return a list of 3-element tuples, each describing a particular type of "
"module. Each triple has the form ``(suffix, mode, type)``, where *suffix* is "
"a string to be appended to the module name to form the filename to search "
"for, *mode* is the mode string to pass to the built-in :func:`open` function "
"to open the file (this can be ``'r'`` for text files or ``'rb'`` for binary "
"files), and *type* is the file type, which has one of the values :const:"
"`PY_SOURCE`, :const:`PY_COMPILED`, or :const:`C_EXTENSION`, described below."
msgstr ""

#: ../Doc/library/imp.rst:37
msgid ""
"Try to find the module *name*.  If *path* is omitted or ``None``, the list "
"of directory names given by ``sys.path`` is searched, but first a few "
"special places are searched: the function tries to find a built-in module "
"with the given name (:const:`C_BUILTIN`), then a frozen module (:const:"
"`PY_FROZEN`), and on some systems some other places are looked in as well "
"(on Windows, it looks in the registry which may point to a specific file)."
msgstr ""

#: ../Doc/library/imp.rst:44
msgid ""
"Otherwise, *path* must be a list of directory names; each directory is "
"searched for files with any of the suffixes returned by :func:`get_suffixes` "
"above.  Invalid names in the list are silently ignored (but all list items "
"must be strings)."
msgstr ""

#: ../Doc/library/imp.rst:49
msgid ""
"If search is successful, the return value is a 3-element tuple ``(file, "
"pathname, description)``:"
msgstr ""

#: ../Doc/library/imp.rst:52
msgid ""
"*file* is an open file object positioned at the beginning, *pathname* is the "
"pathname of the file found, and *description* is a 3-element tuple as "
"contained in the list returned by :func:`get_suffixes` describing the kind "
"of module found."
msgstr ""

#: ../Doc/library/imp.rst:57
msgid ""
"If the module does not live in a file, the returned *file* is ``None``, "
"*pathname* is the empty string, and the *description* tuple contains empty "
"strings for its suffix and mode; the module type is indicated as given in "
"parentheses above.  If the search is unsuccessful, :exc:`ImportError` is "
"raised.  Other exceptions indicate problems with the arguments or "
"environment."
msgstr ""

#: ../Doc/library/imp.rst:64
msgid ""
"If the module is a package, *file* is ``None``, *pathname* is the package "
"path and the last item in the *description* tuple is :const:`PKG_DIRECTORY`."
msgstr ""

#: ../Doc/library/imp.rst:67
msgid ""
"This function does not handle hierarchical module names (names containing "
"dots).  In order to find *P.M*, that is, submodule *M* of package *P*, use :"
"func:`find_module` and :func:`load_module` to find and load package *P*, and "
"then use :func:`find_module` with the *path* argument set to ``P.__path__``. "
"When *P* itself has a dotted name, apply this recipe recursively."
msgstr ""

#: ../Doc/library/imp.rst:78
msgid ""
"Load a module that was previously found by :func:`find_module` (or by an "
"otherwise conducted search yielding compatible results).  This function does "
"more than importing the module: if the module was already imported, it is "
"equivalent to a :func:`reload`!  The *name* argument indicates the full "
"module name (including the package name, if this is a submodule of a "
"package).  The *file* argument is an open file, and *pathname* is the "
"corresponding file name; these can be ``None`` and ``''``, respectively, "
"when the module is a package or not being loaded from a file.  The "
"*description* argument is a tuple, as would be returned by :func:"
"`get_suffixes`, describing what kind of module must be loaded."
msgstr ""

#: ../Doc/library/imp.rst:89
msgid ""
"If the load is successful, the return value is the module object; otherwise, "
"an exception (usually :exc:`ImportError`) is raised."
msgstr ""

#: ../Doc/library/imp.rst:92
msgid ""
"**Important:** the caller is responsible for closing the *file* argument, if "
"it was not ``None``, even when an exception is raised.  This is best done "
"using a :keyword:`try` ... :keyword:`finally` statement."
msgstr ""

#: ../Doc/library/imp.rst:99
msgid ""
"Return a new empty module object called *name*.  This object is *not* "
"inserted in ``sys.modules``."
msgstr ""

#: ../Doc/library/imp.rst:105
msgid ""
"Return ``True`` if the import lock is currently held, else ``False``. On "
"platforms without threads, always return ``False``."
msgstr ""

#: ../Doc/library/imp.rst:108
msgid ""
"On platforms with threads, a thread executing an import holds an internal "
"lock until the import is complete. This lock blocks other threads from doing "
"an import until the original import completes, which in turn prevents other "
"threads from seeing incomplete module objects constructed by the original "
"thread while in the process of completing its import (and the imports, if "
"any, triggered by that)."
msgstr ""

#: ../Doc/library/imp.rst:118
msgid ""
"Acquire the interpreter's import lock for the current thread.  This lock "
"should be used by import hooks to ensure thread-safety when importing "
"modules."
msgstr ""

#: ../Doc/library/imp.rst:121
msgid ""
"Once a thread has acquired the import lock, the same thread may acquire it "
"again without blocking; the thread must release it once for each time it has "
"acquired it."
msgstr ""

#: ../Doc/library/imp.rst:125
msgid "On platforms without threads, this function does nothing."
msgstr ""

#: ../Doc/library/imp.rst:132
msgid ""
"Release the interpreter's import lock. On platforms without threads, this "
"function does nothing."
msgstr ""

#: ../Doc/library/imp.rst:137
msgid ""
"The following constants with integer values, defined in this module, are "
"used to indicate the search result of :func:`find_module`."
msgstr ""

#: ../Doc/library/imp.rst:143
msgid "The module was found as a source file."
msgstr ""

#: ../Doc/library/imp.rst:148
msgid "The module was found as a compiled code object file."
msgstr ""

#: ../Doc/library/imp.rst:153
msgid "The module was found as dynamically loadable shared library."
msgstr ""

#: ../Doc/library/imp.rst:158
msgid "The module was found as a package directory."
msgstr ""

#: ../Doc/library/imp.rst:163
msgid "The module was found as a built-in module."
msgstr ""

#: ../Doc/library/imp.rst:168
msgid "The module was found as a frozen module (see :func:`init_frozen`)."
msgstr ""

#: ../Doc/library/imp.rst:170
msgid ""
"The following constant and functions are obsolete; their functionality is "
"available through :func:`find_module` or :func:`load_module`. They are kept "
"around for backward compatibility:"
msgstr ""

#: ../Doc/library/imp.rst:177
msgid "Unused."
msgstr ""

#: ../Doc/library/imp.rst:182
msgid ""
"Initialize the built-in module called *name* and return its module object "
"along with storing it in ``sys.modules``.  If the module was already "
"initialized, it will be initialized *again*.  Re-initialization involves the "
"copying of the built-in module's ``__dict__`` from the cached module over "
"the module's entry in ``sys.modules``.  If there is no built-in module "
"called *name*, ``None`` is returned."
msgstr ""

#: ../Doc/library/imp.rst:192
msgid ""
"Initialize the frozen module called *name* and return its module object.  If "
"the module was already initialized, it will be initialized *again*.  If "
"there is no frozen module called *name*, ``None`` is returned.  (Frozen "
"modules are modules written in Python whose compiled byte-code object is "
"incorporated into a custom-built Python interpreter by Python's :program:"
"`freeze` utility. See :file:`Tools/freeze/` for now.)"
msgstr ""

#: ../Doc/library/imp.rst:202
msgid ""
"Return ``1`` if there is a built-in module called *name* which can be "
"initialized again.  Return ``-1`` if there is a built-in module called "
"*name* which cannot be initialized again (see :func:`init_builtin`).  Return "
"``0`` if there is no built-in module called *name*."
msgstr ""

#: ../Doc/library/imp.rst:210
msgid ""
"Return ``True`` if there is a frozen module (see :func:`init_frozen`) called "
"*name*, or ``False`` if there is no such module."
msgstr ""

#: ../Doc/library/imp.rst:218
msgid ""
"Load and initialize a module implemented as a byte-compiled code file and "
"return its module object.  If the module was already initialized, it will be "
"initialized *again*.  The *name* argument is used to create or access a "
"module object.  The *pathname* argument points to the byte-compiled code "
"file.  The *file* argument is the byte-compiled code file, open for reading "
"in binary mode, from the beginning. It must currently be a real file object, "
"not a user-defined class emulating a file."
msgstr ""

#: ../Doc/library/imp.rst:229
msgid ""
"Load and initialize a module implemented as a dynamically loadable shared "
"library and return its module object.  If the module was already "
"initialized, it will be initialized *again*. Re-initialization involves "
"copying the ``__dict__`` attribute of the cached instance of the module over "
"the value used in the module cached in ``sys.modules``.  The *pathname* "
"argument must point to the shared library.  The *name* argument is used to "
"construct the name of the initialization function: an external C function "
"called ``initname()`` in the shared library is called.  The optional *file* "
"argument is ignored.  (Note: using shared libraries is highly system "
"dependent, and not all systems support it.)"
msgstr ""

#: ../Doc/library/imp.rst:242
msgid ""
"The import internals identify extension modules by filename, so doing ``foo "
"= load_dynamic(\"foo\", \"mod.so\")`` and ``bar = load_dynamic(\"bar\", "
"\"mod.so\")`` will result in both foo and bar referring to the same module, "
"regardless of whether or not ``mod.so`` exports an ``initbar`` function. On "
"systems which support them, symlinks can be used to import multiple modules "
"from the same shared library, as each reference to the module will use a "
"different file name."
msgstr ""

#: ../Doc/library/imp.rst:254
msgid ""
"Load and initialize a module implemented as a Python source file and return "
"its module object.  If the module was already initialized, it will be "
"initialized *again*.  The *name* argument is used to create or access a "
"module object.  The *pathname* argument points to the source file.  The "
"*file* argument is the source file, open for reading as text, from the "
"beginning. It must currently be a real file object, not a user-defined class "
"emulating a file.  Note that if a properly matching byte-compiled file (with "
"suffix :file:`.pyc` or :file:`.pyo`) exists, it will be used instead of "
"parsing the given source file."
msgstr ""

#: ../Doc/library/imp.rst:266
msgid ""
"The :class:`NullImporter` type is a :pep:`302` import hook that handles non-"
"directory path strings by failing to find any modules.  Calling this type "
"with an existing directory or empty string raises :exc:`ImportError`. "
"Otherwise, a :class:`NullImporter` instance is returned."
msgstr ""

#: ../Doc/library/imp.rst:271
msgid ""
"Python adds instances of this type to ``sys.path_importer_cache`` for any "
"path entries that are not directories and are not handled by any other path "
"hooks on ``sys.path_hooks``.  Instances have only one method:"
msgstr ""

#: ../Doc/library/imp.rst:278
msgid ""
"This method always returns ``None``, indicating that the requested module "
"could not be found."
msgstr ""

#: ../Doc/library/imp.rst:287
msgid "Examples"
msgstr "Exemples"

#: ../Doc/library/imp.rst:289
msgid ""
"The following function emulates what was the standard import statement up to "
"Python 1.4 (no hierarchical module names).  (This *implementation* wouldn't "
"work in that version, since :func:`find_module` has been extended and :func:"
"`load_module` has been added in 1.4.) ::"
msgstr ""

#: ../Doc/library/imp.rst:320
msgid ""
"A more complete example that implements hierarchical module names and "
"includes a :func:`reload` function can be found in the module :mod:`knee`.  "
"The :mod:`knee` module can be found in :file:`Demo/imputil/` in the Python "
"source distribution."
msgstr ""