pongo2

pongo2 is the successor of pongo, a Django-syntax like templating-language.

See my blog post announcement and migration tutorial for more.

Please use the issue tracker if you're encountering any problems with pongo2 or if you need help with implementing tags or filters (create a ticket!).

pongo2 is still in beta and under heavy development.

New in pongo2

Entirely rewritten from the ground-up.
Easy API to create new filters and tags (including parsing arguments); take a look on an example and the differences between pongo1 and pongo2: old and new.
Advanced C-like expressions.
Function calls within expressions from wherever you like.

What's missing

Several filters/tags (see filters_builtin.go and tags.go for a list of missing filters/tags). I try to implement the missing ones over time.
Tests
Documentation
Examples

Documentation

For a documentation on how the templating language works you can head over to the Django documentation. pongo2 aims to be fully compatible with it.

I still have to improve the pongo2-specific documentation over time. It will be available through godoc.

A tiny example (template string)

tpl, err := pongo2.FromString("Hello {{ name|capfirst }}!")
if err != nil {
	panic(err)
}
out, err := tpl.Execute(&pongo2.Context{"name": "florian"})
if err != nil {
	panic(err)
}
fmt.Println(out) // Output: Hello Florian!

Example server-usage (template file)

package main

import (
	"github.com/flosch/pongo2"
	"net/http"
)

var tplExample = pongo2.Must(pongo2.FromFile("example.html"))

func examplePage(w http.ResponseWriter, r *http.Request) {
	err := tplExample.ExecuteRW(w, &pongo2.Context{"query": r.FormValue("query")})
	if err != nil {
		http.Error(w, err.Error(), http.StatusInternalServerError)
	}
}

func main() {
	http.HandleFunc("/", examplePage)
	http.ListenAndServe(":8080", nil)
}