History

Marc Cornellà d47e1d65f6 fix(extract): safely remove extract directory The previous code would remove the extract directory if the command failed. This could be bad because we're not checking if the extract directory already existed (since we're using `mkdir -p`), so it could be possible that the extract operation failed, and we'd be removing a directory that already existed and had files in it. This change only removes the directory if there are no files in it, regardless of whether the extract operation was successful or not. This is much safer.		2023-04-02 16:33:54 +02:00
..
_extract	feat(extract): support `obscpio` format (#11511 )	2023-02-22 10:16:28 +01:00
extract.plugin.zsh	fix(extract): safely remove extract directory	2023-04-02 16:33:54 +02:00
README.md	feat(extract): support `obscpio` format (#11511 )	2023-02-22 10:16:28 +01:00

extract plugin

This plugin defines a function called extract that extracts the archive file you pass it, and it supports a wide variety of archive filetypes.

This way you don't have to know what specific command extracts a file, you just do extract <filename> and the function takes care of the rest.

To use it, add extract to the plugins array in your zshrc file:

plugins=(... extract)

Supported file extensions

Extension	Description
`7z`	7zip file
`Z`	Z archive (LZW)
`apk`	Android app file
`aar`	Android library file
`bz2`	Bzip2 file
`cab`	Microsoft cabinet archive
`cpio`	Cpio archive
`deb`	Debian package
`ear`	Enterprise Application aRchive
`gz`	Gzip file
`ipa`	iOS app package
`ipsw`	iOS firmware file
`jar`	Java Archive
`lrz`	LRZ archive
`lz4`	LZ4 archive
`lzma`	LZMA archive
`obscpio`	cpio archive used on OBS
`rar`	WinRAR archive
`rpm`	RPM package
`sublime-package`	Sublime Text package
`tar`	Tarball
`tar.bz2`	Tarball with bzip2 compression
`tar.gz`	Tarball with gzip compression
`tar.lrz`	Tarball with lrzip compression
`tar.lz`	Tarball with lzip compression
`tar.lz4`	Tarball with lz4 compression
`tar.xz`	Tarball with lzma2 compression
`tar.zma`	Tarball with lzma compression
`tar.zst`	Tarball with zstd compression
`tbz`	Tarball with bzip compression
`tbz2`	Tarball with bzip2 compression
`tgz`	Tarball with gzip compression
`tlz`	Tarball with lzma compression
`txz`	Tarball with lzma2 compression
`tzst`	Tarball with zstd compression
`war`	Web Application archive (Java-based)
`xpi`	Mozilla XPI module file
`xz`	LZMA2 archive
`zip`	Zip archive
`zst`	Zstandard file (zstd)
`zpaq`	Zpaq file

See list of archive formats for more information regarding archive formats.