diff options
author | Serhiy Storchaka <storchaka@gmail.com> | 2016-11-02 12:13:48 +0200 |
---|---|---|
committer | Serhiy Storchaka <storchaka@gmail.com> | 2016-11-02 12:13:48 +0200 |
commit | 5a97bf7decafd3421c91565bc2f16e7b1992b566 (patch) | |
tree | 5e6ddea5182ce36aa498ca2b27bff6c4846e5f4a /Doc/library/zipfile.rst | |
parent | a3498c756984e17cd2d781199a33a0620d6b927b (diff) | |
parent | d8d9da04b79a2be640af6bbd0b27d625e77806ae (diff) | |
download | cpython-git-5a97bf7decafd3421c91565bc2f16e7b1992b566.tar.gz |
Issue #28513: Documented command-line interface of zipfile.
Diffstat (limited to 'Doc/library/zipfile.rst')
-rw-r--r-- | Doc/library/zipfile.rst | 60 |
1 files changed, 60 insertions, 0 deletions
diff --git a/Doc/library/zipfile.rst b/Doc/library/zipfile.rst index 47ba0b521e..97d31d9483 100644 --- a/Doc/library/zipfile.rst +++ b/Doc/library/zipfile.rst @@ -632,4 +632,64 @@ Instances have the following methods and attributes: Size of the uncompressed file. +.. _zipfile-commandline: +.. program:: zipfile + +Command-Line Interface +---------------------- + +The :mod:`zipfile` module provides a simple command-line interface to interact +with ZIP archives. + +If you want to create a new ZIP archive, specify its name after the :option:`-c` +option and then list the filename(s) that should be included: + +.. code-block:: shell-session + + $ python -m zipfile -c monty.zip spam.txt eggs.txt + +Passing a directory is also acceptable: + +.. code-block:: shell-session + + $ python -m zipfile -c monty.zip life-of-brian_1979/ + +If you want to extract a ZIP archive into the specified directory, use +the :option:`-e` option: + +.. code-block:: shell-session + + $ python -m zipfile -e monty.zip target-dir/ + +For a list of the files in a ZIP archive, use the :option:`-l` option: + +.. code-block:: shell-session + + $ python -m zipfile -l monty.zip + + +Command-line options +~~~~~~~~~~~~~~~~~~~~ + +.. cmdoption:: -l <zipfile> + --list <zipfile> + + List files in a zipfile. + +.. cmdoption:: -c <zipfile> <source1> ... <sourceN> + --create <zipfile> <source1> ... <sourceN> + + Create zipfile from source files. + +.. cmdoption:: -e <zipfile> <output_dir> + --extract <zipfile> <output_dir> + + Extract zipfile into target directory. + +.. cmdoption:: -t <zipfile> + --test <zipfile> + + Test whether the zipfile is valid or not. + + .. _PKZIP Application Note: https://pkware.cachefly.net/webdocs/casestudies/APPNOTE.TXT |