A tool to be used with ‘go generate’ to embed external template files into Go code.
An often used scenario in developing go applications is to generate text (e.g. html pages) using the Go template packages. You have two choices: either editing the template in a dedicated file and to read this file at runtime from your application. Or you add a “big” string containing the template to the source of your app and parse this string to create the template.
If you want to create a single file application, then the more handy solution with a dedicated file is not desirable. On the other hand to edit a complex html template within a Go string in the source is very uncomfortable.
templify allows you to edit your template in an extra file and to generate an Go source file containing the embedded string.
go get github.com/wlbr/templify
Simply add a line
//go:generate templify mytemplate.file
for each template you want to embed. Every time you run a
go generate in the corresponding folder, the file
mytemplate.go will be created. It contains a function
mytemplateTemplate returning the template string.
You may use
templify mytemplate.file directly on the command line.
Usage of templify:
templify [switches] templatefilename
export the generated, the template returning function. Default (false) means the function will not be exported.
no formatting of the generated source. Default false means source will be formatted with gofmt.
name of generated, the template returning function. Its name will have ‘Template’ attached. Will be set to $(basename -s .ext outputfile) if empty (default).
name of output file. Defaults to name of template file excluding extension + ‘.go’.
name of package to be used in generated code (default “main”).
name of alternate code generation template file. If empty (default), then the embedded template will be used. Template variables supplied are: .Name, .Package, .Content
- Documentation: https://godoc.org/github.com/wlbr/templify
- Lint: http://go-lint.appspot.com/github.com/wlbr/templify
- Continous Integration:
- Test Coverage: