# SOME DESCRIPTIVE TITLE. # Copyright (C) 2001-2016, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2017-04-02 22:11+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #: ../Doc/library/gzip.rst:2 msgid ":mod:`gzip` --- Support for :program:`gzip` files" msgstr "" #: ../Doc/library/gzip.rst:7 msgid "**Source code:** :source:`Lib/gzip.py`" msgstr "**Code source :** :source:`Lib/gzip.py`" #: ../Doc/library/gzip.rst:11 msgid "" "This module provides a simple interface to compress and decompress files " "just like the GNU programs :program:`gzip` and :program:`gunzip` would." msgstr "" #: ../Doc/library/gzip.rst:14 msgid "The data compression is provided by the :mod:`zlib` module." msgstr "" #: ../Doc/library/gzip.rst:16 msgid "" "The :mod:`gzip` module provides the :class:`GzipFile` class, as well as the :" "func:`.open`, :func:`compress` and :func:`decompress` convenience functions. " "The :class:`GzipFile` class reads and writes :program:`gzip`\\ -format " "files, automatically compressing or decompressing the data so that it looks " "like an ordinary :term:`file object`." msgstr "" #: ../Doc/library/gzip.rst:22 msgid "" "Note that additional file formats which can be decompressed by the :program:" "`gzip` and :program:`gunzip` programs, such as those produced by :program:" "`compress` and :program:`pack`, are not supported by this module." msgstr "" #: ../Doc/library/gzip.rst:26 msgid "The module defines the following items:" msgstr "Le module définit les éléments suivants :" #: ../Doc/library/gzip.rst:31 msgid "" "Open a gzip-compressed file in binary or text mode, returning a :term:`file " "object`." msgstr "" #: ../Doc/library/gzip.rst:34 msgid "" "The *filename* argument can be an actual filename (a :class:`str` or :class:" "`bytes` object), or an existing file object to read from or write to." msgstr "" #: ../Doc/library/gzip.rst:37 msgid "" "The *mode* argument can be any of ``'r'``, ``'rb'``, ``'a'``, ``'ab'``, " "``'w'``, ``'wb'``, ``'x'`` or ``'xb'`` for binary mode, or ``'rt'``, " "``'at'``, ``'wt'``, or ``'xt'`` for text mode. The default is ``'rb'``." msgstr "" #: ../Doc/library/gzip.rst:41 msgid "" "The *compresslevel* argument is an integer from 0 to 9, as for the :class:" "`GzipFile` constructor." msgstr "" #: ../Doc/library/gzip.rst:44 msgid "" "For binary mode, this function is equivalent to the :class:`GzipFile` " "constructor: ``GzipFile(filename, mode, compresslevel)``. In this case, the " "*encoding*, *errors* and *newline* arguments must not be provided." msgstr "" #: ../Doc/library/gzip.rst:48 msgid "" "For text mode, a :class:`GzipFile` object is created, and wrapped in an :" "class:`io.TextIOWrapper` instance with the specified encoding, error " "handling behavior, and line ending(s)." msgstr "" #: ../Doc/library/gzip.rst:52 msgid "" "Added support for *filename* being a file object, support for text mode, and " "the *encoding*, *errors* and *newline* arguments." msgstr "" #: ../Doc/library/gzip.rst:56 msgid "Added support for the ``'x'``, ``'xb'`` and ``'xt'`` modes." msgstr "" #: ../Doc/library/gzip.rst:59 ../Doc/library/gzip.rst:156 msgid "Accepts a :term:`path-like object`." msgstr "" #: ../Doc/library/gzip.rst:64 msgid "" "Constructor for the :class:`GzipFile` class, which simulates most of the " "methods of a :term:`file object`, with the exception of the :meth:`truncate` " "method. At least one of *fileobj* and *filename* must be given a non-" "trivial value." msgstr "" #: ../Doc/library/gzip.rst:69 msgid "" "The new class instance is based on *fileobj*, which can be a regular file, " "an :class:`io.BytesIO` object, or any other object which simulates a file. " "It defaults to ``None``, in which case *filename* is opened to provide a " "file object." msgstr "" #: ../Doc/library/gzip.rst:74 msgid "" "When *fileobj* is not ``None``, the *filename* argument is only used to be " "included in the :program:`gzip` file header, which may include the original " "filename of the uncompressed file. It defaults to the filename of " "*fileobj*, if discernible; otherwise, it defaults to the empty string, and " "in this case the original filename is not included in the header." msgstr "" #: ../Doc/library/gzip.rst:80 msgid "" "The *mode* argument can be any of ``'r'``, ``'rb'``, ``'a'``, ``'ab'``, " "``'w'``, ``'wb'``, ``'x'``, or ``'xb'``, depending on whether the file will " "be read or written. The default is the mode of *fileobj* if discernible; " "otherwise, the default is ``'rb'``." msgstr "" #: ../Doc/library/gzip.rst:85 msgid "" "Note that the file is always opened in binary mode. To open a compressed " "file in text mode, use :func:`.open` (or wrap your :class:`GzipFile` with " "an :class:`io.TextIOWrapper`)." msgstr "" #: ../Doc/library/gzip.rst:89 msgid "" "The *compresslevel* argument is an integer from ``0`` to ``9`` controlling " "the level of compression; ``1`` is fastest and produces the least " "compression, and ``9`` is slowest and produces the most compression. ``0`` " "is no compression. The default is ``9``." msgstr "" #: ../Doc/library/gzip.rst:94 msgid "" "The *mtime* argument is an optional numeric timestamp to be written to the " "last modification time field in the stream when compressing. It should only " "be provided in compression mode. If omitted or ``None``, the current time " "is used. See the :attr:`mtime` attribute for more details." msgstr "" #: ../Doc/library/gzip.rst:99 msgid "" "Calling a :class:`GzipFile` object's :meth:`close` method does not close " "*fileobj*, since you might wish to append more material after the compressed " "data. This also allows you to pass an :class:`io.BytesIO` object opened for " "writing as *fileobj*, and retrieve the resulting memory buffer using the :" "class:`io.BytesIO` object's :meth:`~io.BytesIO.getvalue` method." msgstr "" #: ../Doc/library/gzip.rst:105 msgid "" ":class:`GzipFile` supports the :class:`io.BufferedIOBase` interface, " "including iteration and the :keyword:`with` statement. Only the :meth:" "`truncate` method isn't implemented." msgstr "" #: ../Doc/library/gzip.rst:109 msgid ":class:`GzipFile` also provides the following method and attribute:" msgstr "" #: ../Doc/library/gzip.rst:113 msgid "" "Read *n* uncompressed bytes without advancing the file position. At most one " "single read on the compressed stream is done to satisfy the call. The " "number of bytes returned may be more or less than requested." msgstr "" #: ../Doc/library/gzip.rst:118 msgid "" "While calling :meth:`peek` does not change the file position of the :class:" "`GzipFile`, it may change the position of the underlying file object (e.g. " "if the :class:`GzipFile` was constructed with the *fileobj* parameter)." msgstr "" #: ../Doc/library/gzip.rst:127 msgid "" "When decompressing, the value of the last modification time field in the " "most recently read header may be read from this attribute, as an integer. " "The initial value before reading any headers is ``None``." msgstr "" #: ../Doc/library/gzip.rst:131 msgid "" "All :program:`gzip` compressed streams are required to contain this " "timestamp field. Some programs, such as :program:`gunzip`\\ , make use of " "the timestamp. The format is the same as the return value of :func:`time." "time` and the :attr:`~os.stat_result.st_mtime` attribute of the object " "returned by :func:`os.stat`." msgstr "" #: ../Doc/library/gzip.rst:137 msgid "" "Support for the :keyword:`with` statement was added, along with the *mtime* " "constructor argument and :attr:`mtime` attribute." msgstr "" #: ../Doc/library/gzip.rst:141 msgid "Support for zero-padded and unseekable files was added." msgstr "" #: ../Doc/library/gzip.rst:144 msgid "The :meth:`io.BufferedIOBase.read1` method is now implemented." msgstr "" #: ../Doc/library/gzip.rst:147 msgid "Added support for the ``'x'`` and ``'xb'`` modes." msgstr "" #: ../Doc/library/gzip.rst:150 msgid "" "Added support for writing arbitrary :term:`bytes-like objects `. The :meth:`~io.BufferedIOBase.read` method now accepts an argument " "of ``None``." msgstr "" #: ../Doc/library/gzip.rst:162 msgid "" "Compress the *data*, returning a :class:`bytes` object containing the " "compressed data. *compresslevel* has the same meaning as in the :class:" "`GzipFile` constructor above." msgstr "" #: ../Doc/library/gzip.rst:170 msgid "" "Decompress the *data*, returning a :class:`bytes` object containing the " "uncompressed data." msgstr "" #: ../Doc/library/gzip.rst:179 msgid "Examples of usage" msgstr "" #: ../Doc/library/gzip.rst:181 msgid "Example of how to read a compressed file::" msgstr "" #: ../Doc/library/gzip.rst:187 msgid "Example of how to create a compressed GZIP file::" msgstr "" #: ../Doc/library/gzip.rst:194 msgid "Example of how to GZIP compress an existing file::" msgstr "" #: ../Doc/library/gzip.rst:202 msgid "Example of how to GZIP compress a binary string::" msgstr "" #: ../Doc/library/gzip.rst:211 msgid "Module :mod:`zlib`" msgstr "" #: ../Doc/library/gzip.rst:211 msgid "" "The basic data compression module needed to support the :program:`gzip` file " "format." msgstr ""