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), BZIP3 (.bz3),
CAB (.cab), CHM (.chm), 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), ZOO (.zoo) and ZSTANDARD (.zst) archive formats.
It relies on helper applications to handle those archive formats
(for example `xz` for XZ (.xz) 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
# Extract archive with password
patool extract --password somepassword archive.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/
# Create a new archive with password
patool create --verbose --password somepassword /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 https://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 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")
patoolib.is_archive("package.deb")
```
See https://wummel.github.io/patool/ for detailed API documentation.
Test suite
-----------
Patool has [extensive unit tests](https://github.com/wummel/patool/tree/master/tests) to ensure the code quality.
The tests are run on each commit by a github runner.
Bash completion
----------------
Install the argcomplete python package with
`apt-get install python3-argcomplete`,
then run
`eval "$(register-python-argcomplete patool)"`.
After that typing `patool`, a `<SPACE>` and then `<TAB>`
lists available options and commands.
Raw data
{
"_id": null,
"home_page": "https://github.com/wummel/patool",
"name": "patool",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "archiver, archive, compression, commandline, manager",
"author": "Bastian Kleineidam",
"author_email": "bastian.kleineidam@web.de",
"download_url": "https://files.pythonhosted.org/packages/4b/69/4b9cd3f24bd1f949d740d10410fa6e9cebe477f013483ab47b906a8f6fb9/patool-3.0.3.tar.gz",
"platform": null,
"description": "Patool\n=======\n\nPatool is an archive file manager.\n\nVarious archive formats can be created, extracted, tested, listed,\nsearched, repacked and compared with patool. The advantage of patool is\nits simplicity in handling archive files without having to remember a\nmyriad of programs and options.\n\nThe archive format is determined by the file(1) program and as\na fallback by the archive file extension.\n\npatool supports 7z (.7z, .cb7), ACE (.ace, .cba), ADF (.adf), ALZIP (.alz),\nAPE (.ape), AR (.a), ARC (.arc), ARJ (.arj), BZIP2 (.bz2), BZIP3 (.bz3),\nCAB (.cab), CHM (.chm), COMPRESS (.Z), CPIO (.cpio), DEB (.deb), DMS (.dms),\nFLAC (.flac), GZIP (.gz), ISO (.iso), LRZIP (.lrz), LZH (.lha, .lzh),\nLZIP (.lz), LZMA (.lzma), LZOP (.lzo), RPM (.rpm), RAR (.rar, .cbr),\nRZIP (.rz), SHN (.shn), TAR (.tar, .cbt), XZ (.xz),\nZIP (.zip, .jar, .cbz), ZOO (.zoo) and ZSTANDARD (.zst) archive formats.\n\nIt relies on helper applications to handle those archive formats\n(for example `xz` for XZ (.xz) archives).\n\nThe archive formats TAR, ZIP, BZIP2 and GZIP are supported natively\nand do not require helper applications to be installed.\n\nExamples\n---------\n```\n# Extract several archives with different formats\npatool extract archive.zip otherarchive.rar\n\n# Extract archive with password\npatool extract --password somepassword archive.rar\n\n# Test archive integrity\npatool test --verbose dist.tar.gz\n\n# List files stored in an archive\npatool list package.deb\n\n# Create a new archive\npatool create --verbose /path/to/myfiles.zip file1.txt dir/\n\n# Create a new archive with password\npatool create --verbose --password somepassword /path/to/myfiles.zip file1.txt dir/\n\n# Show differences between two archives\npatool diff release1.0.tar.gz release2.0.zip\n\n# Search for text inside archives\npatool search \"def urlopen\" python-3.3.tar.gz\n\n# Repackage an archive in a different format\npatool repack linux-2.6.33.tar.gz linux-2.6.33.tar.bz2\n```\n\nWebsite\n--------\nSee https://wummel.github.io/patool/ for more info and downloads.\n\nAPI\n----\nYou can use patool functions from other Python applications.\nLog output will be on sys.stdout and sys.stderr.\nOn errors, `PatoolError` will be raised.\nNote that extra options or customization\nfor specific archive programs are not supported.\n\n```\nimport patoolib\npatoolib.extract_archive(\"archive.zip\", outdir=\"/tmp\")\npatoolib.test_archive(\"dist.tar.gz\", verbosity=1)\npatoolib.list_archive(\"package.deb\")\npatoolib.create_archive(\"/path/to/myfiles.zip\", (\"file1.txt\", \"dir/\"))\npatoolib.diff_archives(\"release1.0.tar.gz\", \"release2.0.zip\")\npatoolib.search_archive(\"def urlopen\", \"python3.3.tar.gz\")\npatoolib.repack_archive(\"linux-2.6.33.tar.gz\", \"linux-2.6.33.tar.bz2\")\npatoolib.is_archive(\"package.deb\")\n```\n\nSee https://wummel.github.io/patool/ for detailed API documentation.\n\nTest suite\n-----------\nPatool has [extensive unit tests](https://github.com/wummel/patool/tree/master/tests) to ensure the code quality.\nThe tests are run on each commit by a github runner.\n\n\nBash completion\n----------------\nInstall the argcomplete python package with\n`apt-get install python3-argcomplete`,\nthen run\n`eval \"$(register-python-argcomplete patool)\"`.\nAfter that typing `patool`, a `<SPACE>` and then `<TAB>`\nlists available options and commands.\n",
"bugtrack_url": null,
"license": "GPL-3",
"summary": "portable archive file manager",
"version": "3.0.3",
"project_urls": {
"Homepage": "https://github.com/wummel/patool",
"Source": "https://github.com/wummel/patool"
},
"split_keywords": [
"archiver",
" archive",
" compression",
" commandline",
" manager"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "fed5b93d4f3387f9619cbd2650736b15df2a0c5d110eff50407cebddb39a3a0c",
"md5": "761a88174f34c03b44e242f2767e17ea",
"sha256": "6b2a319817908849774815d231482daee8e08fd6ead2a9b53a442b5ea8e2f78b"
},
"downloads": -1,
"filename": "patool-3.0.3-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "761a88174f34c03b44e242f2767e17ea",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.10",
"size": 98295,
"upload_time": "2024-11-04T18:35:42",
"upload_time_iso_8601": "2024-11-04T18:35:42.402261Z",
"url": "https://files.pythonhosted.org/packages/fe/d5/b93d4f3387f9619cbd2650736b15df2a0c5d110eff50407cebddb39a3a0c/patool-3.0.3-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "4b694b9cd3f24bd1f949d740d10410fa6e9cebe477f013483ab47b906a8f6fb9",
"md5": "71f778eaa5e219f5164cc81c761d0de1",
"sha256": "08a79e570b4ed7298b0901717a4fb5aee20299f0ec70e3c44fa431699e0badb3"
},
"downloads": -1,
"filename": "patool-3.0.3.tar.gz",
"has_sig": false,
"md5_digest": "71f778eaa5e219f5164cc81c761d0de1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 2003565,
"upload_time": "2024-11-04T18:35:40",
"upload_time_iso_8601": "2024-11-04T18:35:40.317200Z",
"url": "https://files.pythonhosted.org/packages/4b/69/4b9cd3f24bd1f949d740d10410fa6e9cebe477f013483ab47b906a8f6fb9/patool-3.0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-04 18:35:40",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "wummel",
"github_project": "patool",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "patool"
}