SmartStrings

SmartStrings is a lightweight and intuitive C# string templating library. It adds extension methods like .Fill() that let you replace placeholders in strings using objects, dictionaries, or parameter arrays — with optional fallbacks.

💡 Inspired by the flexibility of $"{name}", but better suited for dynamic or external templates.

✨ Features

• ✅ Replace named placeholders like {name}, {plan}, etc.
• ✅ Optional fallback values using {name:Guest} syntax
• ✅ Fill from:
  • A single value
  • Multiple ordered values
  • An object
  • A dictionary
  • Nested object
• ✅ Safe: handles null, missing keys, and extra placeholders gracefully
• ✅ Works with .NET Framework (4.6.1+), .NET 6, 7, 8 and future versions

🚀 Usage

✅ 1. Single placeholder with one value

using SmartStrings; var template = "Welcome, {user}!"; var result = template.Fill("Alice"); // Result: "Welcome, Alice!"

---

✅ 2. Multiple placeholders (ordered)

const string template = "Hello {0}, your plan is {1}"; var result = template.Fill("Joe", "Premium"); // Result: "Hello Joe, your plan is Premium" // Alternative var result = TemplateString.Fill(template, "Joe", "Premium"); // Result: "Hello Joe, your plan is Premium"

Or using named placeholders:

var template = "Hello {name}, your {plan} plan is active."; var result = template.Fill("Jonatas", "Gold"); // Result: "Hello Jonatas, your Gold plan is active."s

---

✅ 3. Using a dictionary

var template = "Hi {name}, you're on the {plan} plan."; var result = template.Fill(new Dictionary<string, string?> { ["name"] = "Carla", ["plan"] = "Standard" }); // Result: "Hi Carla, you're on the Standard plan."

---