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") );