bregctl data import command reference
Import JSONL records through the ordinary authenticated batch API.
Contract status
Section titled “Contract status”This page is generated from the public Clap command tree for Registry Stack source version 0.46.0 and catalog SHA-256 d43b1bf418e0b00fac52311fa3a106fa124512dbc88cf511475713af2d73aa47. Hidden implementation commands are omitted.
bregctl data import [OPTIONS] --package <ABSOLUTE_DIRECTORY> --breg-url <URL> --access-token-file <ABSOLUTE_FILE> --record-type <ID> --profile <ID> --operation <OPERATION> --input <FILE> --checkpoint <FILE>Options
Section titled “Options”| Option | Always required | Default | Values | Environment | Description |
|---|---|---|---|---|---|
--package <ABSOLUTE_DIRECTORY> | Yes | n/a | n/a | n/a | Absolute closed package directory used only for deterministic planning. A symbolic link at any component of this path is refused. |
--breg-url <URL> | Yes | n/a | n/a | n/a | Base Registry Engine base URL. HTTP is accepted only for loopback hosts |
--access-token-file <ABSOLUTE_FILE> | Yes | n/a | n/a | n/a | File containing one bearer access token and no other credential material. A symbolic link at any component of this path is refused. |
--record-type <ID> | Yes | n/a | n/a | n/a | Compiled Record type identifier |
--profile <ID> | Yes | n/a | n/a | n/a | Compiled access profile identifier |
--operation <OPERATION> | Yes | n/a | create, patch | n/a | Import item operation |
--input <FILE> | Yes | n/a | n/a | n/a | JSON Lines import file. A symbolic link at any component of this path is refused. |
--checkpoint <FILE> | Yes | n/a | n/a | n/a | Import checkpoint file. A ctl-held .state sidecar is created beside it. A symbolic link at any component of this path is refused. |
--max-chunks <COUNT> | No | n/a | n/a | n/a | Stop after this many committed chunks, for resumable operator runs |
--format <FORMAT> | No | human | human, json | n/a | Emit the selected command’s report in this format |
-h, --help | No | n/a | n/a | n/a | Print help |
Generation contract
Section titled “Generation contract”After changing a public command, argument, option, default, environment binding, or help description, run cargo run --locked -p registry-cli-docs -- --write, commit crates/registry-cli-docs/catalog.json, then run npm run generate from docs/site.