feat: Add outputList template function

Resolves #4253

assets/chezmoi.io/docs/reference/templates/functions/output.md

@@ -1,6 +1,6 @@
 # `output` *name* [*arg*...]
 
-`output` returns the output of executing the command *name* with *arg*s. If
+`output` returns the output of executing the command _name_ with *arg*s. If
 executing the command returns an error then template execution exits with an
 error. The execution occurs every time that the template is executed. It is the
 user's responsibility to ensure that executing the command is both idempotent

assets/chezmoi.io/docs/reference/templates/functions/outputList.md

@@ -0,0 +1,19 @@
+# `outputList` *name* [*argList*]
+
+`outputList` returns the output of executing the command _name_ with the *argList*.
+*arg*s. If executing the command returns an error then template execution exits
+with an error. The execution occurs every time that the template is executed. It
+is the user's responsibility to ensure that executing the command is both
+idempotent and fast.
+
+This differs from [`output`](output.md) in that it allows for the `outputList`
+to be created programmatically. The list *must* be converted to a string list
+with `toStrings`.
+
+!!! example
+
+    ```
+    {{- $args := (list "config" "current-context") | toStrings }}
+    current-context: {{ output "kubectl" $args | trim }}
+    ```
+

assets/chezmoi.io/mkdocs.yml

@@ -224,6 +224,7 @@ nav:
       - lstat: reference/templates/functions/lstat.md
       - mozillaInstallHash: reference/templates/functions/mozillaInstallHash.md
       - output: reference/templates/functions/output.md
+      - outputList: reference/templates/functions/outputList.md
       - pruneEmptyDicts: reference/templates/functions/pruneEmptyDicts.md
       - quoteList: reference/templates/functions/quoteList.md
       - replaceAllRegex: reference/templates/functions/replaceAllRegex.md

internal/cmd/config.go

@@ -501,6 +501,7 @@ func newConfig(options ...configOption) (*Config, error) {
 		"onepasswordSDKItemsGet":       c.onepasswordSDKItemsGet,
 		"onepasswordSDKSecretsResolve": c.onepasswordSDKSecretsResolve,
 		"output":                       c.outputTemplateFunc,
+		"outputList":                   c.outputListTemplateFunc,
 		"pass":                         c.passTemplateFunc,
 		"passFields":                   c.passFieldsTemplateFunc,
 		"passRaw":                      c.passRawTemplateFunc,

internal/cmd/templatefuncs.go

@@ -340,6 +340,10 @@ func (c *Config) outputTemplateFunc(name string, args ...string) string {
 	return string(output)
 }
 
+func (c *Config) outputListTemplateFunc(name string, args []string) string {
+	return c.outputTemplateFunc(name, args...)
+}
+
 func (c *Config) pruneEmptyDictsTemplateFunc(dict map[string]any) map[string]any {
 	pruneEmptyMaps(dict)
 	return dict

internal/cmd/testdata/scripts/templatefuncs.txtar

@@ -138,6 +138,10 @@ stdout 2656FF1E876E9973
 [unix] exec chezmoi execute-template '{{ $red := output "generate-color-formats" "#ff0000" | fromJson }}{{ $red.rgb.r }}'
 [unix] stdout '^255$'
 
+# test the outputList and fromJson template functions
+[unix] exec chezmoi execute-template '{{ $red := outputList "generate-color-formats" (list "#ff0000" | toStrings) | fromJson }}{{ $red.rgb.r }}'
+[unix] stdout '^255$'
+
 # test that the output function returns an error if the command fails
 [unix] ! exec chezmoi execute-template '{{ output "false" }}'
 [unix] stderr 'error calling output: .*/false: exit status 1'