Skip to manual
gluon

CLI reference

gluon import

Verify a .gluonpkg and, only if every check passes, extract its src/ into DEST (a new directory).

Model author or developer

Usage

Run it as gluon import (in the repository, cargo run -p gluon-cli -- import).

Console / text
Verify a .gluonpkg and, only if every check passes, extract its src/ into DEST (a new directory)

Usage: gluon import --trust <TRUST> <ARCHIVE> <DEST>

Arguments:
  <ARCHIVE>
  <DEST>

Options:
      --trust <TRUST>  Trusted Ed25519 public keys (PEM)
  -h, --help           Print help

What it reads and writes

It checks the archive before writing anything: its size and checksums, that the signing key is one you pass with --trust and is not revoked, the signature, the GOL version range and the dependencies. Only when every check passes does it write the package's src/ into DEST. It refuses when DEST already exists or when a file would land outside DEST. It needs no database. To load a package into an environment, use gluon source import.

gluon import verifying the signed Contoso archive and unpacking it.
gluon import verifying the signed Contoso archive and unpacking it.