✅ 4. Using an anonymous object

var template = "Welcome {name}, your ID is {id}.";
var result = template.Fill(new { name = "Lucas", id = "12345" });
// Result: "Welcome Lucas, your ID is 12345."

✅ 5. Using fallback values

var template = "Hi {name:Guest}, welcome!";
var result = template.Fill(new { });
// Result: "Hi Guest, welcome!"

✅ 6. Format specifiers for dates, numbers, and currency

// DateTime formatting
var template = "Event: {date:yyyy-MM-dd}";
var result = template.Fill(new { date = new DateTime(2025, 12, 17) });
// Result: "Event: 2025-12-17"

// Currency formatting with culture
var template = "Price: {amount:C2}";
var result = template.Fill(new { amount = 1299.99m }, new CultureInfo("en-US"));
// Result: "Price: $1,299.99"

// Configuration URLs
var urlTemplate = "https://api.com/v{version}/orders?date={date:yyyy-MM-dd}";
var url = urlTemplate.Fill(new { version = 2, date = DateTime.Now });
// Result: "https://api.com/v2/orders?date=2025-12-17"

✅ 7. ASP.NET Core culture integration (.NET 6+)

// Program.cs
builder.Services.AddSmartStrings("en-US");

// Or from appsettings.json
builder.Services.AddSmartStrings(builder.Configuration.GetSection("SmartStrings"));

// appsettings.json
{
  "SmartStrings": {
    "DefaultCulture": "pt-BR",
    "InheritThreadCulture": true
  }
}

// Usage - automatically uses configured culture
"{price:C2}".Fill(new { price = 29.99m }); // "R$ 29,99" with pt-BR

✅ 8. Manual mapping with nested model

var card = new Card()
{
    User = new User() {
        Name = "Brian",
        Company = "SmartCo"
    }
};
const string template = "Welcome {NAME} from {COMPANY}"

template.Fill(card, map => {
    map.Bind("NAME", c => c.User.Name);
    map.Bind("COMPANY", c => c.User.Company);
});
// Welcome Brian from SmartCo

✅ 9. Using TemplateString.Fill (Alternative API)

TemplateString.Fill("Hello {USERNAME}", new { USERNAME = "Joana" });

TemplateString.Fill("User: {NAME}", user, map => {
    map.Bind("NAME", u => u.User.Name);
});

// With culture
TemplateString.Fill("Price: {amount:C2}", new { amount = 29.99m }, new CultureInfo("en-US"));

✅ Compatibility

• .NET Standard 2.0
• .NET 6, 7, 8 and above

📦 Install

dotnet add package SmartStrings

📚 Full source, license, and documentation available at
github.com/jonatasolmartins/smart-strings