python-docs-fr/library/tarfile.po

1090 lines
33 KiB
Plaintext
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2016, 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.5\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2016-10-30 10:42+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"
#: ../Doc/library/tarfile.rst:2
msgid ":mod:`tarfile` --- Read and write tar archive files"
msgstr ""
#: ../Doc/library/tarfile.rst:10
msgid "**Source code:** :source:`Lib/tarfile.py`"
msgstr "**Code source :** :source:`Lib/tarfile.py`"
#: ../Doc/library/tarfile.rst:14
msgid ""
"The :mod:`tarfile` module makes it possible to read and write tar archives, "
"including those using gzip, bz2 and lzma compression. Use the :mod:`zipfile` "
"module to read or write :file:`.zip` files, or the higher-level functions "
"in :ref:`shutil <archiving-operations>`."
msgstr ""
#: ../Doc/library/tarfile.rst:19
msgid "Some facts and figures:"
msgstr ""
#: ../Doc/library/tarfile.rst:21
msgid ""
"reads and writes :mod:`gzip`, :mod:`bz2` and :mod:`lzma` compressed archives "
"if the respective modules are available."
msgstr ""
#: ../Doc/library/tarfile.rst:24
msgid "read/write support for the POSIX.1-1988 (ustar) format."
msgstr ""
#: ../Doc/library/tarfile.rst:26
msgid ""
"read/write support for the GNU tar format including *longname* and "
"*longlink* extensions, read-only support for all variants of the *sparse* "
"extension including restoration of sparse files."
msgstr ""
#: ../Doc/library/tarfile.rst:30
msgid "read/write support for the POSIX.1-2001 (pax) format."
msgstr ""
#: ../Doc/library/tarfile.rst:32
msgid ""
"handles directories, regular files, hardlinks, symbolic links, fifos, "
"character devices and block devices and is able to acquire and restore file "
"information like timestamp, access permissions and owner."
msgstr ""
#: ../Doc/library/tarfile.rst:36
msgid "Added support for :mod:`lzma` compression."
msgstr ""
#: ../Doc/library/tarfile.rst:42
msgid ""
"Return a :class:`TarFile` object for the pathname *name*. For detailed "
"information on :class:`TarFile` objects and the keyword arguments that are "
"allowed, see :ref:`tarfile-objects`."
msgstr ""
#: ../Doc/library/tarfile.rst:46
msgid ""
"*mode* has to be a string of the form ``'filemode[:compression]'``, it "
"defaults to ``'r'``. Here is a full list of mode combinations:"
msgstr ""
#: ../Doc/library/tarfile.rst:50
msgid "mode"
msgstr ""
#: ../Doc/library/tarfile.rst:50
msgid "action"
msgstr "action"
#: ../Doc/library/tarfile.rst:52
msgid "``'r' or 'r:*'``"
msgstr "``'r' ou 'r:*'``"
#: ../Doc/library/tarfile.rst:52
msgid "Open for reading with transparent compression (recommended)."
msgstr ""
#: ../Doc/library/tarfile.rst:55
msgid "``'r:'``"
msgstr "``'r:'``"
#: ../Doc/library/tarfile.rst:55
msgid "Open for reading exclusively without compression."
msgstr ""
#: ../Doc/library/tarfile.rst:58
msgid "``'r:gz'``"
msgstr "``'r:gz'``"
#: ../Doc/library/tarfile.rst:58
msgid "Open for reading with gzip compression."
msgstr ""
#: ../Doc/library/tarfile.rst:60
msgid "``'r:bz2'``"
msgstr "``'r:bz2'``"
#: ../Doc/library/tarfile.rst:60
msgid "Open for reading with bzip2 compression."
msgstr ""
#: ../Doc/library/tarfile.rst:62
msgid "``'r:xz'``"
msgstr "``'r:xz'``"
#: ../Doc/library/tarfile.rst:62
msgid "Open for reading with lzma compression."
msgstr ""
#: ../Doc/library/tarfile.rst:64
msgid "``'x'`` or ``'x:'``"
msgstr "``'x'`` ou ``'x:'``"
#: ../Doc/library/tarfile.rst:64
msgid ""
"Create a tarfile exclusively without compression. Raise an :exc:"
"`FileExistsError` exception if it already exists."
msgstr ""
#: ../Doc/library/tarfile.rst:69
msgid "``'x:gz'``"
msgstr "``'x:gz'``"
#: ../Doc/library/tarfile.rst:69
msgid ""
"Create a tarfile with gzip compression. Raise an :exc:`FileExistsError` "
"exception if it already exists."
msgstr ""
#: ../Doc/library/tarfile.rst:73
msgid "``'x:bz2'``"
msgstr "``'x:bz2'``"
#: ../Doc/library/tarfile.rst:73
msgid ""
"Create a tarfile with bzip2 compression. Raise an :exc:`FileExistsError` "
"exception if it already exists."
msgstr ""
#: ../Doc/library/tarfile.rst:77
msgid "``'x:xz'``"
msgstr "``'x:xz'``"
#: ../Doc/library/tarfile.rst:77
msgid ""
"Create a tarfile with lzma compression. Raise an :exc:`FileExistsError` "
"exception if it already exists."
msgstr ""
#: ../Doc/library/tarfile.rst:81
msgid "``'a' or 'a:'``"
msgstr "``'a' ou 'a:'``"
#: ../Doc/library/tarfile.rst:81
msgid ""
"Open for appending with no compression. The file is created if it does not "
"exist."
msgstr ""
#: ../Doc/library/tarfile.rst:84
msgid "``'w' or 'w:'``"
msgstr "``'w' ou 'w:'``"
#: ../Doc/library/tarfile.rst:84
msgid "Open for uncompressed writing."
msgstr ""
#: ../Doc/library/tarfile.rst:86
msgid "``'w:gz'``"
msgstr "``'w:gz'``"
#: ../Doc/library/tarfile.rst:86
msgid "Open for gzip compressed writing."
msgstr ""
#: ../Doc/library/tarfile.rst:88
msgid "``'w:bz2'``"
msgstr "``'w:bz2'``"
#: ../Doc/library/tarfile.rst:88
msgid "Open for bzip2 compressed writing."
msgstr ""
#: ../Doc/library/tarfile.rst:90
msgid "``'w:xz'``"
msgstr "``'w:xz'``"
#: ../Doc/library/tarfile.rst:90
msgid "Open for lzma compressed writing."
msgstr ""
#: ../Doc/library/tarfile.rst:93
msgid ""
"Note that ``'a:gz'``, ``'a:bz2'`` or ``'a:xz'`` is not possible. If *mode* "
"is not suitable to open a certain (compressed) file for reading, :exc:"
"`ReadError` is raised. Use *mode* ``'r'`` to avoid this. If a compression "
"method is not supported, :exc:`CompressionError` is raised."
msgstr ""
#: ../Doc/library/tarfile.rst:98
msgid ""
"If *fileobj* is specified, it is used as an alternative to a :term:`file "
"object` opened in binary mode for *name*. It is supposed to be at position 0."
msgstr ""
#: ../Doc/library/tarfile.rst:101
msgid ""
"For modes ``'w:gz'``, ``'r:gz'``, ``'w:bz2'``, ``'r:bz2'``, ``'x:gz'``, ``'x:"
"bz2'``, :func:`tarfile.open` accepts the keyword argument *compresslevel* "
"(default ``9``) to specify the compression level of the file."
msgstr ""
#: ../Doc/library/tarfile.rst:105
msgid ""
"For special purposes, there is a second format for *mode*: ``'filemode|"
"[compression]'``. :func:`tarfile.open` will return a :class:`TarFile` "
"object that processes its data as a stream of blocks. No random seeking "
"will be done on the file. If given, *fileobj* may be any object that has a :"
"meth:`read` or :meth:`write` method (depending on the *mode*). *bufsize* "
"specifies the blocksize and defaults to ``20 * 512`` bytes. Use this variant "
"in combination with e.g. ``sys.stdin``, a socket :term:`file object` or a "
"tape device. However, such a :class:`TarFile` object is limited in that it "
"does not allow random access, see :ref:`tar-examples`. The currently "
"possible modes:"
msgstr ""
#: ../Doc/library/tarfile.rst:117
msgid "Mode"
msgstr ""
#: ../Doc/library/tarfile.rst:117
msgid "Action"
msgstr ""
#: ../Doc/library/tarfile.rst:119
msgid "``'r|*'``"
msgstr "``'r|*'``"
#: ../Doc/library/tarfile.rst:119
msgid "Open a *stream* of tar blocks for reading with transparent compression."
msgstr ""
#: ../Doc/library/tarfile.rst:122
msgid "``'r|'``"
msgstr "``'r|'``"
#: ../Doc/library/tarfile.rst:122
msgid "Open a *stream* of uncompressed tar blocks for reading."
msgstr ""
#: ../Doc/library/tarfile.rst:125
msgid "``'r|gz'``"
msgstr "``'r|gz'``"
#: ../Doc/library/tarfile.rst:125
msgid "Open a gzip compressed *stream* for reading."
msgstr ""
#: ../Doc/library/tarfile.rst:128
msgid "``'r|bz2'``"
msgstr "``'r|bz2'``"
#: ../Doc/library/tarfile.rst:128
msgid "Open a bzip2 compressed *stream* for reading."
msgstr ""
#: ../Doc/library/tarfile.rst:131
msgid "``'r|xz'``"
msgstr "``'r|xz'``"
#: ../Doc/library/tarfile.rst:131
msgid "Open an lzma compressed *stream* for reading."
msgstr ""
#: ../Doc/library/tarfile.rst:134
msgid "``'w|'``"
msgstr "``'w|'``"
#: ../Doc/library/tarfile.rst:134
msgid "Open an uncompressed *stream* for writing."
msgstr ""
#: ../Doc/library/tarfile.rst:136
msgid "``'w|gz'``"
msgstr "``'w|gz'``"
#: ../Doc/library/tarfile.rst:136
msgid "Open a gzip compressed *stream* for writing."
msgstr ""
#: ../Doc/library/tarfile.rst:139
msgid "``'w|bz2'``"
msgstr "``'w|bz2'``"
#: ../Doc/library/tarfile.rst:139
msgid "Open a bzip2 compressed *stream* for writing."
msgstr ""
#: ../Doc/library/tarfile.rst:142
msgid "``'w|xz'``"
msgstr "``'w|xz'``"
#: ../Doc/library/tarfile.rst:142
msgid "Open an lzma compressed *stream* for writing."
msgstr ""
#: ../Doc/library/tarfile.rst:146 ../Doc/library/tarfile.rst:319
msgid "The ``'x'`` (exclusive creation) mode was added."
msgstr "Le mode ``'x'`` (création exclusive) est créé."
#: ../Doc/library/tarfile.rst:151
msgid ""
"Class for reading and writing tar archives. Do not use this class directly: "
"use :func:`tarfile.open` instead. See :ref:`tarfile-objects`."
msgstr ""
#: ../Doc/library/tarfile.rst:157
msgid ""
"Return :const:`True` if *name* is a tar archive file, that the :mod:"
"`tarfile` module can read."
msgstr ""
#: ../Doc/library/tarfile.rst:161
msgid "The :mod:`tarfile` module defines the following exceptions:"
msgstr ""
#: ../Doc/library/tarfile.rst:166
msgid "Base class for all :mod:`tarfile` exceptions."
msgstr ""
#: ../Doc/library/tarfile.rst:171
msgid ""
"Is raised when a tar archive is opened, that either cannot be handled by "
"the :mod:`tarfile` module or is somehow invalid."
msgstr ""
#: ../Doc/library/tarfile.rst:177
msgid ""
"Is raised when a compression method is not supported or when the data cannot "
"be decoded properly."
msgstr ""
#: ../Doc/library/tarfile.rst:183
msgid ""
"Is raised for the limitations that are typical for stream-like :class:"
"`TarFile` objects."
msgstr ""
#: ../Doc/library/tarfile.rst:189
msgid ""
"Is raised for *non-fatal* errors when using :meth:`TarFile.extract`, but "
"only if :attr:`TarFile.errorlevel`\\ ``== 2``."
msgstr ""
#: ../Doc/library/tarfile.rst:195
msgid "Is raised by :meth:`TarInfo.frombuf` if the buffer it gets is invalid."
msgstr ""
#: ../Doc/library/tarfile.rst:198
msgid "The following constants are available at the module level:"
msgstr ""
#: ../Doc/library/tarfile.rst:202
msgid ""
"The default character encoding: ``'utf-8'`` on Windows, the value returned "
"by :func:`sys.getfilesystemencoding` otherwise."
msgstr ""
#: ../Doc/library/tarfile.rst:206
msgid ""
"Each of the following constants defines a tar archive format that the :mod:"
"`tarfile` module is able to create. See section :ref:`tar-formats` for "
"details."
msgstr ""
#: ../Doc/library/tarfile.rst:213
msgid "POSIX.1-1988 (ustar) format."
msgstr ""
#: ../Doc/library/tarfile.rst:218
msgid "GNU tar format."
msgstr ""
#: ../Doc/library/tarfile.rst:223
msgid "POSIX.1-2001 (pax) format."
msgstr ""
#: ../Doc/library/tarfile.rst:228
msgid ""
"The default format for creating archives. This is currently :const:"
"`GNU_FORMAT`."
msgstr ""
#: ../Doc/library/tarfile.rst:234
msgid "Module :mod:`zipfile`"
msgstr ""
#: ../Doc/library/tarfile.rst:234
msgid "Documentation of the :mod:`zipfile` standard module."
msgstr ""
#: ../Doc/library/tarfile.rst:238
msgid ":ref:`archiving-operations`"
msgstr ""
#: ../Doc/library/tarfile.rst:237
msgid ""
"Documentation of the higher-level archiving facilities provided by the "
"standard :mod:`shutil` module."
msgstr ""
#: ../Doc/library/tarfile.rst:240
msgid ""
"`GNU tar manual, Basic Tar Format <https://www.gnu.org/software/tar/manual/"
"html_node/Standard.html>`_"
msgstr ""
#: ../Doc/library/tarfile.rst:241
msgid "Documentation for tar archive files, including GNU tar extensions."
msgstr ""
#: ../Doc/library/tarfile.rst:247
msgid "TarFile Objects"
msgstr ""
#: ../Doc/library/tarfile.rst:249
msgid ""
"The :class:`TarFile` object provides an interface to a tar archive. A tar "
"archive is a sequence of blocks. An archive member (a stored file) is made "
"up of a header block followed by data blocks. It is possible to store a file "
"in a tar archive several times. Each archive member is represented by a :"
"class:`TarInfo` object, see :ref:`tarinfo-objects` for details."
msgstr ""
#: ../Doc/library/tarfile.rst:255
msgid ""
"A :class:`TarFile` object can be used as a context manager in a :keyword:"
"`with` statement. It will automatically be closed when the block is "
"completed. Please note that in the event of an exception an archive opened "
"for writing will not be finalized; only the internally used file object will "
"be closed. See the :ref:`tar-examples` section for a use case."
msgstr ""
#: ../Doc/library/tarfile.rst:261
msgid "Added support for the context management protocol."
msgstr ""
#: ../Doc/library/tarfile.rst:266
msgid ""
"All following arguments are optional and can be accessed as instance "
"attributes as well."
msgstr ""
#: ../Doc/library/tarfile.rst:269
msgid ""
"*name* is the pathname of the archive. It can be omitted if *fileobj* is "
"given. In this case, the file object's :attr:`name` attribute is used if it "
"exists."
msgstr ""
#: ../Doc/library/tarfile.rst:272
msgid ""
"*mode* is either ``'r'`` to read from an existing archive, ``'a'`` to append "
"data to an existing file, ``'w'`` to create a new file overwriting an "
"existing one, or ``'x'`` to create a new file only if it does not already "
"exist."
msgstr ""
#: ../Doc/library/tarfile.rst:276
msgid ""
"If *fileobj* is given, it is used for reading or writing data. If it can be "
"determined, *mode* is overridden by *fileobj*'s mode. *fileobj* will be used "
"from position 0."
msgstr ""
#: ../Doc/library/tarfile.rst:282
msgid "*fileobj* is not closed, when :class:`TarFile` is closed."
msgstr ""
#: ../Doc/library/tarfile.rst:284
msgid ""
"*format* controls the archive format. It must be one of the constants :const:"
"`USTAR_FORMAT`, :const:`GNU_FORMAT` or :const:`PAX_FORMAT` that are defined "
"at module level."
msgstr ""
#: ../Doc/library/tarfile.rst:288
msgid ""
"The *tarinfo* argument can be used to replace the default :class:`TarInfo` "
"class with a different one."
msgstr ""
#: ../Doc/library/tarfile.rst:291
msgid ""
"If *dereference* is :const:`False`, add symbolic and hard links to the "
"archive. If it is :const:`True`, add the content of the target files to the "
"archive. This has no effect on systems that do not support symbolic links."
msgstr ""
#: ../Doc/library/tarfile.rst:295
msgid ""
"If *ignore_zeros* is :const:`False`, treat an empty block as the end of the "
"archive. If it is :const:`True`, skip empty (and invalid) blocks and try to "
"get as many members as possible. This is only useful for reading "
"concatenated or damaged archives."
msgstr ""
#: ../Doc/library/tarfile.rst:299
msgid ""
"*debug* can be set from ``0`` (no debug messages) up to ``3`` (all debug "
"messages). The messages are written to ``sys.stderr``."
msgstr ""
#: ../Doc/library/tarfile.rst:302
msgid ""
"If *errorlevel* is ``0``, all errors are ignored when using :meth:`TarFile."
"extract`. Nevertheless, they appear as error messages in the debug output, "
"when debugging is enabled. If ``1``, all *fatal* errors are raised as :exc:"
"`OSError` exceptions. If ``2``, all *non-fatal* errors are raised as :exc:"
"`TarError` exceptions as well."
msgstr ""
#: ../Doc/library/tarfile.rst:308
msgid ""
"The *encoding* and *errors* arguments define the character encoding to be "
"used for reading or writing the archive and how conversion errors are going "
"to be handled. The default settings will work for most users. See section :"
"ref:`tar-unicode` for in-depth information."
msgstr ""
#: ../Doc/library/tarfile.rst:313
msgid ""
"The *pax_headers* argument is an optional dictionary of strings which will "
"be added as a pax global header if *format* is :const:`PAX_FORMAT`."
msgstr ""
#: ../Doc/library/tarfile.rst:316 ../Doc/library/tarfile.rst:531
msgid "Use ``'surrogateescape'`` as the default for the *errors* argument."
msgstr ""
#: ../Doc/library/tarfile.rst:324
msgid ""
"Alternative constructor. The :func:`tarfile.open` function is actually a "
"shortcut to this classmethod."
msgstr ""
#: ../Doc/library/tarfile.rst:330
msgid ""
"Return a :class:`TarInfo` object for member *name*. If *name* can not be "
"found in the archive, :exc:`KeyError` is raised."
msgstr ""
#: ../Doc/library/tarfile.rst:335
msgid ""
"If a member occurs more than once in the archive, its last occurrence is "
"assumed to be the most up-to-date version."
msgstr ""
#: ../Doc/library/tarfile.rst:341
msgid ""
"Return the members of the archive as a list of :class:`TarInfo` objects. The "
"list has the same order as the members in the archive."
msgstr ""
#: ../Doc/library/tarfile.rst:347
msgid ""
"Return the members as a list of their names. It has the same order as the "
"list returned by :meth:`getmembers`."
msgstr ""
#: ../Doc/library/tarfile.rst:353
msgid ""
"Print a table of contents to ``sys.stdout``. If *verbose* is :const:`False`, "
"only the names of the members are printed. If it is :const:`True`, output "
"similar to that of :program:`ls -l` is produced. If optional *members* is "
"given, it must be a subset of the list returned by :meth:`getmembers`."
msgstr ""
#: ../Doc/library/tarfile.rst:358
msgid "Added the *members* parameter."
msgstr ""
#: ../Doc/library/tarfile.rst:364
msgid ""
"Return the next member of the archive as a :class:`TarInfo` object, when :"
"class:`TarFile` is opened for reading. Return :const:`None` if there is no "
"more available."
msgstr ""
#: ../Doc/library/tarfile.rst:371
msgid ""
"Extract all members from the archive to the current working directory or "
"directory *path*. If optional *members* is given, it must be a subset of the "
"list returned by :meth:`getmembers`. Directory information like owner, "
"modification time and permissions are set after all members have been "
"extracted. This is done to work around two problems: A directory's "
"modification time is reset each time a file is created in it. And, if a "
"directory's permissions do not allow writing, extracting files to it will "
"fail."
msgstr ""
#: ../Doc/library/tarfile.rst:379 ../Doc/library/tarfile.rst:402
msgid ""
"If *numeric_owner* is :const:`True`, the uid and gid numbers from the "
"tarfile are used to set the owner/group for the extracted files. Otherwise, "
"the named values from the tarfile are used."
msgstr ""
#: ../Doc/library/tarfile.rst:385
msgid ""
"Never extract archives from untrusted sources without prior inspection. It "
"is possible that files are created outside of *path*, e.g. members that have "
"absolute filenames starting with ``\"/\"`` or filenames with two dots ``\".."
"\"``."
msgstr ""
#: ../Doc/library/tarfile.rst:390 ../Doc/library/tarfile.rst:418
msgid "Added the *numeric_only* parameter."
msgstr ""
#: ../Doc/library/tarfile.rst:396
msgid ""
"Extract a member from the archive to the current working directory, using "
"its full name. Its file information is extracted as accurately as possible. "
"*member* may be a filename or a :class:`TarInfo` object. You can specify a "
"different directory using *path*. File attributes (owner, mtime, mode) are "
"set unless *set_attrs* is false."
msgstr ""
#: ../Doc/library/tarfile.rst:408
msgid ""
"The :meth:`extract` method does not take care of several extraction issues. "
"In most cases you should consider using the :meth:`extractall` method."
msgstr ""
#: ../Doc/library/tarfile.rst:413
msgid "See the warning for :meth:`extractall`."
msgstr ""
#: ../Doc/library/tarfile.rst:415
msgid "Added the *set_attrs* parameter."
msgstr ""
#: ../Doc/library/tarfile.rst:423
msgid ""
"Extract a member from the archive as a file object. *member* may be a "
"filename or a :class:`TarInfo` object. If *member* is a regular file or a "
"link, an :class:`io.BufferedReader` object is returned. Otherwise, :const:"
"`None` is returned."
msgstr ""
#: ../Doc/library/tarfile.rst:428
msgid "Return an :class:`io.BufferedReader` object."
msgstr ""
#: ../Doc/library/tarfile.rst:434
msgid ""
"Add the file *name* to the archive. *name* may be any type of file "
"(directory, fifo, symbolic link, etc.). If given, *arcname* specifies an "
"alternative name for the file in the archive. Directories are added "
"recursively by default. This can be avoided by setting *recursive* to :const:"
"`False`. If *exclude* is given, it must be a function that takes one "
"filename argument and returns a boolean value. Depending on this value the "
"respective file is either excluded (:const:`True`) or added (:const:"
"`False`). If *filter* is specified it must be a keyword argument. It should "
"be a function that takes a :class:`TarInfo` object argument and returns the "
"changed :class:`TarInfo` object. If it instead returns :const:`None` the :"
"class:`TarInfo` object will be excluded from the archive. See :ref:`tar-"
"examples` for an example."
msgstr ""
#: ../Doc/library/tarfile.rst:447
msgid "Added the *filter* parameter."
msgstr ""
#: ../Doc/library/tarfile.rst:450
msgid ""
"The *exclude* parameter is deprecated, please use the *filter* parameter "
"instead."
msgstr ""
#: ../Doc/library/tarfile.rst:457
msgid ""
"Add the :class:`TarInfo` object *tarinfo* to the archive. If *fileobj* is "
"given, it should be a :term:`binary file`, and ``tarinfo.size`` bytes are "
"read from it and added to the archive. You can create :class:`TarInfo` "
"objects directly, or by using :meth:`gettarinfo`."
msgstr ""
#: ../Doc/library/tarfile.rst:465
msgid ""
"Create a :class:`TarInfo` object from the result of :func:`os.stat` or "
"equivalent on an existing file. The file is either named by *name*, or "
"specified as a :term:`file object` *fileobj* with a file descriptor. If "
"given, *arcname* specifies an alternative name for the file in the archive, "
"otherwise, the name is taken from *fileobj*s :attr:`~io.FileIO.name` "
"attribute, or the *name* argument. The name should be a text string."
msgstr ""
#: ../Doc/library/tarfile.rst:473
msgid ""
"You can modify some of the :class:`TarInfo`s attributes before you add it "
"using :meth:`addfile`. If the file object is not an ordinary file object "
"positioned at the beginning of the file, attributes such as :attr:`~TarInfo."
"size` may need modifying. This is the case for objects such as :class:"
"`~gzip.GzipFile`. The :attr:`~TarInfo.name` may also be modified, in which "
"case *arcname* could be a dummy string."
msgstr ""
#: ../Doc/library/tarfile.rst:484
msgid ""
"Close the :class:`TarFile`. In write mode, two finishing zero blocks are "
"appended to the archive."
msgstr ""
#: ../Doc/library/tarfile.rst:490
msgid "A dictionary containing key-value pairs of pax global headers."
msgstr ""
#: ../Doc/library/tarfile.rst:497
msgid "TarInfo Objects"
msgstr ""
#: ../Doc/library/tarfile.rst:499
msgid ""
"A :class:`TarInfo` object represents one member in a :class:`TarFile`. Aside "
"from storing all required attributes of a file (like file type, size, time, "
"permissions, owner etc.), it provides some useful methods to determine its "
"type. It does *not* contain the file's data itself."
msgstr ""
#: ../Doc/library/tarfile.rst:504
msgid ""
":class:`TarInfo` objects are returned by :class:`TarFile`'s methods :meth:"
"`getmember`, :meth:`getmembers` and :meth:`gettarinfo`."
msgstr ""
#: ../Doc/library/tarfile.rst:510
msgid "Create a :class:`TarInfo` object."
msgstr ""
#: ../Doc/library/tarfile.rst:515
msgid "Create and return a :class:`TarInfo` object from string buffer *buf*."
msgstr ""
#: ../Doc/library/tarfile.rst:517
msgid "Raises :exc:`HeaderError` if the buffer is invalid."
msgstr ""
#: ../Doc/library/tarfile.rst:522
msgid ""
"Read the next member from the :class:`TarFile` object *tarfile* and return "
"it as a :class:`TarInfo` object."
msgstr ""
#: ../Doc/library/tarfile.rst:528
msgid ""
"Create a string buffer from a :class:`TarInfo` object. For information on "
"the arguments see the constructor of the :class:`TarFile` class."
msgstr ""
#: ../Doc/library/tarfile.rst:535
msgid "A ``TarInfo`` object has the following public data attributes:"
msgstr ""
#: ../Doc/library/tarfile.rst:540
msgid "Name of the archive member."
msgstr ""
#: ../Doc/library/tarfile.rst:545
msgid "Size in bytes."
msgstr ""
#: ../Doc/library/tarfile.rst:550
msgid "Time of last modification."
msgstr ""
#: ../Doc/library/tarfile.rst:555
msgid "Permission bits."
msgstr ""
#: ../Doc/library/tarfile.rst:560
msgid ""
"File type. *type* is usually one of these constants: :const:`REGTYPE`, :"
"const:`AREGTYPE`, :const:`LNKTYPE`, :const:`SYMTYPE`, :const:`DIRTYPE`, :"
"const:`FIFOTYPE`, :const:`CONTTYPE`, :const:`CHRTYPE`, :const:`BLKTYPE`, :"
"const:`GNUTYPE_SPARSE`. To determine the type of a :class:`TarInfo` object "
"more conveniently, use the ``is*()`` methods below."
msgstr ""
#: ../Doc/library/tarfile.rst:569
msgid ""
"Name of the target file name, which is only present in :class:`TarInfo` "
"objects of type :const:`LNKTYPE` and :const:`SYMTYPE`."
msgstr ""
#: ../Doc/library/tarfile.rst:575
msgid "User ID of the user who originally stored this member."
msgstr ""
#: ../Doc/library/tarfile.rst:580
msgid "Group ID of the user who originally stored this member."
msgstr ""
#: ../Doc/library/tarfile.rst:585
msgid "User name."
msgstr ""
#: ../Doc/library/tarfile.rst:590
msgid "Group name."
msgstr ""
#: ../Doc/library/tarfile.rst:595
msgid ""
"A dictionary containing key-value pairs of an associated pax extended header."
msgstr ""
#: ../Doc/library/tarfile.rst:598
msgid "A :class:`TarInfo` object also provides some convenient query methods:"
msgstr ""
#: ../Doc/library/tarfile.rst:603
msgid "Return :const:`True` if the :class:`Tarinfo` object is a regular file."
msgstr ""
#: ../Doc/library/tarfile.rst:608
msgid "Same as :meth:`isfile`."
msgstr ""
#: ../Doc/library/tarfile.rst:613
msgid "Return :const:`True` if it is a directory."
msgstr ""
#: ../Doc/library/tarfile.rst:618
msgid "Return :const:`True` if it is a symbolic link."
msgstr ""
#: ../Doc/library/tarfile.rst:623
msgid "Return :const:`True` if it is a hard link."
msgstr ""
#: ../Doc/library/tarfile.rst:628
msgid "Return :const:`True` if it is a character device."
msgstr ""
#: ../Doc/library/tarfile.rst:633
msgid "Return :const:`True` if it is a block device."
msgstr ""
#: ../Doc/library/tarfile.rst:638
msgid "Return :const:`True` if it is a FIFO."
msgstr ""
#: ../Doc/library/tarfile.rst:643
msgid ""
"Return :const:`True` if it is one of character device, block device or FIFO."
msgstr ""
#: ../Doc/library/tarfile.rst:649
msgid "Command Line Interface"
msgstr "Interface en ligne de commande"
#: ../Doc/library/tarfile.rst:653
msgid ""
"The :mod:`tarfile` module provides a simple command line interface to "
"interact with tar archives."
msgstr ""
#: ../Doc/library/tarfile.rst:656
msgid ""
"If you want to create a new tar archive, specify its name after the :option:"
"`-c` option and then list the filename(s) that should be included:"
msgstr ""
#: ../Doc/library/tarfile.rst:663
msgid "Passing a directory is also acceptable:"
msgstr "Passer un répertoire est aussi possible :"
#: ../Doc/library/tarfile.rst:669
msgid ""
"If you want to extract a tar archive into the current directory, use the :"
"option:`-e` option:"
msgstr ""
#: ../Doc/library/tarfile.rst:676
msgid ""
"You can also extract a tar archive into a different directory by passing the "
"directory's name:"
msgstr ""
#: ../Doc/library/tarfile.rst:683
msgid "For a list of the files in a tar archive, use the :option:`-l` option:"
msgstr ""
#: ../Doc/library/tarfile.rst:691
msgid "Command line options"
msgstr "Options de la ligne de commande"
#: ../Doc/library/tarfile.rst:696
msgid "List files in a tarfile."
msgstr ""
#: ../Doc/library/tarfile.rst:701
msgid "Create tarfile from source files."
msgstr ""
#: ../Doc/library/tarfile.rst:706
msgid ""
"Extract tarfile into the current directory if *output_dir* is not specified."
msgstr ""
#: ../Doc/library/tarfile.rst:711
msgid "Test whether the tarfile is valid or not."
msgstr ""
#: ../Doc/library/tarfile.rst:715
msgid "Verbose output"
msgstr "Affichage plus détaillé"
#: ../Doc/library/tarfile.rst:720
msgid "Examples"
msgstr "Exemples"
#: ../Doc/library/tarfile.rst:722
msgid "How to extract an entire tar archive to the current working directory::"
msgstr ""
#: ../Doc/library/tarfile.rst:729
msgid ""
"How to extract a subset of a tar archive with :meth:`TarFile.extractall` "
"using a generator function instead of a list::"
msgstr ""
#: ../Doc/library/tarfile.rst:744
msgid "How to create an uncompressed tar archive from a list of filenames::"
msgstr ""
#: ../Doc/library/tarfile.rst:752
msgid "The same example using the :keyword:`with` statement::"
msgstr ""
#: ../Doc/library/tarfile.rst:759
msgid ""
"How to read a gzip compressed tar archive and display some member "
"information::"
msgstr ""
#: ../Doc/library/tarfile.rst:773
msgid ""
"How to create an archive and reset the user information using the *filter* "
"parameter in :meth:`TarFile.add`::"
msgstr ""
#: ../Doc/library/tarfile.rst:789
msgid "Supported tar formats"
msgstr ""
#: ../Doc/library/tarfile.rst:791
msgid ""
"There are three tar formats that can be created with the :mod:`tarfile` "
"module:"
msgstr ""
#: ../Doc/library/tarfile.rst:793
msgid ""
"The POSIX.1-1988 ustar format (:const:`USTAR_FORMAT`). It supports filenames "
"up to a length of at best 256 characters and linknames up to 100 characters. "
"The maximum file size is 8 GiB. This is an old and limited but widely "
"supported format."
msgstr ""
#: ../Doc/library/tarfile.rst:798
msgid ""
"The GNU tar format (:const:`GNU_FORMAT`). It supports long filenames and "
"linknames, files bigger than 8 GiB and sparse files. It is the de facto "
"standard on GNU/Linux systems. :mod:`tarfile` fully supports the GNU tar "
"extensions for long names, sparse file support is read-only."
msgstr ""
#: ../Doc/library/tarfile.rst:803
msgid ""
"The POSIX.1-2001 pax format (:const:`PAX_FORMAT`). It is the most flexible "
"format with virtually no limits. It supports long filenames and linknames, "
"large files and stores pathnames in a portable way. However, not all tar "
"implementations today are able to handle pax archives properly."
msgstr ""
#: ../Doc/library/tarfile.rst:808
msgid ""
"The *pax* format is an extension to the existing *ustar* format. It uses "
"extra headers for information that cannot be stored otherwise. There are two "
"flavours of pax headers: Extended headers only affect the subsequent file "
"header, global headers are valid for the complete archive and affect all "
"following files. All the data in a pax header is encoded in *UTF-8* for "
"portability reasons."
msgstr ""
#: ../Doc/library/tarfile.rst:814
msgid ""
"There are some more variants of the tar format which can be read, but not "
"created:"
msgstr ""
#: ../Doc/library/tarfile.rst:817
msgid ""
"The ancient V7 format. This is the first tar format from Unix Seventh "
"Edition, storing only regular files and directories. Names must not be "
"longer than 100 characters, there is no user/group name information. Some "
"archives have miscalculated header checksums in case of fields with non-"
"ASCII characters."
msgstr ""
#: ../Doc/library/tarfile.rst:822
msgid ""
"The SunOS tar extended format. This format is a variant of the POSIX.1-2001 "
"pax format, but is not compatible."
msgstr ""
#: ../Doc/library/tarfile.rst:828
msgid "Unicode issues"
msgstr ""
#: ../Doc/library/tarfile.rst:830
msgid ""
"The tar format was originally conceived to make backups on tape drives with "
"the main focus on preserving file system information. Nowadays tar archives "
"are commonly used for file distribution and exchanging archives over "
"networks. One problem of the original format (which is the basis of all "
"other formats) is that there is no concept of supporting different character "
"encodings. For example, an ordinary tar archive created on a *UTF-8* system "
"cannot be read correctly on a *Latin-1* system if it contains non-*ASCII* "
"characters. Textual metadata (like filenames, linknames, user/group names) "
"will appear damaged. Unfortunately, there is no way to autodetect the "
"encoding of an archive. The pax format was designed to solve this problem. "
"It stores non-ASCII metadata using the universal character encoding *UTF-8*."
msgstr ""
#: ../Doc/library/tarfile.rst:842
msgid ""
"The details of character conversion in :mod:`tarfile` are controlled by the "
"*encoding* and *errors* keyword arguments of the :class:`TarFile` class."
msgstr ""
#: ../Doc/library/tarfile.rst:845
msgid ""
"*encoding* defines the character encoding to use for the metadata in the "
"archive. The default value is :func:`sys.getfilesystemencoding` or "
"``'ascii'`` as a fallback. Depending on whether the archive is read or "
"written, the metadata must be either decoded or encoded. If *encoding* is "
"not set appropriately, this conversion may fail."
msgstr ""
#: ../Doc/library/tarfile.rst:851
msgid ""
"The *errors* argument defines how characters are treated that cannot be "
"converted. Possible values are listed in section :ref:`error-handlers`. The "
"default scheme is ``'surrogateescape'`` which Python also uses for its file "
"system calls, see :ref:`os-filenames`."
msgstr ""
#: ../Doc/library/tarfile.rst:856
msgid ""
"In case of :const:`PAX_FORMAT` archives, *encoding* is generally not needed "
"because all the metadata is stored using *UTF-8*. *encoding* is only used in "
"the rare cases when binary pax headers are decoded or when strings with "
"surrogate characters are stored."
msgstr ""