Inverse of outTar(). Extracts one or more .tar.gz archives produced by outTar() / outSaveTarUpload(), which contain absolute paths. If pathRemap is supplied, the leading path prefix is rewritten on extraction (handy when the archive was created on another user's machine, e.g. paths starting with /home/emcintir/...).

Path rewriting uses GNU tar's --transform. On systems without GNU tar, supply pathRemap = NULL and the archive's absolute paths are restored as-is.

reUntar(tarballs, pathRemap = NULL, verbose = FALSE)

Arguments

tarballs

Character vector of paths to local tarballs.

pathRemap

Optional named character vector of length 2, c(old = "/old/prefix", new = "/new/prefix"), applied to all tarballs. If NULL (default), files are extracted to their original absolute paths (tar --absolute-names).

verbose

Logical. Pass -v to tar. Default FALSE.

Value

A character vector (same length as tarballs) of absolute paths to the .rds simList file inside each archive (after any remap), suitable for reLoad().