Merge remote-tracking branch 'origin/develop' into develop

Author: varndellwagglebee

Hyperbee.Templating.sln

@@ -34,6 +34,8 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Hyperbee.Templating.Benchma
 EndProject
 Project("{D954291E-2A0B-460D-934E-DC6B0785DB48}") = "docs", "docs\docs.shproj", "{8409DDE0-C540-4A94-BF7F-9403888BEDAC}"
 EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Hyperbee.Templating.Provider.XS", "src\Hyperbee.Templating.Provider.XS\Hyperbee.Templating.Provider.XS.csproj", "{EA264696-D88A-288E-0D8E-C834780D5F9E}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -52,6 +54,10 @@ Global
 		{EB7D2A85-3C82-444A-84CD-D245DCF951CE}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{EB7D2A85-3C82-444A-84CD-D245DCF951CE}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{EB7D2A85-3C82-444A-84CD-D245DCF951CE}.Release|Any CPU.Build.0 = Release|Any CPU
+		{EA264696-D88A-288E-0D8E-C834780D5F9E}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{EA264696-D88A-288E-0D8E-C834780D5F9E}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{EA264696-D88A-288E-0D8E-C834780D5F9E}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{EA264696-D88A-288E-0D8E-C834780D5F9E}.Release|Any CPU.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE

README.md

@@ -1,8 +1,7 @@
 # Hyperbee Templating
 
 Hyperbee Templating is a lightweight templating and variable substitution syntax engine. The library supports value replacements, 
-code expressions, token nesting, in-line definitions, conditional flow, and looping. It is designed to be lightweight and fast, 
-and does not rely on any external dependencies.
+code expressions, token nesting, in-line definitions, conditional flow, and looping. It is designed to be lightweight and fast.
 
 ## Features
 
@@ -33,34 +32,32 @@ dotnet add package Hyperbee.Templating
 You can use the `TemplateParser` to perform variable substitutions.
 
 ```csharp
-var parser = new TemplateParser
+var template = "hello {{name}}.";
+
+var result = Template.Render(template, new()
 {
     Variables =
     {
         ["name"] = "me"
     }
-};
-
-var template = "hello {{name}}.";
+});
 
-var result = parser.Render(template);
 Console.WriteLine(result); // Output: hello me.
 ```
 
 ### Expression Substitution
 
 ```csharp
-var parser = new TemplateParser
+var template = "hello {{x => x.name.ToUpper()}}.";
+
+var result = Template.Render(template, new()
 {
     Variables =
     {
         ["name"] = "me"
     }
-};
-
-var template = "hello {{x => x.name.ToUpper()}}.";
+});
 
-var result = parser.Render(template);
 Console.WriteLine(result); // Output: hello ME.
 ```
 
@@ -69,19 +66,18 @@ Console.WriteLine(result); // Output: hello ME.
 Token values can contain other tokens.
 
 ```csharp
-var parser = new TemplateParser
+var template = "hello {{fullname}}.";
+
+var result = Template.Render(template, new()
 {
     Variables =
     {
         ["fullname"] = "{{first}} {{last}}",
         ["first"] = "Hari",
         ["last"] = "Seldon"
     }
-};
-
-var template = "hello {{fullname}}.";
+});
 
-var result = parser.Render(template);
 Console.WriteLine(result); // Output: hello Hari Seldon.
 ```
 
@@ -90,35 +86,33 @@ Console.WriteLine(result); // Output: hello Hari Seldon.
 You can use conditional tokens to control the flow based on conditions.
 
 ```csharp
-var parser = new TemplateParser
+var template = "{{#if condition}}hello {{name}}.{{/if}}";
+
+var result = Template.Render(template, new()
 {
     Variables =
     {
         ["condition"] = "true",
         ["name"] = "me"
     }
-};
-
-var template = "{{#if condition}}hello {{name}}.{{/if}}";
+});
 
-var result = parser.Render(template);
 Console.WriteLine(result); // Output: hello me.
 ```
 
 ```csharp
-var parser = new TemplateParser
+var template = "hello {{#if condition}}{{name1}}{{else}}{{name2}}{{/if}}.";
+
+var result = Template.Render(template, new()
 {
     Variables =
     {
         ["condition"] = "false",
         ["name1"] = "me",
         ["name2"] = "you",
     }
-};
-
-var template = "hello {{#if condition}}{{name1}}{{else}}{{name2}}{{/if}}.";
+});
 
-var result = parser.Render(template);
 Console.WriteLine(result); // Output: hello you.
 ```
 
@@ -127,17 +121,16 @@ Console.WriteLine(result); // Output: hello you.
 You can use a while statement to repeat a block of text while a condition is true.
 
 ```csharp
-var parser = new TemplateParser
+var template = "{{while x => x.counter<int> < 3}}{{counter}}{{counter:{{x => x.counter<int> + 1}}}}{{/while}}";
+
+var result = Template.Render(template, new()
 {
     Variables =
     {
         ["counter"] = "0"
     }
-};
-
-var template = "{{while x => x.counter<int> < 3}}{{counter}}{{counter:{{x => x.counter<int> + 1}}}}{{/while}}";
+});
 
-var result = parser.Render(template);
 Console.WriteLine(result); // Output: 012. 
 ```
 
@@ -146,30 +139,31 @@ Console.WriteLine(result); // Output: 012.
 ```csharp
 var template = "{{each n:x => x.list.Split( \",\" )}}World {{n}},{{/each}}";
 
-var parser = new TemplateParser
+var result = Template.Render(template, new()
 {
-    Variables = { ["list"] = "John,James,Sarah" }
-};
+    Variables = 
+    { 
+        ["list"] = "John,James,Sarah" 
+    }
+});
 
-var result = parser.Render(template);
 Console.WriteLine(result); // hello World John,World James,World Sarah,. 
 ```
 
 ```csharp
 
 var template = "{{each n:x => x.Where( t => Regex.IsMatch( t.Key, \"people*\" ) ).Select( t => t.Value )}}hello {{n}}. {{/each}}";
 
-var parser = new TemplateParser
+var result = Template.Render(template, new()
 {
     Variables = 
-        {
-            ["people[0]"] = "John",
-            ["people[1]"] = "Jane",
-            ["people[2]"] = "Doe"
-        }
-};
-
-var result = parser.Render(template);
+    {
+        ["people[0]"] = "John",
+        ["people[1]"] = "Jane",
+        ["people[2]"] = "Doe"
+    }
+});
+
 Console.WriteLine(result); // hello John. hello Jane. hello Doe. 
 ```
 
@@ -182,11 +176,10 @@ var options = new TemplateOptions()
     .AddVariable("name", "me")
     .AddMethod("ToUpper").Expression<string,string>( value => value.ToUpper() );
 
-var parser = new TemplateParser( options );
-
 var template = "hello {{x => x.ToUpper( x.name )}}.";
 
-var result = parser.Render(template);
+var result = Template.Render(template, options);
+
 Console.WriteLine(result); // Output: hello ME.
 ```
 

docs/index.md

@@ -34,19 +34,18 @@ dotnet add package Hyperbee.Templating
 ### Basic Example: Variable Substitution
 
 ```csharp
-var parser = new TemplateParser
+var template = "hello {{fullname}}.";
+
+var result = Template.Render(template, new()
 {
     Variables =
     {
         ["fullname"] = "{{first}} {{last}}",
         ["first"] = "Hari",
         ["last"] = "Seldon"
     }
-};
-
-var template = "hello {{fullname}}.";
+});
 
-var result = parser.Render(template);
 Console.WriteLine(result); // Output: hello Hari Seldon.
 ```
 

docs/syntax/configuration.md

@@ -36,17 +36,16 @@ Templating can be configured directly at `TemplateParser` construction or throug
 If you are performing simple variable substitution you can configure the `TemplateParser` directly.
 
 ```csharp
-var parser = new TemplateParser
+const string template = "hello {{who}}.";
+
+var result = Template.Render(template, new()
 {
     Variables =
     {
         ["who"] = "you"
     }
-};
-
-const string template = "hello {{who}}.";
+});
 
-var result = parser.Render(template);
 Console.WriteLine(result); // Output: hello you.
 ```
 
@@ -68,11 +67,9 @@ var options = new TemplateOptions()
     )
     .AddMethod("ToUpper", (string input) => input.ToUpper());
 
-var parser = new TemplateParser(options);
-
 const string template = "{{greeting}} {{name.ToUpper()}}!";
 
-var result = parser.Render(template);
+var result = Template.Render(template, options);
 Console.WriteLine(result); // Output: Hello JOHN!
 ```
 
@@ -90,11 +87,9 @@ var options = new TemplateOptions()
         }
     );
 
-var parser = new TemplateParser(options);
-
 const string template = "{{greeting}} {{name}}, good {{timeOfDay}} from {{location}}!";
 
-var result = parser.Render(template);
+var result = Template.Render(template, options);
 Console.WriteLine(result); // Output: Hello John, good morning from world!
 ```
 
@@ -104,23 +99,10 @@ Console.WriteLine(result); // Output: Hello John, good morning from world!
 var options = new TemplateOptions()
     .AddMethod("Format").Expression<string,string,string>((format, arg1, arg2) => string.Format(format, arg1, arg2));
 
-var parser = new TemplateParser(options);
-
 const string template = "{{Format('{0} and {1}', 'Alice', 'Bob')}}";
 
-var result = parser.Render(template);
+var result = Template.Render(template, options);
 Console.WriteLine(result); // Output: Alice and Bob
 ```
 
-#### Example: Setting Token Style and Depth
-
-```csharp
-var options = new TemplateOptions()
-    .SetTokenStyle(TokenStyle.CurlyBraces)
-    .SetMaxTokenDepth(10);
-
-var parser = new TemplateParser(options);
-```
-
-
 {% endraw %}