# 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: 2023-01-15 22:33+0100\n" "PO-Revision-Date: 2022-05-23 00:50+0200\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/importlib.resources.rst:2 msgid ":mod:`importlib.resources` -- Resources" msgstr "" #: library/importlib.resources.rst:7 msgid "**Source code:** :source:`Lib/importlib/resources/__init__.py`" msgstr "" #: library/importlib.resources.rst:13 msgid "" "This module leverages Python's import system to provide access to " "*resources* within *packages*. If you can import a package, you can access " "resources within that package. Resources can be opened or read, in either " "binary or text mode." msgstr "" #: library/importlib.resources.rst:18 msgid "" "Resources are roughly akin to files inside directories, though it's " "important to keep in mind that this is just a metaphor. Resources and " "packages **do not** have to exist as physical files and directories on the " "file system: for example, a package and its resources can be imported from a " "zip file using :py:mod:`zipimport`." msgstr "" #: library/importlib.resources.rst:26 msgid "" "This module provides functionality similar to `pkg_resources `_ `Basic Resource " "Access `_ without the performance overhead of that package. This " "makes reading resources included in packages easier, with more stable and " "consistent semantics." msgstr "" #: library/importlib.resources.rst:34 msgid "" "The standalone backport of this module provides more information on `using " "importlib.resources `_ and `migrating from pkg_resources to importlib.resources " "`_." msgstr "" #: library/importlib.resources.rst:40 msgid "" ":class:`Loaders ` that wish to support resource " "reading should implement a ``get_resource_reader(fullname)`` method as " "specified by :class:`importlib.resources.abc.ResourceReader`." msgstr "" #: library/importlib.resources.rst:46 msgid "" "Whenever a function accepts a ``Package`` argument, you can pass in either " "a :class:`module object ` or a module name as a string. " "You can only pass module objects whose ``__spec__." "submodule_search_locations`` is not ``None``." msgstr "" #: library/importlib.resources.rst:51 msgid "The ``Package`` type is defined as ``Union[str, ModuleType]``." msgstr "" #: library/importlib.resources.rst:55 msgid "" "Returns a :class:`~importlib.resources.abc.Traversable` object representing " "the resource container for the package (think directory) and its resources " "(think files). A Traversable may contain other containers (think " "subdirectories)." msgstr "" #: library/importlib.resources.rst:60 msgid "" "*package* is either a name or a module object which conforms to the :data:" "`Package` requirements." msgstr "" #: library/importlib.resources.rst:67 msgid "" "Given a :class:`~importlib.resources.abc.Traversable` object representing a " "file, typically from :func:`importlib.resources.files`, return a context " "manager for use in a :keyword:`with` statement. The context manager provides " "a :class:`pathlib.Path` object." msgstr "" #: library/importlib.resources.rst:72 msgid "" "Exiting the context manager cleans up any temporary file created when the " "resource was extracted from e.g. a zip file." msgstr "" #: library/importlib.resources.rst:75 msgid "" "Use ``as_file`` when the Traversable methods (``read_text``, etc) are " "insufficient and an actual file on the file system is required." msgstr "" #: library/importlib.resources.rst:82 msgid "Deprecated functions" msgstr "" #: library/importlib.resources.rst:84 msgid "" "An older, deprecated set of functions is still available, but is scheduled " "for removal in a future version of Python. The main drawback of these " "functions is that they do not support directories: they assume all resources " "are located directly within a *package*." msgstr "" #: library/importlib.resources.rst:91 msgid "" "For *resource* arguments of the functions below, you can pass in the name of " "a resource as a string or a :class:`path-like object `." msgstr "" #: library/importlib.resources.rst:95 msgid "The ``Resource`` type is defined as ``Union[str, os.PathLike]``." msgstr "" #: library/importlib.resources.rst:99 msgid "Open for binary reading the *resource* within *package*." msgstr "" #: library/importlib.resources.rst:101 msgid "" "*package* is either a name or a module object which conforms to the " "``Package`` requirements. *resource* is the name of the resource to open " "within *package*; it may not contain path separators and it may not have sub-" "resources (i.e. it cannot be a directory). This function returns a ``typing." "BinaryIO`` instance, a binary I/O stream open for reading." msgstr "" #: library/importlib.resources.rst:109 library/importlib.resources.rst:130 #: library/importlib.resources.rst:148 library/importlib.resources.rst:167 #: library/importlib.resources.rst:203 library/importlib.resources.rst:219 msgid "Calls to this function can be replaced by::" msgstr "" #: library/importlib.resources.rst:116 msgid "" "Open for text reading the *resource* within *package*. By default, the " "resource is opened for reading as UTF-8." msgstr "" #: library/importlib.resources.rst:119 msgid "" "*package* is either a name or a module object which conforms to the " "``Package`` requirements. *resource* is the name of the resource to open " "within *package*; it may not contain path separators and it may not have sub-" "resources (i.e. it cannot be a directory). *encoding* and *errors* have the " "same meaning as with built-in :func:`open`." msgstr "" #: library/importlib.resources.rst:125 msgid "" "This function returns a ``typing.TextIO`` instance, a text I/O stream open " "for reading." msgstr "" #: library/importlib.resources.rst:137 msgid "" "Read and return the contents of the *resource* within *package* as ``bytes``." msgstr "" #: library/importlib.resources.rst:140 msgid "" "*package* is either a name or a module object which conforms to the " "``Package`` requirements. *resource* is the name of the resource to open " "within *package*; it may not contain path separators and it may not have sub-" "resources (i.e. it cannot be a directory). This function returns the " "contents of the resource as :class:`bytes`." msgstr "" #: library/importlib.resources.rst:155 msgid "" "Read and return the contents of *resource* within *package* as a ``str``. By " "default, the contents are read as strict UTF-8." msgstr "" #: library/importlib.resources.rst:158 msgid "" "*package* is either a name or a module object which conforms to the " "``Package`` requirements. *resource* is the name of the resource to open " "within *package*; it may not contain path separators and it may not have sub-" "resources (i.e. it cannot be a directory). *encoding* and *errors* have the " "same meaning as with built-in :func:`open`. This function returns the " "contents of the resource as :class:`str`." msgstr "" #: library/importlib.resources.rst:174 msgid "" "Return the path to the *resource* as an actual file system path. This " "function returns a context manager for use in a :keyword:`with` statement. " "The context manager provides a :class:`pathlib.Path` object." msgstr "" #: library/importlib.resources.rst:178 msgid "" "Exiting the context manager cleans up any temporary file created when the " "resource needs to be extracted from e.g. a zip file." msgstr "" #: library/importlib.resources.rst:181 msgid "" "*package* is either a name or a module object which conforms to the " "``Package`` requirements. *resource* is the name of the resource to open " "within *package*; it may not contain path separators and it may not have sub-" "resources (i.e. it cannot be a directory)." msgstr "" #: library/importlib.resources.rst:188 msgid "Calls to this function can be replaced using :func:`as_file`::" msgstr "" #: library/importlib.resources.rst:195 msgid "" "Return ``True`` if there is a resource named *name* in the package, " "otherwise ``False``. This function does not consider directories to be " "resources. *package* is either a name or a module object which conforms to " "the ``Package`` requirements." msgstr "" #: library/importlib.resources.rst:210 msgid "" "Return an iterable over the named items within the package. The iterable " "returns :class:`str` resources (e.g. files) and non-resources (e.g. " "directories). The iterable does not recurse into subdirectories." msgstr "" #: library/importlib.resources.rst:214 msgid "" "*package* is either a name or a module object which conforms to the " "``Package`` requirements." msgstr ""