GitHub - Masterminds/sprig: Useful template functions for Go templates.
source link: https://github.com/Masterminds/sprig
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
README.md
Sprig: Template functions for Go templates
The Go language comes with a built-in template language, but not very many template functions. Sprig is a library that provides more than 100 commonly used template functions.
It is inspired by the template functions found in Twig and in various JavaScript libraries, such as underscore.js.
Usage
Template developers: Please use Sprig's function documentation for detailed instructions and code snippets for the >100 template functions available.
Go developers: If you'd like to include Sprig as a library in your program, our API documentation is available at GoDoc.org.
For standard usage, read on.
Load the Sprig library
To load the Sprig FuncMap
:
import ( "github.com/Masterminds/sprig" "html/template" ) // This example illustrates that the FuncMap *must* be set before the // templates themselves are loaded. tpl := template.Must( template.New("base").Funcs(sprig.FuncMap()).ParseGlob("*.html") )
Calling the functions inside of templates
By convention, all functions are lowercase. This seems to follow the Go idiom for template functions (as opposed to template methods, which are TitleCase). For example, this:
{{ "hello!" | upper | repeat 5 }}
produces this:
HELLO!HELLO!HELLO!HELLO!HELLO!
Principles Driving Our Function Selection
We followed these principles to decide which functions to add and how to implement them:
- Use template functions to build layout. The following
types of operations are within the domain of template functions:
- Formatting
- Layout
- Simple type conversions
- Utilities that assist in handling common formatting and layout needs (e.g. arithmetic)
- Template functions should not return errors unless there is no way to print a sensible value. For example, converting a string to an integer should not produce an error if conversion fails. Instead, it should display a default value.
- Simple math is necessary for grid layouts, pagers, and so on. Complex math (anything other than arithmetic) should be done outside of templates.
- Template functions only deal with the data passed into them. They never retrieve data from a source.
- Finally, do not override core Go template functions.
Recommend
-
24
vim-helm vim syntax for helm templates (yaml + gotmpl + sprig + custom) Install via vundle: Plugin 'towolf/vim-helm'
-
68
README.md Squirrel - fluent SQL generator for Go import "github.com/Masterminds/squirrel"
-
51
README.md Glide: Vendor Package Management for Golang
-
3
Talk to Anders about C# Chapter 13 of the book Masterminds of Programming(中文译名: 编程之魂) When Microsoft settled a lawsuit from Sun Microsystems over changes to the Java programming languag...
-
2
Ready to Level up Your Business? Here Are 7 Masterminds You Should Consider Accelerate your growth and build a powerful network.
-
6
Hack Club Sprig
-
6
-
6
Test prototypes built with the tools you love
-
6
Learn from your user insights and product analytics together
-
4
Get real-time product learnings via Replays & GPT-powered AI
About Joyk
Aggregate valuable and interesting links.
Joyk means Joy of geeK