1// Package tool defines stateful operation types for cue commands.
2//
3// This package is only visible in cue files with a _tool.cue or _tool_test.cue
4// ending.
5//
6// CUE configuration files are not influenced by and do not influence anything
7// outside the configuration itself: they are hermetic. Tools solve
8// two problems: allow outside values such as environment variables,
9// file or web contents, random generators etc. to influence configuration,
10// and allow configuration to be actionable from within the tooling itself.
11// Separating these concerns makes it clear to user when outside influences are
12// in play and the tool definition can be strict about what is allowed.
13//
14// Tools are defined in files ending with _tool.cue. These files have a
15// top-level map, "command", which defines all the tools made available through
16// the cue command.
17//
18// The following definitions are for defining commands in tool files:
View as plain text