rezip

Merges ZIP/NPZ archives recompressed or aligned and stacks NPY arrays

See the release history to keep track of the development.

Installation

cargo install rezip

Command-line Interface

Rezip 0.2.0
Rouven Spreckels <rs@qu1x.dev>
Merges ZIP/NPZ archives recompressed or aligned and stacks NPY arrays

Options accepting <[glob=]value> pairs use the given values for matching file
names in input ZIP archives. Matches of former pairs are superseded by matches
of latter pairs. Omitting [glob=] by only passing a value assumes the * glob
pattern matching all file names whereas an empty glob pattern matches no file
names. An empty value disables the option for the file names matching the glob
pattern. Passing a single pair with an empty glob pattern and an empty value,
that is a = only, disables an option with default values entirely as in
--recompress = whereas passing no pairs as in --recompress keeps assuming the
default values.

Usage: rezip [OPTIONS] [glob]...

Arguments:
  [glob]...
          Merges or checks input ZIP archives.

          Stacks identically named files in different input ZIP archives in the
          order given by parsing supported file formats like NPY (NumPy array
          file). Otherwise, only the file in the last given input ZIP archive is
          merged into the output ZIP archive.

Options:
  -o, --output <path>
          Writes output ZIP archive.

          With no output ZIP archive, checks if files in input ZIP archives are
          as requested according to --recompress and --align. Recompress levels
          and --merge matches are not checked.

  -f, --force
          Writes existing output ZIP archive

  -m, --merge <[glob=]name>
          Merges files as if they were in ZIP archives.

          Merges files as if they were in different ZIP archives and renames
          them to the given names. With empty names, keeps original names,
          effectively creating a ZIP archive from input files.

          Note: File permissions and its last modification time are not yet
          supported.

  -r, --recompress <[glob=]method>
          Writes files recompressed.

          Supported methods are stored (uncompressed), deflated (most common),
          bzip2[:1-9] (high ratio) with 9 as default level, and zstd[:1-21]
          (modern) with 3 as default level. With no methods, files are
          recompressed using their original methods but with default levels.

          [default: stored]

  -a, --align <[glob=]bytes>
          Aligns uncompressed files.

          Aligns uncompressed files in ZIP archives by padding local file
          headers to enable memory-mapping, SIMD instruction extensions like
          AVX-512, and dynamic loading of shared objects.

          [default: 64 *.so=4096]

  -s, --stack <[glob=]axis>
          Stacks arrays along axis.

          One stacked array at a time must fit twice into memory before it is
          written to the output ZIP archive.

          [default: 0]

  -v, --verbose...
          Prints status information.

          The more occurrences, the more verbose, with three at most.

  -h, --help
          Print help (see a summary with '-h')

  -V, --version
          Print version

Licenses

This work is dual-licensed under either MIT or Apache-2.0 at your option. This means you can select the license you prefer. This dual-licensing approach is the de-facto standard in the Rust ecosystem. Copyrights in this work are retained by their contributors and no copyright assignment is required to contribute to this work. For full authorship information, see the individual files and the version control history.

Contributions

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual-licensed as above, without any additional terms or conditions.