# 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: 2022-05-22 23:13+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" #: library/pkgutil.rst:2 msgid ":mod:`pkgutil` --- Package extension utility" msgstr "" #: library/pkgutil.rst:7 msgid "**Source code:** :source:`Lib/pkgutil.py`" msgstr "**Code source :** :source:`Lib/pkgutil.py`" #: library/pkgutil.rst:11 msgid "" "This module provides utilities for the import system, in particular package " "support." msgstr "" #: library/pkgutil.rst:16 msgid "A namedtuple that holds a brief summary of a module's info." msgstr "" #: library/pkgutil.rst:22 msgid "" "Extend the search path for the modules which comprise a package. Intended " "use is to place the following code in a package's :file:`__init__.py`::" msgstr "" #: library/pkgutil.rst:28 msgid "" "This will add to the package's ``__path__`` all subdirectories of " "directories on :data:`sys.path` named after the package. This is useful if " "one wants to distribute different parts of a single logical package as " "multiple directories." msgstr "" #: library/pkgutil.rst:33 msgid "" "It also looks for :file:`\\*.pkg` files beginning where ``*`` matches the " "*name* argument. This feature is similar to :file:`\\*.pth` files (see the :" "mod:`site` module for more information), except that it doesn't special-case " "lines starting with ``import``. A :file:`\\*.pkg` file is trusted at face " "value: apart from checking for duplicates, all entries found in a :file:`\\*." "pkg` file are added to the path, regardless of whether they exist on the " "filesystem. (This is a feature.)" msgstr "" #: library/pkgutil.rst:41 msgid "" "If the input path is not a list (as is the case for frozen packages) it is " "returned unchanged. The input path is not modified; an extended copy is " "returned. Items are only appended to the copy at the end." msgstr "" #: library/pkgutil.rst:45 msgid "" "It is assumed that :data:`sys.path` is a sequence. Items of :data:`sys." "path` that are not strings referring to existing directories are ignored. " "Unicode items on :data:`sys.path` that cause errors when used as filenames " "may cause this function to raise an exception (in line with :func:`os.path." "isdir` behavior)." msgstr "" #: library/pkgutil.rst:54 msgid ":pep:`302` Finder that wraps Python's \"classic\" import algorithm." msgstr "" #: library/pkgutil.rst:56 msgid "" "If *dirname* is a string, a :pep:`302` finder is created that searches that " "directory. If *dirname* is ``None``, a :pep:`302` finder is created that " "searches the current :data:`sys.path`, plus any modules that are frozen or " "built-in." msgstr "" #: library/pkgutil.rst:61 msgid "" "Note that :class:`ImpImporter` does not currently support being used by " "placement on :data:`sys.meta_path`." msgstr "" #: library/pkgutil.rst:73 msgid "" "This emulation is no longer needed, as the standard import mechanism is now " "fully :pep:`302` compliant and available in :mod:`importlib`." msgstr "" #: library/pkgutil.rst:71 msgid "" ":term:`Loader ` that wraps Python's \"classic\" import algorithm." msgstr "" #: library/pkgutil.rst:80 msgid "Retrieve a module :term:`loader` for the given *fullname*." msgstr "" #: library/pkgutil.rst:82 msgid "" "This is a backwards compatibility wrapper around :func:`importlib.util." "find_spec` that converts most failures to :exc:`ImportError` and only " "returns the loader rather than the full :class:`ModuleSpec`." msgstr "" #: library/pkgutil.rst:104 library/pkgutil.rst:140 library/pkgutil.rst:200 msgid "" "Updated to be based directly on :mod:`importlib` rather than relying on the " "package internal :pep:`302` import emulation." msgstr "" #: library/pkgutil.rst:123 msgid "Updated to be based on :pep:`451`" msgstr "" #: library/pkgutil.rst:96 msgid "Retrieve a :term:`finder` for the given *path_item*." msgstr "" #: library/pkgutil.rst:98 msgid "" "The returned finder is cached in :data:`sys.path_importer_cache` if it was " "newly created by a path hook." msgstr "" #: library/pkgutil.rst:101 msgid "" "The cache (or part of it) can be cleared manually if a rescan of :data:`sys." "path_hooks` is necessary." msgstr "" #: library/pkgutil.rst:111 msgid "Get a :term:`loader` object for *module_or_name*." msgstr "" #: library/pkgutil.rst:113 msgid "" "If the module or package is accessible via the normal import mechanism, a " "wrapper around the relevant part of that machinery is returned. Returns " "``None`` if the module cannot be found or imported. If the named module is " "not already imported, its containing package (if any) is imported, in order " "to establish the package ``__path__``." msgstr "" #: library/pkgutil.rst:129 msgid "Yield :term:`finder` objects for the given module name." msgstr "" #: library/pkgutil.rst:131 msgid "" "If fullname contains a ``'.'``, the finders will be for the package " "containing fullname, otherwise they will be all registered top level finders " "(i.e. those on both :data:`sys.meta_path` and :data:`sys.path_hooks`)." msgstr "" #: library/pkgutil.rst:135 msgid "" "If the named module is in a package, that package is imported as a side " "effect of invoking this function." msgstr "" #: library/pkgutil.rst:138 msgid "If no module name is specified, all top level finders are produced." msgstr "" #: library/pkgutil.rst:147 msgid "" "Yields :class:`ModuleInfo` for all submodules on *path*, or, if *path* is " "``None``, all top-level modules on :data:`sys.path`." msgstr "" #: library/pkgutil.rst:171 msgid "" "*path* should be either ``None`` or a list of paths to look for modules in." msgstr "" #: library/pkgutil.rst:173 msgid "" "*prefix* is a string to output on the front of every module name on output." msgstr "" #: library/pkgutil.rst:195 msgid "" "Only works for a :term:`finder` which defines an ``iter_modules()`` method. " "This interface is non-standard, so the module also provides implementations " "for :class:`importlib.machinery.FileFinder` and :class:`zipimport." "zipimporter`." msgstr "" #: library/pkgutil.rst:168 msgid "" "Yields :class:`ModuleInfo` for all modules recursively on *path*, or, if " "*path* is ``None``, all accessible modules." msgstr "" #: library/pkgutil.rst:175 msgid "" "Note that this function must import all *packages* (*not* all modules!) on " "the given *path*, in order to access the ``__path__`` attribute to find " "submodules." msgstr "" #: library/pkgutil.rst:179 msgid "" "*onerror* is a function which gets called with one argument (the name of the " "package which was being imported) if any exception occurs while trying to " "import a package. If no *onerror* function is supplied, :exc:" "`ImportError`\\s are caught and ignored, while all other exceptions are " "propagated, terminating the search." msgstr "" #: library/pkgutil.rst:185 msgid "Examples::" msgstr "Exemples ::" #: library/pkgutil.rst:207 msgid "Get a resource from a package." msgstr "" #: library/pkgutil.rst:209 msgid "" "This is a wrapper for the :term:`loader` :meth:`get_data ` API. The *package* argument should be the name of " "a package, in standard module format (``foo.bar``). The *resource* argument " "should be in the form of a relative filename, using ``/`` as the path " "separator. The parent directory name ``..`` is not allowed, and nor is a " "rooted name (starting with a ``/``)." msgstr "" #: library/pkgutil.rst:216 msgid "" "The function returns a binary string that is the contents of the specified " "resource." msgstr "" #: library/pkgutil.rst:219 msgid "" "For packages located in the filesystem, which have already been imported, " "this is the rough equivalent of::" msgstr "" #: library/pkgutil.rst:225 msgid "" "If the package cannot be located or loaded, or it uses a :term:`loader` " "which does not support :meth:`get_data `, then ``None`` is returned. In particular, the :term:`loader` " "for :term:`namespace packages ` does not support :meth:" "`get_data `." msgstr "" #: library/pkgutil.rst:234 msgid "Resolve a name to an object." msgstr "" #: library/pkgutil.rst:236 msgid "" "This functionality is used in numerous places in the standard library (see :" "issue:`12915`) - and equivalent functionality is also in widely used third-" "party packages such as setuptools, Django and Pyramid." msgstr "" #: library/pkgutil.rst:240 msgid "" "It is expected that *name* will be a string in one of the following formats, " "where W is shorthand for a valid Python identifier and dot stands for a " "literal period in these pseudo-regexes:" msgstr "" #: library/pkgutil.rst:244 msgid "``W(.W)*``" msgstr "" #: library/pkgutil.rst:245 msgid "``W(.W)*:(W(.W)*)?``" msgstr "" #: library/pkgutil.rst:247 msgid "" "The first form is intended for backward compatibility only. It assumes that " "some part of the dotted name is a package, and the rest is an object " "somewhere within that package, possibly nested inside other objects. Because " "the place where the package stops and the object hierarchy starts can't be " "inferred by inspection, repeated attempts to import must be done with this " "form." msgstr "" #: library/pkgutil.rst:254 msgid "" "In the second form, the caller makes the division point clear through the " "provision of a single colon: the dotted name to the left of the colon is a " "package to be imported, and the dotted name to the right is the object " "hierarchy within that package. Only one import is needed in this form. If it " "ends with the colon, then a module object is returned." msgstr "" #: library/pkgutil.rst:260 msgid "" "The function will return an object (which might be a module), or raise one " "of the following exceptions:" msgstr "" #: library/pkgutil.rst:263 msgid ":exc:`ValueError` -- if *name* isn't in a recognised format." msgstr "" #: library/pkgutil.rst:265 msgid ":exc:`ImportError` -- if an import failed when it shouldn't have." msgstr "" #: library/pkgutil.rst:267 msgid "" ":exc:`AttributeError` -- If a failure occurred when traversing the object " "hierarchy within the imported package to get to the desired object." msgstr ""