Apply Go templates to JSON or YAML data.
go install github.com/dolmen-go/goproc@latest
goproc [ -env | -env=true | -env=VAR ] -i <Go-template-file> [ <JSON-or-YAML-file> ]
goproc [ -env | -env=true | -env=VAR ] -e <Go-template-text> [ <JSON-or-YAML-file> ]
The default input is STDIN in JSON format. Use -yaml
flag to handle STDIN as YAML.
When an input file is given, the file extension determines if it is parsed as JSON or YAML.
In any case there is no magic detection (that usually lead to security issues).
See the Go templates documentation.
The Hugo documentation on Go templates may also be useful for a friendlier approach, but note that it contains references to features unique to Hugo (ex: partial
).
The following functions are available in addition to the standard functions.
This function must be explicitely enabled using the -env
flag:
-env
: enables theenv
function. Any environment variable can be used, but listing variables is blocked.-env=
: enables theenv
function, but whitelist of allowed variables is cleared (no variables allowed).-env=name1,name2
: enables theenv
function. Only the variablesname1
andname2
are visible in calls toenv
.
Usage:
{{ env "HOME" }} {{- /* Get value of HOME environment variable */}}
{{ "HOME" | env }} {{- /* Get value of HOME environment variable */}}
{{ range $name, $value := env "HOME" "LANG" -}}
{{ $name }}={{ $value }}
{{ end }}
Usage:
{{ error "message" }}
Example:
echo 0 | goproc -e '{{ error "fail!" }}'
template: :1:3: executing "" at <error "fail!">: error calling error: fail!
To ease the extraction of data, jsonptr
allows to express data location using
JSON Pointer (RFC 6901).
Usages:
{{ jsonptr "pointer" . }}
{{ . | jsonptr "pointer" }}
Examples:
goproc
testdata/02.gotmpl
testdata/02.json
goproc
testdata/03.gotmpl
testdata/03.json
Convert input to JSON.
Usage:
{{ json }}
Example:
echo '{"data": ["x"]}' | goproc -e '{{.data | json}}{{print "\n"}}'
["x"]
Convert input to YAML.
Usage:
{{ yaml }}
Example:
echo '{"data": ["x"]}' | goproc -e '{{.data | yaml}}'
- x
https://github.com/naotookuda/go-template-cli
Copyright 2018-2024 Olivier Mengué
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.