~dricottone/my-utils

ref: ef6d4cd1b378cc0ebbcb6e1460b3909f0cdd71b6 my-utils/archives/README.md -rw-r--r-- 2.0 KiB
ef6d4cd1Dominic Ricottone Incomplete work on hardware/media utils 5 days ago

#archives utilities

Tools for creating, parsing, and scripting archive files.

bats is required for the test suite.

#Specification

While you technically won't run into an error, these scripts do expect tar to support Zstandard, which isn't necessarily POSIX standard.

Executable Description Extra Dependencies
epub Dumps HTML from an 'epub' e-book archive bash, zipinfo, unzip, w3m
mktar Archive utility bash, age*
mktar-batch Archive utility for scripting bash, age*
rmtar Delete 'tar' archive files
rmzip Delete 'zip' archive files
tarcat Unarchive utility for scripting bash, age*
tarls List files within archive files bash, age*
untar Unarchive utility bash, age*
zipls List files within zip archive file(s) zipinfo

All scripts support -h and --help for printing built-in documentation.

All scripts do nothing if no input arguments are given.

*These utilities use a fork of age that supports plaintext passphrases. See [git.dominic-ricottone.com/age.git].

#Notes

Per FreeBSD's tar(1):

For maximum portability, scripts that invoke tar should use the bundled- argument format above, should limit themselves to the c, t, and x modes, and the b, f, m, v, and w options.

I have noted that pretty much any viable implementation also supports O (extract to stdout). That includes BusyBox.

#To-Do

  • add support for rar, 7z archives