Documentation
¶
Overview ¶
Package tools resolves the external executables graith shells out to: git, gh, gcx, the notification shell, ps, and lsof. Historically these names and paths were hard-coded, which broke Nix/custom-PATH installs, wrapper binaries, and alternate shells (issue #1238).
A single process-wide resolver holds the effective set. The daemon and the stateless CLI configure it once at startup from the tools config block; every git/store/notification/resource call site then reads it. Reads are lock-free (an atomic snapshot) so the many concurrent daemon goroutines can resolve a tool without contention, and a startup Configure races with nothing because it runs before serving begins.
This is deliberately NOT a generic arbitrary-argv escape hatch: only the executable is configurable. Semantic subcommands (git rev-parse, gh api) and sandbox protocol flags stay in code.
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func Configure ¶
func Configure(c Config)
Configure installs the effective executable set, filling any empty field with its built-in default. It is intended to run once at startup before the daemon serves requests (or before the CLI runs a command). Calling it with the zero Config restores the built-in defaults.
func GCX ¶ added in v0.69.2
func GCX() string
GCX returns the configured Grafana Cloud CLI executable.
func Reset ¶
func Reset()
Reset restores the built-in defaults. It exists for tests that mutate the resolver and need to undo the change.
func Shell ¶
func Shell() string
Shell returns the configured shell used to run notification and trigger commands (invoked as `<shell> -c <command>`).
func Validate ¶
Validate checks that every explicitly-set field of c is resolvable, so a misconfigured tool fails loudly at startup rather than at the first git fetch or notification. Empty fields are skipped so defaults retain plain PATH-lookup semantics and are not errors until actually used.
A value containing a path separator (absolute or relative) must point at an existing, regular, executable file. A bare name must be found on PATH.
Source Files