- [+] add Execute0()

Author: suntong

easygen.go

@@ -152,7 +152,21 @@ func Process1(t Template, wr io.Writer, fileNameTempl string, fileName string) e
 	return Execute(t, wr, fileNameT, m)
 }
 
-// Execute will execute the Template on the given data map `m`.
+// Execute0 will execute the Template given as strTempl with the given data map `m` (i.e., no template file and no data file).
+// It parses text template strTempl then applies it to to the specified data
+// object m, and writes the output to wr. If an error occurs executing the
+// template or writing its output, execution stops, but partial results may
+// already have been written to the output writer. A template may be
+// executed safely in parallel, although if parallel executions share a
+// Writer the output may be interleaved.
+func Execute0(t Template, wr io.Writer, strTempl string, m EgData) error {
+	verbose("Execute with template string: "+strTempl, 1)
+	tmpl, err := t.Parse(strTempl)
+	checkError(err)
+	return tmpl.Execute(wr, m)
+}
+
+// Execute will execute the Template from fileNameT on the given data map `m`.
 func Execute(t Template, wr io.Writer, fileNameT string, m EgData) error {
 	// 1. Check locally
 	verbose("Checking for template locally: "+fileNameT, 1)

example_execute0_test.go

@@ -0,0 +1,41 @@
+package easygen_test
+
+import (
+	"fmt"
+	"os"
+	"strings"
+
+	"github.com/go-easygen/easygen"
+)
+
+// for standalone test, change package to `main` and the next func def to,
+// func main() {
+func ExampleExecute0_output() {
+	easygen.Opts.Debug = 1
+
+	tmpl := easygen.NewTemplate().Funcs(easygen.FuncDefs())
+
+	// define driving data of any tye
+	v0 := "some-init-method"
+	// https://godoc.org/github.com/go-easygen/easygen#Execute0
+	// provide template string, not file name
+	easygen.Execute0(tmpl, os.Stdout, "{{stringsToUpper .}}\n", v0)
+
+	// Demo of using driving data of pure slice/array
+	v1 := []string{"red", "blue", "white"}
+	easygen.Execute0(tmpl, os.Stdout, "The colors are: {{range .}}{{.}}, {{end}}.\n", v1)
+
+	// Demo output to string
+	var b strings.Builder
+	easygen.Execute0(tmpl, &b, "The colors are: {{range $i, $color := .}}{{$color}}{{if lt $i ($ | len | minus1)}}, {{end}}{{end}}.\n", v1)
+	fmt.Print(b.String())
+
+	// Output:
+	// SOME-INIT-METHOD
+	// The colors are: red, blue, white, .
+	// The colors are: red, blue, white.
+}
+
+// To show the full code in GoDoc
+type dummyExecute0 struct {
+}

example_execute_test.go

@@ -8,6 +8,7 @@ import (
 	"github.com/go-easygen/easygen"
 	"github.com/go-easygen/easygen/egCal"
 	"github.com/go-easygen/easygen/egVar"
+	"gopkg.in/easygen.v2/egFilePath"
 )
 
 type variable struct {
@@ -16,11 +17,12 @@ type variable struct {
 
 // for standalone test, change package to `main` and the next func def to,
 // func main() {
-func ExampleExecute() {
+func ExampleExecute_output() {
 	easygen.Opts.Debug = 1
 
 	tmpl0 := easygen.NewTemplate().Customize()
-	tmpl := tmpl0.Funcs(easygen.FuncDefs()).Funcs(egVar.FuncDefs()).Funcs(egCal.FuncDefs())
+	tmpl := tmpl0.Funcs(easygen.FuncDefs()).Funcs(egFilePath.FuncDefs()).
+		Funcs(egVar.FuncDefs()).Funcs(egCal.FuncDefs())
 
 	// define driving data of any tye
 	v0 := variable{"some-init-method"}
@@ -44,7 +46,3 @@ func ExampleExecute() {
 	// The colors are: red, blue, white, .
 	// The colors are: red, blue, white.
 }
-
-// To show the full code in GoDoc
-type dummyExecute struct {
-}