/// <summary>
/// Registers a key and a value to be used with the text transformation.
/// </summary>
/// <typeparam name="TTemplate">The text transformation template.</typeparam>
/// <param name="transformation">The text transformation.</param>
/// <param name="key">The key.</param>
/// <param name="value">The value.</param>
/// <returns>
/// The same <see cref="TextTransformation{TTemplate}" /> instance so that multiple calls can be chained.
/// </returns>
public static TextTransformation <TTemplate> WithToken <TTemplate>(
this TextTransformation <TTemplate> transformation, string key, object value)
where TTemplate : class, ITextTransformationTemplate
{
transformation?.Template.Register(key, value);
return(transformation);
}
/// <summary>
/// Registers all keys and values in the enumerable for text transformation.
/// </summary>
/// <typeparam name="TTemplate">The text transformation template.</typeparam>
/// <param name="transformation">The text transformation.</param>
/// <param name="tokens">The tokens.</param>
/// <returns>
/// The same <see cref="TextTransformation{TTemplate}" /> instance so that multiple calls can be chained.
/// </returns>
public static TextTransformation <TTemplate> WithTokens <TTemplate>(
this TextTransformation <TTemplate> transformation, IEnumerable <KeyValuePair <string, object> > tokens)
where TTemplate : class, ITextTransformationTemplate
{
if (tokens == null)
{
throw new ArgumentNullException(nameof(tokens));
}
foreach (var token in tokens)
{
transformation?.Template.Register(token.Key, token.Value);
}
return(transformation);
}