backend rework

Author: CodeShellDev

.github/templates/README.template.md

@@ -11,6 +11,7 @@
 - [Getting Started](#getting-started)
 - [Usage](#usage)
   - [String Functions](#string-functions)
+  - [Math Functions](#math-functions)
   - [Container Functions](#container-functions)
   - [Parser Functions](#parser-functions)
   - [Advanced Functions](#advanced-functions)
@@ -41,7 +42,7 @@ Goplater uses Go's [builtin templating library](https://pkg.go.dev/text/template
 **Example:**
 
 ```
-File Content: $​{​{​{ read "./myfile.txt" }​}​}
+File Content: +​{​{​{ read "./myfile.txt" }​}​}
 ```
 
 As you saw in the example above `read` is used for reading and output file contents.
@@ -58,18 +59,16 @@ where relative paths are relative to the invoker.
 read "path"
 ```
 
-##### `readOpts`
+#### `readArgs`
 
-Same as [`read`](#read) but with another parameter for additional arguments:
-
-| Short | Long          | Type   | Note                        |
-| ----- | ------------- | ------ | --------------------------- |
-| `-r`  | `--recursive` | `bool` | tries templating read files |
+Same as [`read`], but allows to supply additional arguments to the file for further processing.
 
 ```
-read "path" "--flag1" "--flag2"
+read "path" arg1 arg2 arg3
 ```
 
+Arguments are accessible in under `.args` with `{{{ index .args 0 }}}`.
+
 #### `fetch`
 
 Performs a get http request to the specified url.
@@ -242,6 +241,28 @@ Replaces substring via regex in string.
 regexReplace "string" "replace_regex" "replace_with"
 ```
 
+### Math Functions
+
+#### `add`
+
+Adds two numbers together.
+
+#### `sub`
+
+Subtraction for two numbers.
+
+#### `mult`
+
+Multiplies two numbers.
+
+#### `divd`
+
+Divides a through b.
+
+#### `mod`
+
+Performs a modulo b.
+
 ### Conversion Functions
 
 Functions for converting types.
@@ -274,6 +295,10 @@ The following are functions for slices and maps.
 
 Returns wether map or slice has key.
 
+#### `includes`
+
+Returns wether map or slice includes value.
+
 #### `delete`
 
 Deletes an entry from a map or slice.
@@ -467,7 +492,7 @@ Sets return output slice directly with **one slice**.
 returnOutputs slice
 ```
 
-##### `outputsGet`
+##### `getOutputs`
 
 Returns the whole output slice.
 
@@ -479,7 +504,7 @@ Calls a global function by its name (without passing any arguments).
 funcCall "name"
 ```
 
-Returns list of [`return`](#return) outputs in order of index.
+Returns list of [`return`](#return) outputs in order of index, or if applicable only a single output.
 
 #### `funcCallArgs`
 

go.mod

@@ -4,23 +4,18 @@ go 1.26.0
 
 require (
 	github.com/PuerkitoBio/goquery v1.11.0
-	github.com/jessevdk/go-flags v1.6.1
 	github.com/spf13/cobra v1.10.1
 )
 
 require (
 	github.com/codeshelldev/gotl/pkg/jsonutils v0.0.2
-	github.com/codeshelldev/gotl/pkg/templating v0.0.16
 	go.yaml.in/yaml/v4 v4.0.0-rc.4
 )
 
-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
-	golang.org/x/sys v0.38.0 // indirect
 )

go.sum

@@ -4,18 +4,12 @@ github.com/andybalholm/cascadia v1.3.3 h1:AG2YHrzJIm4BZ19iwJ/DAua6Btl3IwJX+VI4kk
 github.com/andybalholm/cascadia v1.3.3/go.mod h1:xNd9bqTn98Ln4DwST8/nG+H0yuB8Hmgu1YHNnWw0GeA=
 github.com/codeshelldev/gotl/pkg/jsonutils v0.0.2 h1:ERsjkaWVrsyUZoEunCEeNYDXhuaIvoSetB8e/zI4Tqo=
 github.com/codeshelldev/gotl/pkg/jsonutils v0.0.2/go.mod h1:oxgKaAoMu6iYVHfgR7AhkK22xbYx4K0KCkyVEfYVoWs=
-github.com/codeshelldev/gotl/pkg/stringutils v0.0.8 h1:VKIuEYLJARDmHyhAbcMy1TsdxPdzsKlbQvgr1G4QE7s=
-github.com/codeshelldev/gotl/pkg/stringutils v0.0.8/go.mod h1:892bcYDpOf0sTpXtABQ3m+9MACpWHCVpN3f/mcPr7qo=
-github.com/codeshelldev/gotl/pkg/templating v0.0.16 h1:0dl/NEApCtlm4kyEscQPknx4DwUtl1bsgl3Iyv6jPkM=
-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=
-github.com/jessevdk/go-flags v1.6.1/go.mod h1:Mk8T1hIAWpOiJiHa9rJASDK2UGWji0EuPGBnNLMooyc=
 github.com/russross/blackfriday/v2 v2.1.0/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM=
 github.com/spf13/cobra v1.10.1 h1:lJeBwCfmrnXthfAupyUTzJ/J4Nc1RsHC/mSRU2dll/s=
 github.com/spf13/cobra v1.10.1/go.mod h1:7SmJGaTHFVBY0jW4NXGluQoLvhqFQM+6XSKD+P4XaB0=
@@ -64,8 +58,6 @@ golang.org/x/sys v0.12.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
 golang.org/x/sys v0.17.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA=
 golang.org/x/sys v0.20.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA=
 golang.org/x/sys v0.28.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA=
-golang.org/x/sys v0.38.0 h1:3yZWxaJjBmCWXqhN1qh02AkOnCQ1poK6oF+a7xWL6Gc=
-golang.org/x/sys v0.38.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks=
 golang.org/x/telemetry v0.0.0-20240228155512-f48c80bd79b2/go.mod h1:TeRTkGYfJXctD9OcfyVLyj2J3IxLnKwHJR8f4D8a3YE=
 golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo=
 golang.org/x/term v0.0.0-20210927222741-03fcf44c2211/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8=

internals/template/context/context.go

@@ -1,5 +1,7 @@
 package context
 
+import "github.com/codeshelldev/goplater/pkg/templating"
+
 type TemplateOptions struct {
 	Output string
 	Source string
@@ -20,6 +22,8 @@ type TemplateContext struct {
 	Options		TemplateOptions
 }
 
+const TemplateContextKey templating.ContextKey = "templateContext"
+
 func New() TemplateContext {
 	return TemplateContext{ Options: TemplateOptions{ } }
 }