ObjectSemantics.NET 6.0.5

ObjectSemantics.NET

Simple and flexible object-to-template string mapper with formatting support

🧠 Overview

ObjectSemantics.NET is a lightweight C# library that lets you inject object property values directly into string templates much like Handlebars or Helm templates, but focused on .NET.

This is especially useful when you want to dynamically generate content such as:

• Email templates
• HTML fragments
• Reports or invoices
• Config files
• Logging output

It supports:

• ✅ Plain object property injection ({{ PropertyName }})
• ✅ Additional external parameters
• ✅ Enumerable collections with looping (#foreach)
• ✅ Built-in string, date, and number formatting

📦 Installation

Install from NuGet:

Install-Package ObjectSemantics.NET

🚀 Quick Start

Example 1: Basic Object Property Mapping

// Create model
Student student = new Student
{
    StudentName = "George Waynne",
    Balance = 2510
};

// Define template
var template = new ObjectSemanticsTemplate
{
    FileContents = @"My Name is: {{ StudentName }} and my balance is {{ Balance:N2 }}"
};

// Map object to template
string result = template.Map(student);

Console.WriteLine(result);

Output:

My Name is: George Waynne and my balance is 2,510.00

Example 2: Mapping Enumerable Collections

Student student = new Student
{
    StudentName = "John Doe",
    Invoices = new List<Invoice>
    {
        new Invoice { Id = 2, RefNo = "INV_002", Narration = "Grade II Fees Invoice", Amount = 2000, InvoiceDate = new DateTime(2023, 04, 01) },
        new Invoice { Id = 1, RefNo = "INV_001", Narration = "Grade I Fees Invoice", Amount = 320, InvoiceDate = new DateTime(2022, 08, 01) }
    }
};

var template = new ObjectSemanticsTemplate
{
    FileContents = @"{{ StudentName }} Invoices
{{ #foreach(Invoices) }}
<tr>
    <td>{{ Id }}</td>
    <td>{{ RefNo }}</td>
    <td>{{ Narration }}</td>
    <td>{{ Amount:N0 }}</td>
    <td>{{ InvoiceDate:yyyy-MM-dd }}</td>
</tr>
{{ #endforeach }}"
};

string result = template.Map(student);

Console.WriteLine(result);

Output:

John Doe Invoices

<tr>
    <td>2</td>
    <td>INV_002</td>
    <td>Grade II Fees Invoice</td>
    <td>2,000</td>
    <td>2023-04-01</td>
</tr>

<tr>
    <td>1</td>
    <td>INV_001</td>
    <td>Grade I Fees Invoice</td>
    <td>320</td>
    <td>2022-08-01</td>
</tr>

🧪 More Samples

Explore more usage examples and edge cases in the test project:

📁 ObjectSemantics.NET.Tests

🤝 Contributing

Feel free to open issues or contribute improvements via pull requests!

📄 MIT License