bundle¶
vb bundle SUBCOMMAND [OPTIONS]
Description¶
Create, inspect, and import/export bundles of repository content.
Subcommands¶
vb bundle append¶
vb bundle append BUNDLE FILE ...
Description¶
Add files named on the command line to BUNDLE. This subcommand has little practical use and is mostly intended for testing.
vb bundle cat¶
vb bundle cat BUNDLE HASH ...
Description¶
Extract one or more artifacts from the bundle and write them consecutively on standard output. This subcommand was designed for testing and introspection of bundles and is not something commonly used.
vb bundle export¶
vb bundle export BUNDLE [OPTIONS]
Description¶
Generate a new bundle, in the file named BUNDLE, that contains a subset of the check-ins in the repository (usually a single branch) described by the –branch, –from, –to, and/or –checkin options, at least one of which is required. If BUNDLE already exists, the specified content is added to the bundle.
Options¶
- --branch BRANCH¶
Package all check-ins on BRANCH
- --from TAG1 --to TAG2¶
Package check-ins between TAG1 and TAG2
- --checkin TAG¶
Package the single check-in TAG
- --standalone¶
Do not delta-encode against artifacts not in the bundle
vb bundle extend¶
vb bundle extend BUNDLE
Description¶
The BUNDLE must already exist. This subcommand adds to the bundle any check-ins that are descendants of check-ins already in the bundle, and any tags that apply to artifacts in the bundle.
vb bundle import¶
vb bundle import BUNDLE [--publish]
Description¶
Import all content from BUNDLE into the repository. By default, the imported files are private and will not sync. Use the –publish option to make the import public.
vb bundle ls¶
vb bundle ls BUNDLE
Description¶
List the contents of BUNDLE on standard output
vb bundle purge¶
vb bundle purge BUNDLE
Description¶
Remove from the repository all files that are used exclusively
by check-ins in BUNDLE. This has the effect of undoing a
vb bundle import.
See Also¶
See also
Examples¶
Export a bundle for the current check-in and list its contents
$ vb sys echo "a" > a.txt
$ vb add a.txt
ADDED a.txt
$ vb ci -m "base"
Committed version: cbb1818fe0cd2775896062ab64ebe45a8bf371db2703ebb8ff414eba4825a296
$ vb bundle export pack.vbb --checkin current
$ vb bundle ls pack.vbb
mtime: 2026-03-31 13:00:07
project-code: 0d53183e7398d5bd4e8f95a99af4fdc11e70aa35
------------------------------------------------------------------------------
be5215abf72333a7 file a.txt
cbb1818fe0cd2775 check-in to trunk by ubuntu on 2026-03-31 13:00