gtf is a useful set of Golang Template Functions. The goal of this project is implementing all built-in template filters of Django & Jinja2.

gtf.New is a wrapper function of template.New. It automatically adds the gtf functions to the template's function map and returns template.Template.

package main

import (
	"net/http"
	"github.com/leekchan/gtf"
)

func main() {
    http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
		filesize := 554832114
		tpl, _ := gtf.New("test").Parse("{{ . | filesizeformat }}")
		tpl.Execute(w, filesize)
	})
    http.ListenAndServe(":8080", nil)
}

You can also add the gtf functions to the existing template(html/template package). Just call ".Funcs(gtf.GtfFuncMap)".

package main

import (
	"net/http"
	"html/template"
	
	"github.com/leekchan/gtf"
)

func main() {
    http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
		filesize := 554832114
		tpl, _ := template.New("test").Funcs(gtf.GtfFuncMap).Parse("{{ . | filesizeformat }}")
		tpl.Execute(w, filesize)
	})
    http.ListenAndServe(":8080", nil)
}

When you use the "text/template" package, call ".Funcs(gtf.GtfTextFuncMap)".

package main

import (
	"os"
	"text/template"
	
	"github.com/leekchan/gtf"
)

func main() {
	filesize := 554832114
	tpl, _ := template.New("test").Funcs(gtf.GtfTextFuncMap).Parse("{{ . | filesizeformat }}")
	tpl.Execute(os.Stdout, filesize)
}

You can use gtf with any web frameworks (revel, beego, martini, gin, etc) which use the Golang's built-in html/template package.

You can inject gtf functions into your webframework's original FuncMap by calling "gtf.Inject" / "gtf.ForceInject" / "gtf.InjectWithPrefix".

gtf.Inject injects gtf functions into the passed FuncMap. It does not overwrite the original function which have same name as a gtf function.

Inject(originalFuncMap)

gtf.ForceInject injects gtf functions into the passed FuncMap. It overwrites the original function which have same name as a gtf function.

ForceInject(originalFuncMap)

gtf.Inject injects gtf functions into the passed FuncMap. It prefixes the gtf functions with the specified prefix. If there are many function which have same names as the gtf functions, you can use this function to prefix the gtf functions.

InjectWithPrefix(originalFuncMap, "gtf_") // prefix : gtf_

Calling "gtf.Inject(revel.TemplateFuncs)" injects gtf functions into revel.TemplateFuncs. Just add this one line in init() of init.go, and use gtf functions in your templates! :)

// init.go

package app

import "github.com/revel/revel"
import "github.com/leekchan/gtf"

func init() {
    gtf.Inject(revel.TemplateFuncs)
}

Add these three lines before "beego.Run()" in your main() function. This code snippet will inject gtf functions into beego's FuncMap.

for k, v := range gtf.GtfFuncMap {
    beego.AddFuncMap(k, v)
}

Full example:

package main

import (
    "github.com/astaxie/beego"
    "github.com/beego/i18n"

    "github.com/beego/samples/WebIM/controllers"
    
    "github.com/leekchan/gtf"
)

const (
    APP_VER = "0.1.1.0227"
)

func main() {
    beego.Info(beego.AppName, APP_VER)

    // Register routers.
    beego.Router("/", &controllers.AppController{})
    // Indicate AppController.Join method to handle POST requests.
    beego.Router("/join", &controllers.AppController{}, "post:Join")

    // Long polling.
    beego.Router("/lp", &controllers.LongPollingController{}, "get:Join")
    beego.Router("/lp/post", &controllers.LongPollingController{})
    beego.Router("/lp/fetch", &controllers.LongPollingController{}, "get:Fetch")

    // WebSocket.
    beego.Router("/ws", &controllers.WebSocketController{})
    beego.Router("/ws/join", &controllers.WebSocketController{}, "get:Join")

    // Register template functions.
    beego.AddFuncMap("i18n", i18n.Tr)
    
    // Register gtf functions.
    for k, v := range gtf.GtfFuncMap {
        beego.AddFuncMap(k, v)
    }

    beego.Run()
}

I will add the detailed integration guides for other web frameworks soon!

All gtf functions have their own recovery logics. The basic behavior of the recovery logic is silently swallowing all unexpected panics. All gtf functions would not make any panics in runtime. (Production Ready!)

If a panic occurs inside a gtf function, the function will silently swallow the panic and return "" (empty string). If you meet any unexpected empty output, please make an issue! :)

• replace
• findreplace
• default
• length
• lower
• upper
• truncatechars
• urlencode
• wordcount
• divisibleby
• lengthis
• trim
• capfirst
• pluralize
• yesno
• rjust
• ljust
• center
• filesizeformat
• apnumber
• intcomma
• ordinal
• first
• last
• join
• slice
• random
• striptags

Removes all values of arg from the given string.

• supported value types : string
• supported argument types : string

{{ value | replace " " }}

If value is "The Go Programming Language", the output will be "TheGoProgrammingLanguage".

Replaces all instances of the first argument with the second.

• supported value types : string
• supported argument types : string

{{ value | findreplace " " "-" }}

If value is "The Go Programming Language", the output will be "The-Go-Programming-Language".

1. If the given string is ""(empty string), uses the given default argument.
2. If the given array/slice/map is empty, uses the given default argument.
3. If the given boolean value is false, uses the given default argument.

• supported value types : string, array, slice, map, boolean
• supported argument types : all

{{ value | default "default value" }}

If value is ""(the empty string), the output will be "default value".

Returns the length of the given string/array/slice/map.

• supported value types : string, array, slice, map

This function also supports unicode strings.

{{ value | length }}

If value is "The Go Programming Language", the output will be 27.

Converts the given string into all lowercase.

• supported value types : string

{{ value | lower }}

If value is "The Go Programming Language", the output will be "the go programming language".

Converts the given string into all uppercase.

• supported value types : string

{{ value | upper }}

If value is "The Go Programming Language", the output will be "THE GO PROGRAMMING LANGUAGE".

Truncates the given string if it is longer than the specified number of characters. Truncated strings will end with a translatable ellipsis sequence ("...")

• supported value types : string

Argument: Number of characters to truncate to

This function also supports unicode strings.

{{ value | truncatechars 12 }}

Examples

1. If input is {{ "The Go Programming Language" | truncatechars 12 }}, the output will be "The Go Pr...". (basic string)
2. If input is {{ "안녕하세요. 반갑습니다." | truncatechars 12 }}, the output will be "안녕하세요. 반갑...". (unicode)
3. If input is {{ "안녕하세요. The Go Programming Language" | truncatechars 30 }}, the output will be "안녕하세요. The Go Programming L...". (unicode)
4. If input is {{ "The" | truncatechars 30 }}, the output will be "The". (If the length of the given string is shorter than the argument, the output will be the original string.)
5. If input is {{ "The Go Programming Language" | truncatechars 3 }}, the output will be "The". (If the argument is less than or equal to 3, the output will not contain "...".)
6. If input is {{ "The Go" | truncatechars -1 }}, the output will be "The Go". (If the argument is less than 0, the argument will be ignored.)

Escapes the given string for use in a URL.

• supported value types : string

{{ value | urlencode }}

If value is "http://www.example.org/foo?a=b&c=d", the output will be "http%3A%2F%2Fwww.example.org%2Ffoo%3Fa%3Db%26c%3Dd".

Returns the number of words.

• supported value types : string

{{ value | wordcount }}

If value is "The Go Programming Language", the output will be 4.

Returns true if the value is divisible by the argument.

• supported value types : int, int8, int16, int32, int64, uint, uint8, uint16, uint32, uint64, float32, float64
• supported argument types : int, int8, int16, int32, int64, uint, uint8, uint16, uint32, uint64, float32, float64

{{ value | divisibleby 3 }}

Examples

1. If input is {{ 21 | divisibleby 3 }}, the output will be true.
2. If input is {{ 21 | divisibleby 4 }}, the output will be false.
3. If input is {{ 3.0 | divisibleby 1.5 }}, the output will be true.

Returns true if the value's length is the argument, or false otherwise.

• supported value types : string, array, slice, map
• supported argument types : int

{{ value | lengthis 3 }}

This function also supports unicode strings.

Examples

1. If input is {{ "Go" | lengthis 2 }}, the output will be true.
2. If input is {{ "안녕하세요. Go!" | lengthis 10 }}, the output will be true.

Strips leading and trailing whitespace.

• supported value types : string

{{ value | trim }}

Capitalizes the first character of the given string.

• supported value types : string

{{ value | capfirst }}

If value is "the go programming language", the output will be "The go programming language".

Returns a plural suffix if the value is not 1. You can specify both a singular and plural suffix, separated by a comma.

Argument: singular and plural suffix.

1. "s" --> specify a singular suffix.
2. "y,ies" --> specify both a singular and plural suffix.

• supported value types : int, int8, int16, int32, int64, uint, uint8, uint16, uint32, uint64
• supported argument types : string

{{ value | pluralize "s" }}
{{ value | pluralize "y,ies" }}

Examples

1. You have 0 message{{ 0 | pluralize "s" }} --> You have 0 messages
2. You have 1 message{{ 1 | pluralize "s" }} --> You have 1 message
3. 0 cand{{ 0 | pluralize "y,ies" }} --> 0 candies
4. 1 cand{{ 1 | pluralize "y,ies" }} --> 1 candy
5. 2 cand{{ 2 | pluralize "y,ies" }} --> 2 candies

Returns argument strings according to the given boolean value.

• supported value types : boolean
• supported argument types : string

Argument: any value for true and false

{{ value | yesno "yes!" "no!" }}

Right-aligns the given string in a field of a given width. This function also supports unicode strings.

• supported value types : string

{{ value | rjust 10 }}

Examples

1. If input is {{ "Go" | rjust 10 }}, the output will be "        Go".
2. If input is {{ "안녕하세요" | rjust 10 }}, the output will be "     안녕하세요".

Left-aligns the given string in a field of a given width. This function also supports unicode strings.

• supported value types : string

{{ value | ljust 10 }}

Examples

1. If input is {{ "Go" | ljust 10 }}, the output will be "Go        ".
2. If input is {{ "안녕하세요" | ljust 10 }}, the output will be "안녕하세요     ".

Centers the given string in a field of a given width. This function also supports unicode strings.

• supported value types : string

{{ value | center 10 }}

Examples

1. If input is {{ "Go" | center 10 }}, the output will be "    Go    ".
2. If input is {{ "안녕하세요" | center 10 }}, the output will be "  안녕하세요   ".

Formats the value like a human readable file size.

• supported value types : int, int8, int16, int32, int64, uint, uint8, uint16, uint32, uint64, float32, float64

{{ value | filesizeformat }}

Examples

1. {{ 234 | filesizeformat }} --> "234 bytes"
2. {{ 12345 | filesizeformat }} --> "12.1 KB"
3. {{ 12345.35335 | filesizeformat }} --> "12.1 KB"
4. {{ 1048576 | filesizeformat } --> "1 MB"
5. {{ 554832114 | filesizeformat }} --> "529.1 MB"
6. {{ 14868735121 | filesizeformat }} --> "13.8 GB"
7. {{ 14868735121365 | filesizeformat }} --> "13.5 TB"
8. {{ 1486873512136523 | filesizeformat }} --> "1.3 PB"

For numbers 1-9, returns the number spelled out. Otherwise, returns the number.

• supported value types : int, int8, int16, int32, int64, uint, uint8, uint16, uint32, uint64

{{ value | apnumber }}

Examples

1. {{ 1 | apnumber }} --> one
2. {{ 2 | apnumber }} --> two
3. {{ 3 | apnumber }} --> three
4. {{ 9 | apnumber }} --> nine
5. {{ 10 | apnumber }} --> 10
6. {{ 1000 | apnumber }} --> 1000

Converts an integer to a string containing commas every three digits.

• supported value types : int, int8, int16, int32, int64, uint, uint8, uint16, uint32, uint64

{{ value | intcomma }}

Examples

1. {{ 1000 | intcomma }} --> 1,000
2. {{ -1000 | intcomma }} --> -1,000
3. {{ 1578652313 | intcomma }} --> 1,578,652,313

Converts an integer to its ordinal as a string.

• supported value types : int, int8, int16, int32, int64, uint, uint8, uint16, uint32, uint64

{{ value | ordinal }}

Examples

1. {{ 1 | ordinal }} --> 1st
2. {{ 2 | ordinal }} --> 2nd
3. {{ 3 | ordinal }} --> 3rd
4. {{ 11 | ordinal }} --> 11th
5. {{ 12 | ordinal }} --> 12th
6. {{ 13 | ordinal }} --> 13th
7. {{ 14 | ordinal }} --> 14th

Returns the first item in the given value.

• supported value types : string, slice, array

This function also supports unicode strings.

{{ value | first }}

Examples

1. If value is the string "The go programming language", the output will be the string "T".
2. If value is the string "안녕하세요", the output will be the string "안". (unicode)
3. If value is the slice []string{"go", "python", "ruby"}, the output will be the string "go".
4. If value is the array [3]string{"go", "python", "ruby"}, the output will be the string "go".

Returns the last item in the given value.

• supported value types : string, slice, array

This function also supports unicode strings.

{{ value | last }}

Examples

1. If value is the string "The go programming language", the output will be the string "e".
2. If value is the string "안녕하세요", the output will be the string "요". (unicode)
3. If value is the slice []string{"go", "python", "ruby"}, the output will be the string "ruby".
4. If value is the array [3]string{"go", "python", "ruby"}, the output will be the string "ruby".

Concatenates the given slice to create a single string. The given argument (separator) will be placed between elements in the resulting string.

{{ value | join " " }}

If value is the slice []string{"go", "python", "ruby"}, the output will be the string "go python ruby"

Returns a slice of the given value. The first argument is the start position, and the second argument is the end position.

• supported value types : string, slice
• supported argument types : int

This function also supports unicode strings.

{{ value | slice 0 2 }}

Examples

1. If input is {{ "The go programming language" | slice 0 6 }}, the output will be "The go".
2. If input is {{ "안녕하세요" | slice 0 2 }}, the output will be "안녕". (unicode)
3. If input is {{ []string{"go", "python", "ruby"} | slice 0 2 }}, the output will be []string{"go", "python"}.

Returns a random item from the given value.

• supported value types : string, slice, array

This function also supports unicode strings.

{{ value | random }}

Examples

1. If input is {{ "The go programming language" | random }}, the output could be "T".
2. If input is {{ "안녕하세요" | random }}, the output could be "안". (unicode)
3. If input is {{ []string{"go", "python", "ruby"} | random }}, the output could be "go".
4. If input is {{ [3]string{"go", "python", "ruby"} | random }}, the output could be "go".

Returns a random integer value between the first and second argument

• supported value types : int

{{ value | randomintrange 0 5}}

Examples

1. If input is {{ randomintrange 0 5 }}, the output could be "4".

Makes all possible efforts to strip all [X]HTML tags from given value.

• supported value types : string

This function also supports unicode strings.

{{ value | striptags }}

Examples

1. If input is {{ "<strong>text</strong>" | striptags }}, the output will be "text".
2. If input is {{ "<strong><em>안녕하세요</em></strong>" | striptags }}, the output will be "안녕하세요". (unicode)
3. If input is {{ "<a href="/link">text <strong>안녕하세요</strong></a>" | striptags }}, the output will be "text 안녕하세요".

The first goal is implementing all built-in template filters of Django & Jinja2.

• Django | Built-in filter reference
• Jinja2 | List of Builtin Filters

The final goal is building a ultimate set which contains hundreds of useful template functions.

I love pull requests :) You can add any useful template functions by submitting a pull request!