added global context, functions and importing

Author: CodeShellDev

.github/templates/README.template.md

@@ -31,7 +31,7 @@ Goplater uses Go's [builtin templating library](https://pkg.go.dev/text/template
 File Content: $​{​{​{ read "./myfile.txt" }​}​}
 ```
 
-### Functions
+### Simple Functions
 
 As you saw in the example above `read` is used for reading and output file contents.
 But there are more as you will see in the following…
@@ -161,6 +161,14 @@ Joins strings with separator.
 join "Apple" "Banana" "Strawberry" ", "
 ```
 
+#### `append`
+
+Appends another string to string.
+
+```
+append "Hello " "World!"
+```
+
 #### `regexMatch`
 
 Outputs wether string matches regex.
@@ -198,17 +206,109 @@ regexReplace "string" "replace_regex" "replace_with"
 Deletes an entry from a dictionary or array.
 
 ```
-
 delete map "key"
+```
+
+```
+delete array 0
+```
+
+#### `set`
 
+Sets key in dictionary or array to value.
+
+```
+set map "key" value
 ```
 
+```
+set array 0 value
 ```
 
-delete array 0
+#### `push`
+
+Pushes value onto top of array.
+
+```
+push array value
+```
+
+### Advanced Functions
+
+In addition to the function in the [Simple Functions](#simple-functions) section, there are also some functions for advanced usage.
+
+#### `import`
+
+Imports a file and executes it as template, output is discarded.
+
+```
+import "functions.inc.gtmpl"
+```
 
+#### `globalSet`
+
+Sets key globally to value.
+
+```
+globalSet "key" value
 ```
 
+#### `globalGet`
+
+Returns global value at key.
+
+#### `funcDefine`
+
+Defines a global function.
+
+```
+funcDefine "name" "{{{ return 0 "Hello World" }}}"
+```
+
+The second argument is the template body, notice the `{{{ ... }}}` instead of `${{{ ... }}}`.
+
+> [!WARNING]
+> You may need to escape some characters like `"` with `\`
+
+Raw output is discarded only output via [`return`](#return) persists.
+
+##### `return`
+
+> [!WARNING]
+> This function is **only** accessible from within functions!
+
+Sets return argument at index to value.
+
+```
+funcDefine "helloWorld" "{{{ return 0 "Hello World!" }}}"
+```
+
+Overwriting previous return arguments is possible.
+
+#### `funcCall`
+
+Calls a global function by its name (without passing any arguments).
+
+```
+
+funcCall "name"
+
+```
+
+Returns list of [`return`](#return) outputs in order of index.
+
+#### `funcCallArgs`
+
+Same as [`funcCall`](#funccall), but arguments can be passed.
+
+```
+
+funcCallArgs "name" arg1 arg2
+
+```
+
+Arguments are accessible in function body with `{{{ index .args 0 }}}`.
+
 ## Contributing
 
 Found a bug or just want to change or add something?
@@ -226,3 +326,11 @@ This Project is licensed under the [MIT License](./LICENSE).
 ## Legal
 
 Logo designed by [@CodeShellDev](https://github.com/codeshelldev) — All Rights Reserved. Go gopher mascot originally created by [Renée French](https://instagram.com/reneefrench/), used under the [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) license.
+
+```
+
+```
+
+```
+
+```

go.mod

@@ -18,6 +18,7 @@ require github.com/codeshelldev/gotl/pkg/stringutils v0.0.8 // indirect
 
 require (
 	github.com/andybalholm/cascadia v1.3.3 // indirect
+	github.com/google/uuid v1.6.0
 	github.com/inconshreveable/mousetrap v1.1.0 // indirect
 	github.com/spf13/pflag v1.0.9 // indirect
 	golang.org/x/net v0.47.0 // indirect

go.sum

@@ -10,6 +10,8 @@ github.com/codeshelldev/gotl/pkg/templating v0.0.16 h1:0dl/NEApCtlm4kyEscQPknx4D
 github.com/codeshelldev/gotl/pkg/templating v0.0.16/go.mod h1:MHM4ouEsLNKXRYO+fS9qqpS1SFlL4Z6Q/0kxtS+auLk=
 github.com/cpuguy83/go-md2man/v2 v2.0.6/go.mod h1:oOW0eioCTA6cOiMLiUPZOpcVxMig6NIQQ7OS05n1F4g=
 github.com/google/go-cmp v0.6.0/go.mod h1:17dUlkBOakJ0+DkrSSNjCkIjxS6bF9zb3elmeNGIjoY=
+github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
+github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
 github.com/inconshreveable/mousetrap v1.1.0 h1:wN+x4NVGpMsO7ErUn/mUI3vEoE6Jt13X2s0bqwp9tc8=
 github.com/inconshreveable/mousetrap v1.1.0/go.mod h1:vpF70FUmC8bwa3OWnCshd2FqLfsEA9PFc4w1p2J65bw=
 github.com/jessevdk/go-flags v1.6.1 h1:Cvu5U8UGrLay1rZfv/zP7iLpSHGUZ/Ou68T0iX1bBK4=

internals/template/core/core.go

@@ -1,6 +1,8 @@
 package core
 
-import "github.com/codeshelldev/goplater/internals/template/context"
+import (
+	"github.com/codeshelldev/goplater/internals/template/context"
+)
 
 var Renderer IRenderer
 var Matcher IMatcher

internals/template/funcs/container.go

@@ -0,0 +1,92 @@
+package funcs
+
+import (
+	"reflect"
+
+	"github.com/codeshelldev/goplater/internals/template/context"
+)
+
+var containerDeleteFunc = TemplateFunc{
+	Name: "delete",
+	Handler: func(context context.TemplateContext, container any, key any) any {
+		return deleteKey(container, key)
+	},
+}
+
+var containerSetFunc = TemplateFunc{
+	Name: "set",
+	Handler: func(context context.TemplateContext, container any, key any, value any) any {
+		return setKey(container, key, value)
+	},
+}
+
+var slicePushFunc = TemplateFunc{
+	Name: "push",
+	Handler: func(context context.TemplateContext, container []any, value any) any {
+		i := len(container) + 1
+
+		return setKey(container, i, value)
+	},
+}
+
+func deleteKey(data any, key any) any {
+	val := reflect.ValueOf(data)
+	if val.Kind() == reflect.Pointer {
+		val = val.Elem()
+	}
+
+	switch val.Kind() {
+	case reflect.Map:
+		for _, k := range val.MapKeys() {
+			if reflect.DeepEqual(k.Interface(), key) {
+				val.SetMapIndex(k, reflect.Value{})
+			}
+		}
+	case reflect.Slice:
+		newLen := 0
+
+		for i := 0; i < val.Len(); i++ {
+			if !reflect.DeepEqual(val.Index(i).Interface(), key) {
+				val.Index(newLen).Set(val.Index(i))
+
+				newLen++
+			}
+		}
+
+		val.Set(val.Slice(0, newLen))
+	}
+
+	return data
+}
+
+func setKey(data any, key any, value any) any {
+	val := reflect.ValueOf(data)
+	
+	if val.Kind() == reflect.Pointer {
+		val = val.Elem()
+	}
+
+	switch val.Kind() {
+	case reflect.Map:
+		val.SetMapIndex(reflect.ValueOf(key), reflect.ValueOf(value))
+	case reflect.Slice:
+		i, ok := key.(int)
+		
+		if ok && i >= 0 {
+			for val.Len() <= i {
+				val.Set(reflect.Append(val, reflect.Zero(val.Type().Elem())))
+			}
+
+			val.Index(i).Set(reflect.ValueOf(value))
+		}
+	}
+
+	return data
+}
+
+func init() {
+	Register(containerDeleteFunc)
+	Register(containerSetFunc)
+	
+	Register(slicePushFunc)
+}