This Go Template Engine library introduces dynamic templating for Go applications, enabling variable interpolation and data manipulation with filters. Drawing inspiration from the syntax of Liquid and Django, it simplifies the generation of dynamic content.
Ensure you have Go set up on your system. To add the Go Template Engine to your project, run:
go get github.com/kaptinlin/templateThis command downloads the library and prepares it for use in your project.
Create and parse a template, then execute it with a context:
package main
import (
"fmt"
"github.com/kaptinlin/template"
)
func main() {
// Define your template
source := "Hello, {{ name }}!"
// Parse the template
tpl, err := template.Parse(source)
if err != nil {
panic(err)
}
// Create a context and add variables
context := template.NewContext()
context.Set("name", "World")
// Execute the template
output, err := template.Execute(tpl, context)
if err != nil {
panic(err)
}
fmt.Println(output) // Output: Hello, World!
}Directly parse and execute a template in one step:
package main
import (
"fmt"
"github.com/kaptinlin/template"
)
func main() {
// Define your template and context
source := "Goodbye, {{ name }}!"
context := template.NewContext()
context.Set("name", "Mars")
// Render the template
output, err := template.Render(source, context)
if err != nil {
panic(err)
}
fmt.Println(output) // Output: Goodbye, Mars!
}Execute a template and ignore any errors, useful for templates guaranteed not to fail:
package main
import (
"fmt"
"github.com/kaptinlin/template"
)
func main() {
// Define your template
source := "Welcome, {{ name }}!"
// Parse the template
tpl, err := template.Parse(source)
if err != nil {
panic(err)
}
// Create a context and add variables
context := template.NewContext()
context.Set("name", "Universe")
// MustExecute the template, ignoring errors
output := template.MustExecute(tpl, context)
fmt.Println(output) // Output: Welcome, Universe!
}Enclose variables in {{ }} to embed dynamic content:
{{ userName }}For extended syntax, refer to the documentation.
Use the pipe | to apply filters to variables:
Hello, {{ name|capitalize }}!Detailed usage can be found in the documentation.
Easily extend functionality by adding custom filters. For example, a filter to capitalize a string:
package main
import (
"github.com/kaptinlin/template"
"strings"
)
func capitalize(input interface{}, args ...string) (interface{}, error) {
s, ok := input.(string)
if !ok {
return input, nil
}
return strings.Title(s), nil
}
func init() {
template.RegisterFilter("capitalize", capitalize)
}Use the custom filter like so:
{{ "john doe"|capitalize }}Contexts pass variables to templates. Here’s how to create and use one:
context := template.NewContext()
context.Set("key", "value")Contributions to the template package are welcome. If you'd like to contribute, please follow the contribution guidelines.
This project is licensed under the MIT License - see the LICENSE file for details.
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent