CLI command

probierz config

The decisions of this Probierz instance: where products live, where a browser may open, how repairs are delivered, budgets and targets.

Invocation#

Shell
probierz config <list|show|set|unset>

Required inputs and options#

  • The leaf must be list, show, set or unset. The keys are workspace, browser.placement, repair.delivery, repair.rounds, author.rounds, bisect.on-red, budget.host-seconds-per-day, budget.model-usd-per-day, oracle.accuracy-minimum, durations.slow-seconds, durations.reduction, status-page.availability, status-page.alarm-days, alerts.escalate-minutes (an open critical defect red again that many minutes after it paged pages again, counted as escalations on the defect; whether it is set or not, a green run that closes a paged critical defect pages that it is green again, kept as resolvedPage), alerts.escalate-to, alerts.escalate-from and alerts.escalate-organization (with all three, each escalation is also mailed to the next person, to, from the mailbox from of the mail organization through Stado's mail family; the mail is kept under test-results/<app>/escalations/ and the attempt as escalationMail on the defect, its cause when it was not sent; set only in part, nothing is mailed and escalationMail names the keys missing) and target.<measure>.

Output and state effects#

Keys live in config.json in Probierz's state directory on this host: PROBIERZ_STATE_DIR when set, else .probierz in the home directory. Nothing in the source or a manifest decides them.

Exact refusals#

  • Missing or unknown leaves return the group usage and exit 2.

Declared refusals#

What probierz refusals list declares for this command at revision d2cd6156e8b8dc6204dab7b46ec0b34b2bb03cea (probierz 0.1.7 (revision unknown, not built from a git checkout)): each cause's id, the operation declaring it, its exit status and code, and its remedy.

  • state-blank (probierz.config, exit 1, config): finding Probierz's state directory: PROBIERZ_STATE_DIR is set but blank, so it names no directory. set PROBIERZ_STATE_DIR to an absolute directory, or unset it so .probierz in the home directory is used.
  • state-relative (probierz.config, exit 1, config): finding Probierz's state directory: PROBIERZ_STATE_DIR names {path}, which is not an absolute path, so it would mean a different directory in every working directory. set PROBIERZ_STATE_DIR to an absolute directory.
  • unreadable (probierz.config, exit 1, config): reading this instance's configuration at {file}: the file cannot be read: {error}. make {file} a file this user can read, or remove it to set no key.
  • malformed (probierz.config, exit 1, config): reading this instance's configuration at {file}: the file is not a JSON object of keys: {error}. write {file} again with probierz config set, or remove it to set no key.
  • stored-unknown (probierz.config, exit 1, config): reading this instance's configuration at {file}: it holds {key}, which no part of this Probierz reads (a key a release before or after this one declared). remove it with probierz config unset {key}.
  • stored-invalid (probierz.config, exit 1, config): reading {key} from this instance's configuration at {file}: it holds {value}, which is not a {kind}. set it again with probierz config set {key} <value>, or remove it with probierz config unset {key}.
  • unwritable (probierz.config, exit 1, config): writing this instance's configuration at {file}: {step} failed: {error}. make {directory} a directory this user can write, or point PROBIERZ_STATE_DIR at one.
  • key-unknown (probierz.config, exit 2, refused): naming a configuration key: {key} is no key any part of Probierz reads. name one of the listed keys; probierz config list prints what each decides.
  • value-invalid (probierz.config, exit 2, refused): setting {key}: {value} is not a {kind}: {why}. give {key} a {kind}.

Source snapshot#

Generated from the Rust binaries at revision 99a74945a3598a8d73b6c6cbe5aae4f283becea3 of Probierz's private source repository.

Combined help SHA-256: 77529678a61237f774b59e76df0d1907cb749ef5da56d2ed913b040793b7d30b; binary SHA-256: be9e0eaff0e6ea50403a0c6f6d467697a4eac676f9523b8dc13a596d2b5526c5.