forked from AFPy/python-docs-fr
453 lines
15 KiB
Plaintext
453 lines
15 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
|
# Copyright (C) 2001-2022, 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 3.11\n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2022-03-23 18:39+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"
|
|
|
|
#: library/importlib.resources.abc.rst:3
|
|
msgid "*Superseded by TraversableResources*"
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:5
|
|
msgid ""
|
|
"An :term:`abstract base class` to provide the ability to read *resources*."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:8
|
|
msgid ""
|
|
"From the perspective of this ABC, a *resource* is a binary artifact that is "
|
|
"shipped within a package. Typically this is something like a data file that "
|
|
"lives next to the ``__init__.py`` file of the package. The purpose of this "
|
|
"class is to help abstract out the accessing of such data files so that it "
|
|
"does not matter if the package and its data file(s) are stored in a e.g. zip "
|
|
"file versus on the file system."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:16
|
|
msgid ""
|
|
"For any of methods of this class, a *resource* argument is expected to be a :"
|
|
"term:`path-like object` which represents conceptually just a file name. This "
|
|
"means that no subdirectory paths should be included in the *resource* "
|
|
"argument. This is because the location of the package the reader is for, "
|
|
"acts as the \"directory\". Hence the metaphor for directories and file names "
|
|
"is packages and resources, respectively. This is also why instances of this "
|
|
"class are expected to directly correlate to a specific package (instead of "
|
|
"potentially representing multiple packages or a module)."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:27
|
|
msgid ""
|
|
"Loaders that wish to support resource reading are expected to provide a "
|
|
"method called ``get_resource_reader(fullname)`` which returns an object "
|
|
"implementing this ABC's interface. If the module specified by fullname is "
|
|
"not a package, this method should return :const:`None`. An object compatible "
|
|
"with this ABC should only be returned when the specified module is a package."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:38
|
|
msgid ""
|
|
"Returns an opened, :term:`file-like object` for binary reading of the "
|
|
"*resource*."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:41
|
|
msgid "If the resource cannot be found, :exc:`FileNotFoundError` is raised."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:46
|
|
msgid "Returns the file system path to the *resource*."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:48
|
|
msgid ""
|
|
"If the resource does not concretely exist on the file system, raise :exc:"
|
|
"`FileNotFoundError`."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:53
|
|
msgid ""
|
|
"Returns ``True`` if the named *name* is considered a resource. :exc:"
|
|
"`FileNotFoundError` is raised if *name* does not exist."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:58
|
|
msgid ""
|
|
"Returns an :term:`iterable` of strings over the contents of the package. Do "
|
|
"note that it is not required that all names returned by the iterator be "
|
|
"actual resources, e.g. it is acceptable to return names for which :meth:"
|
|
"`is_resource` would be false."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:64
|
|
msgid ""
|
|
"Allowing non-resource names to be returned is to allow for situations where "
|
|
"how a package and its resources are stored are known a priori and the non-"
|
|
"resource names would be useful. For instance, returning subdirectory names "
|
|
"is allowed so that when it is known that the package and resources are "
|
|
"stored on the file system then those subdirectory names can be used directly."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:72
|
|
msgid "The abstract method returns an iterable of no items."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:77
|
|
msgid ""
|
|
"An abstract base class for a :term:`loader` which implements the optional :"
|
|
"pep:`302` protocol for loading arbitrary resources from the storage back-end."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:81
|
|
msgid ""
|
|
"This ABC is deprecated in favour of supporting resource loading through :"
|
|
"class:`importlib.abc.ResourceReader`."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:87
|
|
msgid ""
|
|
"An abstract method to return the bytes for the data located at *path*. "
|
|
"Loaders that have a file-like storage back-end that allows storing arbitrary "
|
|
"data can implement this abstract method to give direct access to the data "
|
|
"stored. :exc:`OSError` is to be raised if the *path* cannot be found. The "
|
|
"*path* is expected to be constructed using a module's :attr:`__file__` "
|
|
"attribute or an item from a package's :attr:`__path__`."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:95
|
|
msgid "Raises :exc:`OSError` instead of :exc:`NotImplementedError`."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:101
|
|
msgid ""
|
|
"An abstract base class for a :term:`loader` which implements the optional :"
|
|
"pep:`302` protocol for loaders that inspect modules."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:106
|
|
msgid ""
|
|
"Return the code object for a module, or ``None`` if the module does not have "
|
|
"a code object (as would be the case, for example, for a built-in module). "
|
|
"Raise an :exc:`ImportError` if loader cannot find the requested module."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:112
|
|
msgid ""
|
|
"While the method has a default implementation, it is suggested that it be "
|
|
"overridden if possible for performance."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:118
|
|
msgid "No longer abstract and a concrete implementation is provided."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:123
|
|
msgid ""
|
|
"An abstract method to return the source of a module. It is returned as a "
|
|
"text string using :term:`universal newlines`, translating all recognized "
|
|
"line separators into ``'\\n'`` characters. Returns ``None`` if no source is "
|
|
"available (e.g. a built-in module). Raises :exc:`ImportError` if the loader "
|
|
"cannot find the module specified."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:129
|
|
#: library/importlib.resources.abc.rst:138
|
|
#: library/importlib.resources.abc.rst:188
|
|
msgid "Raises :exc:`ImportError` instead of :exc:`NotImplementedError`."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:134
|
|
msgid ""
|
|
"An optional method to return a true value if the module is a package, a "
|
|
"false value otherwise. :exc:`ImportError` is raised if the :term:`loader` "
|
|
"cannot find the module."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:143
|
|
msgid "Create a code object from Python source."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:145
|
|
msgid ""
|
|
"The *data* argument can be whatever the :func:`compile` function supports (i."
|
|
"e. string or bytes). The *path* argument should be the \"path\" to where the "
|
|
"source code originated from, which can be an abstract concept (e.g. location "
|
|
"in a zip file)."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:150
|
|
msgid ""
|
|
"With the subsequent code object one can execute it in a module by running "
|
|
"``exec(code, module.__dict__)``."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:155
|
|
msgid "Made the method static."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:160
|
|
msgid "Implementation of :meth:`Loader.exec_module`."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:166
|
|
msgid "Implementation of :meth:`Loader.load_module`."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:168
|
|
msgid "use :meth:`exec_module` instead."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:174
|
|
msgid ""
|
|
"An abstract base class which inherits from :class:`InspectLoader` that, when "
|
|
"implemented, helps a module to be executed as a script. The ABC represents "
|
|
"an optional :pep:`302` protocol."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:180
|
|
msgid ""
|
|
"An abstract method that is to return the value of :attr:`__file__` for the "
|
|
"specified module. If no path is available, :exc:`ImportError` is raised."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:184
|
|
msgid ""
|
|
"If source code is available, then the method should return the path to the "
|
|
"source file, regardless of whether a bytecode was used to load the module."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:194
|
|
msgid ""
|
|
"An abstract base class which inherits from :class:`ResourceLoader` and :"
|
|
"class:`ExecutionLoader`, providing concrete implementations of :meth:"
|
|
"`ResourceLoader.get_data` and :meth:`ExecutionLoader.get_filename`."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:198
|
|
msgid ""
|
|
"The *fullname* argument is a fully resolved name of the module the loader is "
|
|
"to handle. The *path* argument is the path to the file for the module."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:205
|
|
msgid "The name of the module the loader can handle."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:209
|
|
msgid "Path to the file of the module."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:213
|
|
msgid "Calls super's ``load_module()``."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:215
|
|
msgid "Use :meth:`Loader.exec_module` instead."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:220
|
|
msgid "Returns :attr:`path`."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:224
|
|
msgid "Reads *path* as a binary file and returns the bytes from it."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:229
|
|
msgid ""
|
|
"An abstract base class for implementing source (and optionally bytecode) "
|
|
"file loading. The class inherits from both :class:`ResourceLoader` and :"
|
|
"class:`ExecutionLoader`, requiring the implementation of:"
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:233
|
|
msgid ":meth:`ResourceLoader.get_data`"
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:236
|
|
msgid ":meth:`ExecutionLoader.get_filename`"
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:235
|
|
msgid ""
|
|
"Should only return the path to the source file; sourceless loading is not "
|
|
"supported."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:238
|
|
msgid ""
|
|
"The abstract methods defined by this class are to add optional bytecode file "
|
|
"support. Not implementing these optional methods (or causing them to raise :"
|
|
"exc:`NotImplementedError`) causes the loader to only work with source code. "
|
|
"Implementing the methods allows the loader to work with source *and* "
|
|
"bytecode files; it does not allow for *sourceless* loading where only "
|
|
"bytecode is provided. Bytecode files are an optimization to speed up "
|
|
"loading by removing the parsing step of Python's compiler, and so no "
|
|
"bytecode-specific API is exposed."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:249
|
|
msgid ""
|
|
"Optional abstract method which returns a :class:`dict` containing metadata "
|
|
"about the specified path. Supported dictionary keys are:"
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:252
|
|
msgid ""
|
|
"``'mtime'`` (mandatory): an integer or floating-point number representing "
|
|
"the modification time of the source code;"
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:254
|
|
msgid "``'size'`` (optional): the size in bytes of the source code."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:256
|
|
msgid ""
|
|
"Any other keys in the dictionary are ignored, to allow for future "
|
|
"extensions. If the path cannot be handled, :exc:`OSError` is raised."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:261
|
|
#: library/importlib.resources.abc.rst:274
|
|
msgid "Raise :exc:`OSError` instead of :exc:`NotImplementedError`."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:266
|
|
msgid ""
|
|
"Optional abstract method which returns the modification time for the "
|
|
"specified path."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:269
|
|
msgid ""
|
|
"This method is deprecated in favour of :meth:`path_stats`. You don't have "
|
|
"to implement it, but it is still available for compatibility purposes. "
|
|
"Raise :exc:`OSError` if the path cannot be handled."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:279
|
|
msgid ""
|
|
"Optional abstract method which writes the specified bytes to a file path. "
|
|
"Any intermediate directories which do not exist are to be created "
|
|
"automatically."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:283
|
|
msgid ""
|
|
"When writing to the path fails because the path is read-only (:attr:`errno."
|
|
"EACCES`/:exc:`PermissionError`), do not propagate the exception."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:287
|
|
msgid "No longer raises :exc:`NotImplementedError` when called."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:292
|
|
msgid "Concrete implementation of :meth:`InspectLoader.get_code`."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:296
|
|
msgid "Concrete implementation of :meth:`Loader.exec_module`."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:302
|
|
msgid "Concrete implementation of :meth:`Loader.load_module`."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:304
|
|
msgid "Use :meth:`exec_module` instead."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:309
|
|
msgid "Concrete implementation of :meth:`InspectLoader.get_source`."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:313
|
|
msgid ""
|
|
"Concrete implementation of :meth:`InspectLoader.is_package`. A module is "
|
|
"determined to be a package if its file path (as provided by :meth:"
|
|
"`ExecutionLoader.get_filename`) is a file named ``__init__`` when the file "
|
|
"extension is removed **and** the module name itself does not end in "
|
|
"``__init__``."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:322
|
|
msgid ""
|
|
"An object with a subset of pathlib.Path methods suitable for traversing "
|
|
"directories and opening files."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:329
|
|
msgid "Abstract. The base name of this object without any parent references."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:333
|
|
msgid "Yield Traversable objects in self."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:337
|
|
msgid "Return True if self is a directory."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:341
|
|
msgid "Return True if self is a file."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:345
|
|
#: library/importlib.resources.abc.rst:349
|
|
msgid "Return Traversable child in self."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:353
|
|
msgid ""
|
|
"*mode* may be 'r' or 'rb' to open as text or binary. Return a handle "
|
|
"suitable for reading (same as :attr:`pathlib.Path.open`)."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:356
|
|
msgid ""
|
|
"When opening as text, accepts encoding parameters such as those accepted by :"
|
|
"attr:`io.TextIOWrapper`."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:361
|
|
msgid "Read contents of self as bytes."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:365
|
|
msgid "Read contents of self as text."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:370
|
|
msgid ""
|
|
"An abstract base class for resource readers capable of serving the :meth:"
|
|
"`importlib.resources.files` interface. Subclasses :class:`importlib.abc."
|
|
"ResourceReader` and provides concrete implementations of the :class:"
|
|
"`importlib.abc.ResourceReader`'s abstract methods. Therefore, any loader "
|
|
"supplying :class:`importlib.abc.TraversableReader` also supplies "
|
|
"ResourceReader."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:377
|
|
msgid ""
|
|
"Loaders that wish to support resource reading are expected to implement this "
|
|
"interface."
|
|
msgstr ""
|
|
|
|
#: library/importlib.resources.abc.rst:384
|
|
msgid ""
|
|
"Returns a :class:`importlib.abc.Traversable` object for the loaded package."
|
|
msgstr ""
|