03018b4e5b
Why:
* To prevent archives such as archive.rar.gz from breaking patool.
This change addresses the need by:
* move program_supports_compression above the `import util` line
* If we don't do this, we have a circular import.
* Import program_supports_compression into util.
* Only return separate mime and encoding if program_support_compression
returns True.
* Otherwise return the mime of the encoding and no encoding.
* Add fixes so that current tests still pass.
* In program_support_compression:
- Test tar separately and check all supported tar wrappers.
* In test_tar:
- Add file requirement for compress in the compress check.
- Otherwise tar tries and failes when compress isn't installed.
|
||
|---|---|---|
| doc | ||
| patoolib | ||
| scripts | ||
| tests | ||
| .gitattributes | ||
| .gitignore | ||
| .travis.yml | ||
| COPYING | ||
| MANIFEST.in | ||
| Makefile | ||
| README.md | ||
| install-rpm.sh | ||
| patool | ||
| patool.bash-completion | ||
| requirements.txt | ||
| setup.cfg | ||
| setup.py | ||
README.md
Patool
Patool is an archive file manager.
Various archive formats can be created, extracted, tested, listed, searched, repacked and compared with patool. The advantage of patool is its simplicity in handling archive files without having to remember a myriad of programs and options.
The archive format is determined by the file(1) program and as a fallback by the archive file extension.
patool supports 7z (.7z, .cb7), ACE (.ace, .cba), ADF (.adf), ALZIP (.alz), APE (.ape), AR (.a), ARC (.arc), ARJ (.arj), BZIP2 (.bz2), CAB (.cab), COMPRESS (.Z), CPIO (.cpio), DEB (.deb), DMS (.dms), FLAC (.flac), GZIP (.gz), ISO (.iso), LRZIP (.lrz), LZH (.lha, .lzh), LZIP (.lz), LZMA (.lzma), LZOP (.lzo), RPM (.rpm), RAR (.rar, .cbr), RZIP (.rz), SHN (.shn), TAR (.tar, .cbt), XZ (.xz), ZIP (.zip, .jar, .cbz) and ZOO (.zoo) archive formats. It relies on helper applications to handle those archive formats (for example bzip2 for BZIP2 archives).
The archive formats TAR, ZIP, BZIP2 and GZIP are supported natively and do not require helper applications to be installed.
Examples
# Extract several archives with different formats
patool extract archive.zip otherarchive.rar
# Test archive integrity
patool test --verbose dist.tar.gz
# List files stored in an archive
patool list package.deb
# Create a new archive
patool create --verbose /path/to/myfiles.zip file1.txt dir/
# Show differences between two archives
patool diff release1.0.tar.gz release2.0.zip
# Search for text inside archives
patool search "def urlopen" python-3.3.tar.gz
# Repackage an archive in a different format
patool repack linux-2.6.33.tar.gz linux-2.6.33.tar.bz2
Website
See http://wummel.github.io/patool/ for more info and downloads.
API
You can use patool functions from other Python applications.
Log output will be on sys.stdout and sys.stderr.
On errors, PatoolError will be raised.
Note that extra options such as password input or customization
for specific archive programs are not supported.
import patoolib
patoolib.extract_archive("archive.zip", outdir="/tmp")
patoolib.test_archive("dist.tar.gz", verbosity=1)
patoolib.list_archive("package.deb")
patoolib.create_archive("/path/to/myfiles.zip", ("file1.txt", "dir/"))
patoolib.diff_archives("release1.0.tar.gz", "release2.0.zip")
patoolib.search_archive("def urlopen", "python3.3.tar.gz")
patoolib.repack_archive("linux-2.6.33.tar.gz", "linux-2.6.33.tar.bz2")
Test suite status
Patool has extensive unit tests to ensure the code quality. Travis CI is used for continuous build and test integration.
