Text of pkg.go.dev › github.com › Masterminds › sprig as Styx crawled it on Nov 18, 2026. The page may have changed since. Only its words are kept, without pictures or layout.

Open the live page

sprig package - github.com/Masterminds/sprig - Go Packages

The highest tagged major version is v3 . README ¶ 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.

Documentation ¶ Overview ¶ Sprig: Template functions for Go. This package contains a number of utility functions for working with data inside of Go `html/template` and `text/template` files. To add these functions, use the `template.Funcs()` method: t := templates.New("foo").Funcs(sprig.FuncMap()) Note that you should add the function map before you parse any template files. In several cases, Sprig reverses the order of arguments from the way they appear in the standard library.

This is to make it easier to pipe arguments into functions. See http://masterminds.github.io/sprig/ for more detailed documentation on each of the available functions. Example ¶ // Set up variables and template. vars := map[string]interface{}{"Name": " John Jacob Jingleheimer Schmidt "} tpl := `Hello {{.Name | trim | lower}}` // Get the Sprig function map. fmap := TxtFuncMap() t := template.Must(template.New("test").Funcs(fmap).Parse(tpl)) err := t.Execute(os.Stdout, vars) if err != nil { fmt.Printf("Error during template execution: %s", err) return } Output: Hello john jacob jingleheimer schmidt Index ¶ func FuncMap() template.FuncMap func GenericFuncMap() map[string]interface{} func HermeticHtmlFuncMap() template.FuncMap func HermeticTxtFuncMap() ttemplate.FuncMap func HtmlFuncMap() template.FuncMap func TxtFuncMap() ttemplate.FuncMap type DSAKeyFormat Examples ¶ Package Constants ¶ This section is empty.

Variables ¶ This section is empty. Functions ¶ func FuncMap ¶ func FuncMap() template . FuncMap Produce the function map. Use this to pass the functions into the template engine: tpl := template.New("foo").Funcs(sprig.FuncMap())) func GenericFuncMap ¶ func GenericFuncMap() map[ string ]interface{} GenericFuncMap returns a copy of the basic function map as a map[string]interface{}. func HermeticHtmlFuncMap ¶ func HermeticHtmlFuncMap() template .

FuncMap HermeticHtmlFuncMap returns an 'html/template'.Funcmap with only repeatable functions. func HermeticTxtFuncMap ¶ func HermeticTxtFuncMap() ttemplate . FuncMap HermeticTxtFuncMap returns a 'text/template'.FuncMap with only repeatable functions. func HtmlFuncMap ¶ func HtmlFuncMap() template . FuncMap HtmlFuncMap returns an 'html/template'.Funcmap func TxtFuncMap ¶ func TxtFuncMap() ttemplate . FuncMap TxtFuncMap returns a 'text/template'.FuncMap Types ¶ type DSAKeyFormat ¶ type DSAKeyFormat struct { Version int P, Q, G, Y, X * big .

Int } Source Files ¶ View all Source files crypto.go date.go defaults.go dict.go doc.go functions.go list.go network.go numeric.go reflect.go regex.go semver.go strings.go url.go Click to show internal directories. Click to hide internal directories. go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.