Bundles

Bundles are a named collection of assets.

Bundles are accessed with the get-bundle command described in a later section of the document.

Saving Bundles

When a value shell command reads an bundle and saves it to a file (ex. get-bundle -f FILE), the members of the bundle are zipped and the zip archive bytes are copied directly to the file. The standards of Zip Archive Reproducibility will be followed.

When a value shell command reads an bundle and saves it to a directory (ex. get-bundle -d DIR), the members of the bundle are copied into the directory tree.

That sounds inefficient, but the build system is allowed to optimize a set of value shell commands. For example, if one shell command saves output into a directory, and a second shell command reads data from created by the first shell command, the build system can give the second shell command a symlink to the first directory without using a zip archive as an intermediate artifact.