# 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-10-18 15:46+0200\n"
"PO-Revision-Date: 2019-09-04 11:42+0200\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/importlib.metadata.rst:5
msgid "Using :mod:`!importlib.metadata`"
msgstr ""

#: library/importlib.metadata.rst:11
msgid "``importlib.metadata`` is no longer provisional."
msgstr ""

#: library/importlib.metadata.rst:14
msgid "**Source code:** :source:`Lib/importlib/metadata/__init__.py`"
msgstr ""

#: library/importlib.metadata.rst:16
msgid ""
"``importlib.metadata`` is a library that provides for access to installed "
"package metadata.  Built in part on Python's import system, this library "
"intends to replace similar functionality in the `entry point API`_ and "
"`metadata API`_ of ``pkg_resources``.  Along with :mod:`importlib.resources` "
"in Python 3.7 and newer (backported as `importlib_resources`_ for older "
"versions of Python), this can eliminate the need to use the older and less "
"efficient ``pkg_resources`` package."
msgstr ""

#: library/importlib.metadata.rst:25
msgid ""
"By \"installed package\" we generally mean a third-party package installed "
"into Python's ``site-packages`` directory via tools such as `pip <https://"
"pypi.org/project/pip/>`_.  Specifically, it means a package with either a "
"discoverable ``dist-info`` or ``egg-info`` directory, and metadata defined "
"by :pep:`566` or its older specifications. By default, package metadata can "
"live on the file system or in zip archives on :data:`sys.path`.  Through an "
"extension mechanism, the metadata can live almost anywhere."
msgstr ""

#: library/importlib.metadata.rst:36
msgid "Overview"
msgstr "Aperçu"

#: library/importlib.metadata.rst:38
msgid ""
"Let's say you wanted to get the version string for a package you've "
"installed using ``pip``.  We start by creating a virtual environment and "
"installing something into it:"
msgstr ""

#: library/importlib.metadata.rst:48
msgid "You can get the version string for ``wheel`` by running the following:"
msgstr ""

#: library/importlib.metadata.rst:57
msgid ""
"You can also get the set of entry points keyed by group, such as "
"``console_scripts``, ``distutils.commands`` and others.  Each group contains "
"a sequence of :ref:`EntryPoint <entry-points>` objects."
msgstr ""

#: library/importlib.metadata.rst:61
msgid "You can get the :ref:`metadata for a distribution <metadata>`::"
msgstr ""

#: library/importlib.metadata.rst:66
msgid ""
"You can also get a :ref:`distribution's version number <version>`, list its :"
"ref:`constituent files <files>`, and get a list of the distribution's :ref:"
"`requirements`."
msgstr ""

#: library/importlib.metadata.rst:72
msgid "Functional API"
msgstr "API par fonction"

#: library/importlib.metadata.rst:74
msgid "This package provides the following functionality via its public API."
msgstr ""

#: library/importlib.metadata.rst:80
msgid "Entry points"
msgstr ""

#: library/importlib.metadata.rst:82
msgid ""
"The ``entry_points()`` function returns a collection of entry points. Entry "
"points are represented by ``EntryPoint`` instances; each ``EntryPoint`` has "
"a ``.name``, ``.group``, and ``.value`` attributes and a ``.load()`` method "
"to resolve the value.  There are also ``.module``, ``.attr``, and ``."
"extras`` attributes for getting the components of the ``.value`` attribute."
msgstr ""

#: library/importlib.metadata.rst:89
msgid "Query all entry points::"
msgstr ""

#: library/importlib.metadata.rst:93
msgid ""
"The ``entry_points()`` function returns an ``EntryPoints`` object, a "
"sequence of all ``EntryPoint`` objects with ``names`` and ``groups`` "
"attributes for convenience::"
msgstr ""

#: library/importlib.metadata.rst:100
msgid ""
"``EntryPoints`` has a ``select`` method to select entry points matching "
"specific properties. Select entry points in the ``console_scripts`` group::"
msgstr ""

#: library/importlib.metadata.rst:106
msgid ""
"Equivalently, since ``entry_points`` passes keyword arguments through to "
"select::"
msgstr ""

#: library/importlib.metadata.rst:111
msgid ""
"Pick out a specific script named \"wheel\" (found in the wheel project)::"
msgstr ""

#: library/importlib.metadata.rst:117
msgid "Equivalently, query for that entry point during selection::"
msgstr ""

#: library/importlib.metadata.rst:122
msgid "Inspect the resolved entry point::"
msgstr ""

#: library/importlib.metadata.rst:136
msgid ""
"The ``group`` and ``name`` are arbitrary values defined by the package "
"author and usually a client will wish to resolve all entry points for a "
"particular group.  Read `the setuptools docs <https://setuptools.pypa.io/en/"
"latest/userguide/entry_point.html>`_ for more information on entry points, "
"their definition, and usage."
msgstr ""

#: library/importlib.metadata.rst:142
msgid "*Compatibility Note*"
msgstr ""

#: library/importlib.metadata.rst:144
msgid ""
"The \"selectable\" entry points were introduced in ``importlib_metadata`` "
"3.6 and Python 3.10. Prior to those changes, ``entry_points`` accepted no "
"parameters and always returned a dictionary of entry points, keyed by group. "
"For compatibility, if no parameters are passed to entry_points, a "
"``SelectableGroups`` object is returned, implementing that dict interface. "
"In the future, calling ``entry_points`` with no parameters will return an "
"``EntryPoints`` object. Users should rely on the selection interface to "
"retrieve entry points by group."
msgstr ""

#: library/importlib.metadata.rst:157
msgid "Distribution metadata"
msgstr ""

#: library/importlib.metadata.rst:159
msgid ""
"Every distribution includes some metadata, which you can extract using the "
"``metadata()`` function::"
msgstr ""

#: library/importlib.metadata.rst:164
msgid ""
"The keys of the returned data structure, a ``PackageMetadata``, name the "
"metadata keywords, and the values are returned unparsed from the "
"distribution metadata::"
msgstr ""

#: library/importlib.metadata.rst:171
msgid ""
"``PackageMetadata`` also presents a ``json`` attribute that returns all the "
"metadata in a JSON-compatible form per :PEP:`566`::"
msgstr ""

#: library/importlib.metadata.rst:177
msgid ""
"The ``Description`` is now included in the metadata when presented through "
"the payload. Line continuation characters have been removed."
msgstr ""

#: library/importlib.metadata.rst:181
msgid "The ``json`` attribute was added."
msgstr ""

#: library/importlib.metadata.rst:188
msgid "Distribution versions"
msgstr ""

#: library/importlib.metadata.rst:190
msgid ""
"The ``version()`` function is the quickest way to get a distribution's "
"version number, as a string::"
msgstr ""

#: library/importlib.metadata.rst:200
msgid "Distribution files"
msgstr ""

#: library/importlib.metadata.rst:202
msgid ""
"You can also get the full set of files contained within a distribution.  The "
"``files()`` function takes a distribution package name and returns all of "
"the files installed by this distribution.  Each file object returned is a "
"``PackagePath``, a :class:`pathlib.PurePath` derived object with additional "
"``dist``, ``size``, and ``hash`` properties as indicated by the metadata.  "
"For example::"
msgstr ""

#: library/importlib.metadata.rst:218
msgid "Once you have the file, you can also read its contents::"
msgstr ""

#: library/importlib.metadata.rst:229
msgid ""
"You can also use the ``locate`` method to get a the absolute path to the "
"file::"
msgstr ""

#: library/importlib.metadata.rst:235
msgid ""
"In the case where the metadata file listing files (RECORD or SOURCES.txt) is "
"missing, ``files()`` will return ``None``. The caller may wish to wrap calls "
"to ``files()`` in `always_iterable <https://more-itertools.readthedocs.io/en/"
"stable/api.html#more_itertools.always_iterable>`_ or otherwise guard against "
"this condition if the target distribution is not known to have the metadata "
"present."
msgstr ""

#: library/importlib.metadata.rst:246
msgid "Distribution requirements"
msgstr ""

#: library/importlib.metadata.rst:248
msgid ""
"To get the full set of requirements for a distribution, use the "
"``requires()`` function::"
msgstr ""

#: library/importlib.metadata.rst:256
#, fuzzy
msgid "Package distributions"
msgstr "Distribution"

#: library/importlib.metadata.rst:258
msgid ""
"A convenience method to resolve the distribution or distributions (in the "
"case of a namespace package) for top-level Python packages or modules::"
msgstr ""

#: library/importlib.metadata.rst:270
#, fuzzy
msgid "Distributions"
msgstr "Distribution"

#: library/importlib.metadata.rst:272
msgid ""
"While the above API is the most common and convenient usage, you can get all "
"of that information from the ``Distribution`` class.  A ``Distribution`` is "
"an abstract object that represents the metadata for a Python package.  You "
"can get the ``Distribution`` instance::"
msgstr ""

#: library/importlib.metadata.rst:280
msgid ""
"Thus, an alternative way to get the version number is through the "
"``Distribution`` instance::"
msgstr ""

#: library/importlib.metadata.rst:286
msgid ""
"There are all kinds of additional metadata available on the ``Distribution`` "
"instance::"
msgstr ""

#: library/importlib.metadata.rst:294
msgid ""
"The full set of available metadata is not described here.  See :pep:`566` "
"for additional details."
msgstr ""

#: library/importlib.metadata.rst:299
msgid "Extending the search algorithm"
msgstr ""

#: library/importlib.metadata.rst:301
msgid ""
"Because package metadata is not available through :data:`sys.path` searches, "
"or package loaders directly, the metadata for a package is found through "
"import system :ref:`finders <finders-and-loaders>`.  To find a distribution "
"package's metadata, ``importlib.metadata`` queries the list of :term:`meta "
"path finders <meta path finder>` on :data:`sys.meta_path`."
msgstr ""

#: library/importlib.metadata.rst:307
msgid ""
"The default ``PathFinder`` for Python includes a hook that calls into "
"``importlib.metadata.MetadataPathFinder`` for finding distributions loaded "
"from typical file-system-based paths."
msgstr ""

#: library/importlib.metadata.rst:311
msgid ""
"The abstract class :py:class:`importlib.abc.MetaPathFinder` defines the "
"interface expected of finders by Python's import system. ``importlib."
"metadata`` extends this protocol by looking for an optional "
"``find_distributions`` callable on the finders from :data:`sys.meta_path` "
"and presents this extended interface as the ``DistributionFinder`` abstract "
"base class, which defines this abstract method::"
msgstr ""

#: library/importlib.metadata.rst:325
msgid ""
"The ``DistributionFinder.Context`` object provides ``.path`` and ``.name`` "
"properties indicating the path to search and name to match and may supply "
"other relevant context."
msgstr ""

#: library/importlib.metadata.rst:329
msgid ""
"What this means in practice is that to support finding distribution package "
"metadata in locations other than the file system, subclass ``Distribution`` "
"and implement the abstract methods. Then from a custom finder, return "
"instances of this derived ``Distribution`` in the ``find_distributions()`` "
"method."
msgstr ""

#~ msgid "Footnotes"
#~ msgstr "Notes"
