zip

vb zip VERSION OUTPUTFILE [OPTIONS]

Description

Generate a ZIP archive for a check-in. If the --name option is used, its argument becomes the name of the top-level directory in the resulting ZIP archive. If --name is omitted, the top-level directory name is derived from the project name, the check-in date and time, and the artifact ID of the check-in.

The GLOBLIST argument to --exclude and --include can be a comma-separated list of glob patterns, where each glob pattern may optionally be enclosed in ... or ... so that it may contain commas. If a file matches both --include and --exclude then it is excluded.

If OUTPUTFILE is an empty string or /dev/null then no ZIP archive is actually generated. This feature can be used in combination with the --list option to get a list of the filenames that would be in the ZIP archive had it actually been generated.

Options

-X, --exclude GLOBLIST

Comma-separated list of GLOBs of files to exclude

--include GLOBLIST

Comma-separated list of GLOBs of files to include

-l, --list

Show archive content on stdout

--name DIRECTORYNAME

The name of the top-level directory in the archive

-R REPOSITORY

Specify a VisionByte repository

Examples

  • List ZIP contents without writing a file

$ vb zip current release.zip -l
unnamed_2026-03-31_130051_11dff0a5fc/a.txt
unnamed_2026-03-31_130051_11dff0a5fc/b.txt