Move rendering entirely to templates

Author: Genbox

.gitignore

@@ -29,4 +29,4 @@
 # Verify
 *.received.*
 *.received/
-**/Templates/*.cs
+**/Templates/**.cs

Docs/Generator.txt

@@ -0,0 +1,12 @@
+Generator rules:
+- Generators should be able to run multiple times, but only output new structures. That is, any shared helpers, object declarations, etc. should be output only once.
+- Generator's output should be configurable by users. The FastData.Generator.Template package helps developing templatable generators using the T4 template engine.
+- Generators should provide placeholders that configures the output across all templates. For example, in C#, the user might want to generate a static class instead of an instance class. Instead of having them go through all templates and update them to accomodate the need, they simply set ClassType = Static.
+- Generators must be named <Lang>CodeGenerator as the naming scheme is assumed elsewhere.
+
+## Supporting core features
+The FastData engine supports several core features that a generator developer can use. However, to support them, you must do the following:
+
+- Trimming: You must use the InputKeyName/LookupKeyName abstraction, as the engine will switch the name if trimming is enabled
+- Early exits: You must render the early exit expression at the top of public API methods. TODO: Which expressions to support in compiler?
+- Case sensitivity support: You must provide an indirection for string comparison and switch between case-sensitive and case-insensitive matching depending on the value of Config.IgnoreCase.

Src/FastData.Benchmarks/Program.cs

@@ -59,7 +59,7 @@ private static void DoStructure(Type type, int size)
         Random rng = new Random(42);
         string[] data = Enumerable.Range(0, size).Select(_ => TestHelper.GenerateRandomString(rng, rng.Next(5, 10))).ToArray();
 
-        CSharpCodeGenerator generator = CSharpCodeGenerator.Create(new CSharpCodeGeneratorConfig("fastdata"));
+        CSharpCodeGenerator generator = new CSharpCodeGenerator(new CSharpCodeGeneratorConfig("fastdata"));
 
         StringDataConfig config = new StringDataConfig();
         config.StructureTypeOverride = type;

Src/FastData.Cli/Program.cs

@@ -139,7 +139,7 @@ internal static async Task<int> Main(string[] args)
             genCfg.ClassVisibility = cv;
             genCfg.ClassType = ct;
 
-            CSharpCodeGenerator generator = CSharpCodeGenerator.Create(genCfg);
+            CSharpCodeGenerator generator = new CSharpCodeGenerator(genCfg);
 
             await GenerateAsync(inputFile, keyType, structureType, ignoreCase, generator, outputFile, token).ConfigureAwait(false);
         });
@@ -154,7 +154,7 @@ internal static async Task<int> Main(string[] args)
             string? cn = pr.GetValue(classNameOpt);
 
             CPlusPlusCodeGeneratorConfig genCfg = new CPlusPlusCodeGeneratorConfig(cn);
-            CPlusPlusCodeGenerator generator = CPlusPlusCodeGenerator.Create(genCfg);
+            CPlusPlusCodeGenerator generator = new CPlusPlusCodeGenerator(genCfg);
 
             await GenerateAsync(inputFile, keyType, structureType, ignoreCase, generator, outputFile, token).ConfigureAwait(false);
         });
@@ -169,7 +169,7 @@ internal static async Task<int> Main(string[] args)
             string? cn = pr.GetValue(classNameOpt);
 
             RustCodeGeneratorConfig genCfg = new RustCodeGeneratorConfig(cn);
-            RustCodeGenerator generator = RustCodeGenerator.Create(genCfg);
+            RustCodeGenerator generator = new RustCodeGenerator(genCfg);
 
             await GenerateAsync(inputFile, keyType, structureType, ignoreCase, generator, outputFile, token).ConfigureAwait(false);
         });

Src/FastData.Examples/Program.cs

@@ -8,7 +8,7 @@ internal static class Program
     private static void Main()
     {
         StringDataConfig config = new StringDataConfig();
-        CSharpCodeGenerator generator = CSharpCodeGenerator.Create(new CSharpCodeGeneratorConfig("Dogs"));
+        CSharpCodeGenerator generator = new CSharpCodeGenerator(new CSharpCodeGeneratorConfig("Dogs"));
 
         string source = FastDataGenerator.Generate(["Labrador", "German Shepherd", "Golden Retriever"], config, generator);
         Console.WriteLine(source);

Src/FastData.Generator.CPlusPlus.TestHarness/CPlusPlusBootstrap.cs

@@ -1,7 +1,6 @@
 using Genbox.FastData.Enums;
 using Genbox.FastData.Generator.CPlusPlus.Internal;
 using Genbox.FastData.Generator.CPlusPlus.Internal.Framework;
-using Genbox.FastData.Generator.Framework;
 using Genbox.FastData.Generators.Abstracts;
 using Genbox.FastData.InternalShared.Harness;
 using Genbox.FastData.InternalShared.Harness.Enums;
@@ -18,7 +17,7 @@ public CPlusPlusBootstrap(HarnessType type) : base("CPlusPlus", ".cpp", type, "s
 
     public TypeMap Map { get; }
 
-    public override ICodeGenerator Generator => CPlusPlusCodeGenerator.Create(new CPlusPlusCodeGeneratorConfig("fastdata"));
+    public override ICodeGenerator Generator => new CPlusPlusCodeGenerator(new CPlusPlusCodeGeneratorConfig("fastdata"));
 
     public override string Wrap(string code) =>
         $$"""