CodeTemplateForge 1.0.1

TemplateForge

A lightweight and extensible template-based code generation framework for .NET.

Features

• Multiple Template Engines - Built-in Scriban support, extensible for others
• Flexible Package Formats - Binary packages, directory-based, or custom formats
• Customizable Magic Numbers - Define your own package format identifier
• Value Processors - Built-in hex, bool-to-int, formatting, and more
• Output Processors - Auto-formatting, line ending normalization
• Event System - Progress tracking, logging, and cancellation support
• Fluent API - Chain configuration calls for clean code

Quick Start

Basic Usage

using TemplateForge;
using TemplateForge.Core;

// Create generator
var generator = new CodeGenerator();

// Load templates
await generator.LoadPackageAsync("templates.bin");

// Create context with variables
var context = new TemplateContext()
    .Set("project_name", "MyProject")
    .Set("version", "1.0.0")
    .Set("author", "John Doe");

// Generate code
var result = await generator.GenerateAsync(context, outputPath);

Custom Magic Number

// Using hex value
var generator = new CodeGenerator(0x4D595047); // "MYPG"

// Using string
var generator = new CodeGenerator("MYPG");

// Using helper
using TemplateForge.Utilities;
var magic = MagicNumberHelper.FromString("CHIP");
var generator = new CodeGenerator(magic);

Creating Template Packages

using TemplateForge.Packaging;

// Build package programmatically
var builder = new TemplatePackageBuilder()
    .WithId("my-templates")
    .WithName("My Template Package")
    .WithVersion("1.0.0")
    .WithMagicNumber("MYPG")  // Custom magic number
    .AddTemplatesFromDirectory("./templates");

await builder.SaveAsync("my-templates.bin");

// Or quick pack
await PackageBuilderExtensions.PackDirectoryAsync(
    "./templates", 
    "output.bin",
    "*.template",
    MagicNumberHelper.FromString("MYPG")
);

Using Extension Methods

using TemplateForge.Extensions;

var context = new TemplateContext()
    .SetHex("config_reg", 0x1A, 2)      // "1a"
    .SetBool("feature_enabled", true)    // Sets 3 vars: feature_enabled, feature_enabled_int, is_feature_enabled
    .SetDouble("timeout", 2.5)           // Smart formatting
    .SetEnum("mode", MyEnum.Option1);    // Sets mode, mode_value, is_mode_option1, etc.

Event Handling

var generator = new CodeGenerator();

generator.ProgressChanged += (s, e) => 
    Console.WriteLine($"[{e.ProgressPercentage:F0}%] {e.CurrentTemplate}");

generator.Log += (s, e) => 
    Console.WriteLine($"[{e.Level}] {e.Message}");

generator.BeforeRendering += (s, e) => 
{
    if (e.TemplateName.Contains("debug"))
        e.Cancel = true; // Skip debug templates
};

generator.Completed += (s, e) => 
    Console.WriteLine($"Done! {e.FilesGenerated} files in {e.Duration.TotalSeconds:F2}s");

Configuration Options

var generator = new CodeGenerator()
    .WithDefaults()
    .WithDirectories("obj", "build")
    .Configure(options => 
    {
        options.OverwriteExisting = true;
        options.ContinueOnError = false;
        options.ValidateTemplates = true;
        options.OutputEncoding = Encoding.UTF8;
    });

Template Syntax (Scriban)

{{ variable_name }}
{{ if condition }}...{{ end }}
{{ for item in collection }}...{{ end }}
{{ variable | string.upcase }}

Project Structure

TemplateForge/
├── Core/                    # Template engine interfaces
├── Packaging/               # Package formats and loaders
├── Processing/              # Value and output processors
├── Configuration/           # Generator options
├── Extensions/              # Extension methods
├── Utilities/               # Helper classes
└── CodeGenerator.cs         # Main entry point

License

MIT License