cuelang.org/go@v0.10.1/pkg/tool/doc.txt (about)

     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: