diff --git a/README.md b/README.md index ee467ba..29535e0 100644 --- a/README.md +++ b/README.md @@ -66,51 +66,84 @@ obviously relies on git. ## CLI Help ``` -roast 3.3.1 - Archiver with high-level compression +roast 4.7.0 - Archiver with high-level compression roast [OPTIONS] --target --outfile Options: -t, --target - Target directory to archive. This will be set as the root directory of the archive. - -a, --additional-paths - Additional paths such as files or directories to add to the archive. Their parent directory will be put next to the target directory. - -o, --outfile + Target directory to archive. This will be set as the root directory of the archive. Supports globbing. + -i, --include + Additional paths such as files or directories in the target directory to include to the archive. Their parent directory will be put next to the target directory's work directory. The work directory is based on the preserve root option. This is different from `--additional_paths`. Useful to override excluded directories. ⚠️ Careful if the archive has whether preserved root set when it was created. + -E, --exclude + Additional paths such as files or directories from within target directory's work directory to exclude when generating the archive. + -A, --additional-paths + Additional paths such as files or directories to add to the archive. Their parent directory will be put next to the target directory. This is different from `--include`. Optionally, one can add a path to a directory inside the archive e.g. `-A some/file/to/archive,put/where/in/archive`. If directory does not exist, it will be created. + -f, --outfile Output file of the generated archive with path. - -p, --preserve-root - Preserve root directory instead of only archiving relative paths. DEFAULT: false. - -r, --reproducible - Allow reproducibility for Reproducible Builds. DEFAULT: false. + -d, --outdir + Output path of extracted archive. + -p, --preserve-root + Preserve root directory instead of only archiving relative paths. [default: false] [possible values: true, false] + -r, --reproducible + Allow reproducibility for Reproducible Builds. [default: false] [possible values: true, false] + -g, --ignore-git + Whether to ignore git related metadata, files and directories. [default: true] [possible values: true, false] + -I, --ignore-hidden + Whether to ignore hidden directories and files or what we call dotfiles. Does not affect `--ignore-git`. [default: false] [possible values: true, false] -h, --help Print help (see more with '--help') -V, --version Print version + +Maintained by Soc Virnyl Estela . ``` ``` -raw 3.3.1 - Raw extractor and decompressor +raw 4.7.0 - Raw extractor and decompressor raw [OPTIONS] --target Options: - -t, --target Target tarball file to extract and decompress. - -o, --outdir Output path of extracted archive. DEFAULT: current directory if omitted. + -t, --target Target tarball file to extract and decompress. Supports globbing. + -d, --outdir Output directory of extracted archive. -h, --help Print help (see more with '--help') -V, --version Print version + +Maintained by Soc Virnyl Estela . ``` ``` -recomprizz 3.3.1 - Recompress to other compression formats +recomprizz 4.7.0 - Recompress to other compression formats recomprizz [OPTIONS] --target Options: - -t, --target Target tarball file to extract and recompress. - -o, --outdir Output directory of recompressed archive. DEFAULT: current directory if omitted. - -c, --compression Compression to use. [default: zst] [possible values: gz, xz, zst, bz2, not] - -R, --rename Use this flag if you want a new filename to use ignoring the new file extension. Omitting this flag will just fallback to basename. - -r, --reproducible Allow reproducibility for Reproducible Builds. DEFAULT: false. - -h, --help Print help (see more with '--help') - -V, --version Print version + -t, --target + Target tarball file to extract and recompress. Supports globbing. + -i, --include + Additional paths such as files or directories in the target directory to include to the archive. Their parent directory will be put next to the target directory's work directory. The work directory is based on the preserve root option. This is different from `--additional_paths`. Useful to override excluded directories. + -E, --exclude + Additional paths such as files or directories from within target directory's work directory to exclude when generating the archive. ⚠️ Careful if the archive has whether preserved root set when it was created. + -A, --additional-paths + Additional paths such as files or directories to add to the archive. Their parent directory will be put next to the target directory. This is different from `--include`. Optionally, one can add a path to a directory inside the archive e.g. `-A some/file/to/archive,put/where/in/archive`. If directory does not exist, it will be created. + -d, --outdir + Output directory of recompressed archive. + -c, --compression + Compression to use. [default: zst] [possible values: gz, xz, zst, bz2, not] + -R, --rename + Use this flag if you want a new filename to use ignoring the new file extension. Omitting this flag will just fallback to basename. + -r, --reproducible + Allow reproducibility for Reproducible Builds. [default: false] [possible values: true, false] + -g, --ignore-git + Whether to ignore git related metadata, files and directories. [default: true] [possible values: true, false] + -I, --ignore-hidden + Whether to ignore hidden directories and files or what we call dotfiles. Does not affect `--ignore-git`. [default: false] [possible values: true, false] + -h, --help + Print help (see more with '--help') + -V, --version + Print version + +Maintained by Soc Virnyl Estela . ```