package generator
import "github.com/a-h/templ/generator"
Index ¶
- func HasGoChanged(previous, updated GeneratorOutput) bool
- func HasTextChanged(previous, updated GeneratorOutput) bool
- type GenerateOpt
- func WithFileName(name string) GenerateOpt
- func WithSkipCodeGeneratedComment() GenerateOpt
- func WithTimestamp(d time.Time) GenerateOpt
- func WithVersion(v string) GenerateOpt
- type GeneratorOptions
- type GeneratorOutput
- type RangeWriter
Functions ¶
func HasGoChanged ¶
func HasGoChanged(previous, updated GeneratorOutput) bool
HasGoChanged returns true if the Go code has changed between the previous and updated GeneratorOutput.
func HasTextChanged ¶
func HasTextChanged(previous, updated GeneratorOutput) bool
HasTextChanged returns true if the text literals have changed between the previous and updated GeneratorOutput.
Types ¶
type GenerateOpt ¶
type GenerateOpt func(g *generator) error
func WithFileName ¶
func WithFileName(name string) GenerateOpt
WithFileName sets the filename of the templ file in template rendering error messages.
func WithSkipCodeGeneratedComment ¶
func WithSkipCodeGeneratedComment() GenerateOpt
WithSkipCodeGeneratedComment skips the code generated comment at the top of the file. gopls disables edit related functionality for generated files, so the templ LSP may wish to skip generation of this comment so that gopls provides expected results.
func WithTimestamp ¶
func WithTimestamp(d time.Time) GenerateOpt
WithTimestamp enables the generated date to be included in the generated code.
func WithVersion ¶
func WithVersion(v string) GenerateOpt
WithVersion enables the version to be included in the generated code.
type GeneratorOptions ¶
type GeneratorOptions struct { // Version of templ. Version string // FileName to include in error messages if string expressions return an error. FileName string // SkipCodeGeneratedComment skips the code generated comment at the top of the file. SkipCodeGeneratedComment bool // GeneratedDate to include as a comment. GeneratedDate string }
type GeneratorOutput ¶
type GeneratorOutput struct { Options GeneratorOptions `json:"meta"` SourceMap *parser.SourceMap `json:"sourceMap"` Literals []string `json:"literals"` }
func Generate ¶
func Generate(template *parser.TemplateFile, w io.Writer, opts ...GenerateOpt) (op GeneratorOutput, err error)
Generate generates Go code from the input template file to w, and returns a map of the location of Go expressions in the template to the location of the generated Go code in the output.
type RangeWriter ¶
type RangeWriter struct { Current parser.Position Literals []string // contains filtered or unexported fields }
func NewRangeWriter ¶
func NewRangeWriter(w io.Writer) *RangeWriter
func (*RangeWriter) Write ¶
func (rw *RangeWriter) Write(s string) (r parser.Range, err error)
func (*RangeWriter) WriteIndent ¶
func (rw *RangeWriter) WriteIndent(level int, s string) (r parser.Range, err error)
func (*RangeWriter) WriteStringLiteral ¶
func (rw *RangeWriter) WriteStringLiteral(level int, s string) (r parser.Range, err error)
Source Files ¶
Directories ¶
- Version
- v0.3.924 (latest)
- Published
- Jul 26, 2025
- Platform
- linux/amd64
- Imports
- 15 packages
- Last checked
- 6 days ago –
Tools for package owners.