shoriminimoe / fish-extract

An archive extraction plugin for fish-shell

fish-extract

An archive extraction plugin for fish-shell. Inspired by the oh-my-zsh extract plugin.

Installation

Install using fisher:

fisher install shoriminimoe/fish-extract

Install using oh-my-fish:

omf install shoriminimoe/fish-extract

Manual install:

mkdir -p ~/.config/fish/functions
curl https://raw.githubusercontent.com/shoriminimoe/fish-extract/main/functions/extract.fish >~/.config/fish/functions/extract.fish

Usage

extract FILE [FILE ...]

Supported Formats

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

fish-extract's Issues

`x` alias is not detected by fish until `extract` is called

Fish detects the name after extract.fish is evaluated. x needs to be in its own function file.

$ functions -q x; echo $status
1

$ functions -q extract; echo $status
0

$ functions -q x; echo $status
0

Supported archive types

If you support zip files you shouldn't have any problems with at least jar and xpi files. Both formats are just zip files themselves....
Just beware: neither of them uses a 'root directory' 😉

Guarantee no tarbombs?

Tarbombs suck. I just got hit with one. Maybe this plugin should make sure they don't happen.