cmd/cue: add a testscript for --inject-vars

The feature is documented in `cue help injection` but we lacked
any sort of reasonable integration tests.

This results from having answered questions about this feature
a few times recently on Slack and Discord, and feeling a bit uneasy
about how we had no tests to rely on. Moreover, the testscript also
doubles as something we can point people to as proof that it works.

Signed-off-by: Daniel Martí <[email protected]>
Change-Id: If6cd81041357727fbab913c60abb06f4af9e48c2
Dispatch-Trailer: {"type":"trybot","CL":1214341,"patchset":3,"ref":"refs/changes/41/1214341/3","targetBranch":"master"}

Author: mvdan

cmd/cue/cmd/testdata/script/cmd_tags.txtar

@@ -6,9 +6,10 @@ cmp stdout expect-stdout
 exec cue cmd tag tags.cue tags_tool.cue -t prod -t name=bar
 cmp stdout expect-stdout
 
-# Verify that the new global -t flag added as a fix for issue 2510 above
-# works with the explicit or implicit "cmd" sub-command,
-# but not with other sub-commands like "fmt".
+# Verify that the global -t flag works with commands like "cmd"
+# or "eval", but not "fmt".
+exec cue -t prod -t name=bar cmd tag tags.cue tags_tool.cue
+cmp stdout expect-stdout
 exec cue eval -t name=bar tags.cue
 stdout 'name: *"bar"'
 exec cue -t name=bar eval tags.cue

cmd/cue/cmd/testdata/script/cmd_tags_vars.txtar

@@ -0,0 +1,69 @@
+# Test each of the variables injected by --inject-vars/-T.
+cd cwd_subdir
+exec cue export -T
+cmpenv stdout ../export.stdout
+cd ..
+
+# Validate the username and hostname against the standard Linux tools.
+# We could validate against os/user.Current and os.Hostname,
+# but that's the cmd/cue implementation, so it'd be a bit of a silly test.
+# Note that "whoami" on Windows prints "domain\username" so it's unhelpful.
+[!windows] [exec:whoami] exec whoami
+cp stdout whoami.stdout
+exec cue export -e username --out text -T username.cue
+stdout '^[^"]+$'
+[!windows] [exec:whoami] cmp stdout whoami.stdout
+[exec:hostname] exec hostname
+cp stdout hostname.stdout
+exec cue export -e hostname --out text -T hostname.cue
+stdout '^[^"]+$'
+[exec:hostname] cmp stdout hostname.stdout
+
+# A random number is not deterministic by nature,
+# but we can validate that two consecutive runs with a random 128-bit integer
+# are extremely unlikely to result in the same random number.
+exec cue export -T rand.cue
+stdout '"rand": \d+'
+cp stdout rand-previous.stdout
+exec cue export -T rand.cue
+! cmp stdout rand-previous.stdout
+-- cwd_subdir/input.cue --
+package p
+
+import (
+	"path"
+	"time"
+)
+
+// The current time is constantly changing,
+// so simply check that it's valid and between 2020 and 3000.
+_now: string @tag(now,var=now)
+_parts: time.Split(_now)
+nowValidYear: _parts.year > 2020 && _parts.year < 3000
+
+// The current directory will include a temporary directory,
+// so extract the basename only, which we can control here.
+// Convert Windows path separators to slashes first, for consistent results.
+_cwd: string @tag(cwd,var=cwd)
+cwdBase: path.Base(path.ToSlash(_cwd, path.Windows), path.Unix)
+
+// os and arch are just Go's GOOS and GOARCH, validated via cmpenv.
+os: string @tag(os,var=os)
+arch: string @tag(arch,var=arch)
+
+-- username.cue --
+username: string @tag(username,var=username)
+
+-- hostname.cue --
+hostname: string @tag(hostname,var=hostname)
+
+-- rand.cue --
+rand: int @tag(rand,var=rand)
+
+-- export.stdout --
+{
+    "nowValidYear": true,
+    "cwdBase": "cwd_subdir",
+    "os": "${GOOS}",
+    "arch": "${GOARCH}"
+}