Module extract 

Extract .tar.gz artifacts from the cache into the destination filesystem paths.

Two install shapes:

• Extension binary — pull one named member out of the tarball and atomic-rename it into <bin_dir>/<bin_name> with mode 0755.
• Lib tree — extract the whole tarball into <lib_dir>/<lib_name>/, replacing any existing tree at that path.

Tarball layout assumptions

• Extensions: tarball contains the binary as a top-level entry whose filename matches bin_name (e.g. an archive containing assay-engine).
• Libs: tarball contains the lib’s tree at the root (i.e. extracting the archive into a directory yields the lib’s contents directly, not a <name>/ wrapping directory).

The release pipeline (plan 21 phase 5) finalises both conventions.

Enums

ExtractError

Functions

install_extension_binary

Install one extension binary from archive_path into <bin_dir>/<bin_name> (mode 0755 on unix), replacing any existing file.

install_lib_tree

Install a Lua library tree from archive_path into <lib_dir>/<lib_name>/, replacing any existing tree at that path.