diff options
author | Georg Brandl <georg@python.org> | 2008-03-28 08:06:56 (GMT) |
---|---|---|
committer | Georg Brandl <georg@python.org> | 2008-03-28 08:06:56 (GMT) |
commit | 621cd262539cd6bea59bb1c3cfc35b9d37a26d98 (patch) | |
tree | 3f098798841ac80a7b58f6ca7f485078e076496a | |
parent | 0001c2ecbc97ff097121fac42474773514f2e081 (diff) | |
download | cpython-621cd262539cd6bea59bb1c3cfc35b9d37a26d98.zip cpython-621cd262539cd6bea59bb1c3cfc35b9d37a26d98.tar.gz cpython-621cd262539cd6bea59bb1c3cfc35b9d37a26d98.tar.bz2 |
#2406: add examples to gzip docs.
-rw-r--r-- | Doc/library/gzip.rst | 49 |
1 files changed, 41 insertions, 8 deletions
diff --git a/Doc/library/gzip.rst b/Doc/library/gzip.rst index d298f88..86be3cd 100644 --- a/Doc/library/gzip.rst +++ b/Doc/library/gzip.rst @@ -1,19 +1,22 @@ - :mod:`gzip` --- Support for :program:`gzip` files ================================================= .. module:: gzip :synopsis: Interfaces for gzip compression and decompression using file objects. +This module provides a simple interface to compress and decompress files just +like the GNU programs :program:`gzip` and :program:`gunzip` would. + +The data compression is provided by the :mod:``zlib`` module. -The data compression provided by the ``zlib`` module is compatible with that -used by the GNU compression program :program:`gzip`. Accordingly, the -:mod:`gzip` module provides the :class:`GzipFile` class to read and write +The :mod:`gzip` module provides the :class:`GzipFile` class which is modeled +after Python's File Object. The :class:`GzipFile` class reads and writes :program:`gzip`\ -format files, automatically compressing or decompressing the -data so it looks like an ordinary file object. 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. +data so that it looks like an ordinary file object. + +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. For other archive formats, see the :mod:`bz2`, :mod:`zipfile`, and :mod:`tarfile` modules. @@ -63,6 +66,36 @@ The module defines the following items: *compresslevel* defaults to ``9``. +.. _gzip-usage-examples: + +Examples of usage +----------------- + +Example of how to read a compressed file:: + + import gzip + f = gzip.open('/home/joe/file.txt.gz', 'rb') + file_content = f.read() + f.close() + +Example of how to create a compressed GZIP file:: + + import gzip + content = "Lots of content here" + f = gzip.open('/home/joe/file.txt.gz', 'wb') + f.write(content) + f.close() + +Example of how to GZIP compress an existing file:: + + import gzip + f_in = open('/home/joe/file.txt', 'rb') + f_out = gzip.open('/home/joe/file.txt.gz', 'wb') + f_out.writelines(f_in) + f_out.close() + f_in.close() + + .. seealso:: Module :mod:`zlib` |