forked from AFPy/python-docs-fr
325 lines
10 KiB
Plaintext
325 lines
10 KiB
Plaintext
# 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-10-01 16:00+0200\n"
|
||
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
||
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
||
"Language-Team: FRENCH <traductions@lists.afpy.org>\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 ``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 <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 sys.meta_path and 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 ``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 <importlib.abc."
|
||
"ResourceLoader.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 <importlib.abc.ResourceLoader."
|
||
"get_data>`, then ``None`` is returned. In particular, the :term:`loader` "
|
||
"for :term:`namespace packages <namespace package>` does not support :meth:"
|
||
"`get_data <importlib.abc.ResourceLoader.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 ""
|