using System; using System.Collections; using System.Collections.Generic; using System.Reflection; using System.Text.RegularExpressions; namespace StardewModdingAPI { /// A translation string with a fluent API to customise it. public class Translation { /********* ** Fields *********/ /// The placeholder text when the translation is null or empty, where {0} is the translation key. internal const string PlaceholderText = "(no translation:{0})"; /// The locale for which the translation was fetched like fr-FR, or an empty string for English. private readonly string Locale; /// The underlying translation text. private readonly string? Text; /// The value to return if the translations is undefined. private readonly string? Placeholder; /********* ** Accessors *********/ /// The original translation key. public string Key { get; } /********* ** Public methods *********/ /// Construct an instance. /// The locale for which the translation was fetched. /// The translation key. /// The underlying translation text. internal Translation(string locale, string key, string? text) : this(locale, key, text, string.Format(Translation.PlaceholderText, key)) { } /// Replace the text if it's null or empty. If you set a null or empty value, the translation will show the fallback "no translation" placeholder (see if you want to disable that). Returns a new instance if changed. /// The default value. public Translation Default(string? @default) { return this.HasValue() ? this : new Translation(this.Locale, this.Key, @default); } /// Whether to return a "no translation" placeholder if the translation is null or empty. Returns a new instance. /// Whether to return a placeholder. Due to limitations with nullable reference types, setting this to false will still mark the text non-nullable. public Translation UsePlaceholder(bool use) { return new Translation(this.Locale, this.Key, this.Text, use ? string.Format(Translation.PlaceholderText, this.Key) : null); } /// Replace tokens in the text like {{value}} with the given values. Returns a new instance. /// An object containing token key/value pairs. This can be an anonymous object (like new { value = 42, name = "Cranberries" }), a dictionary, or a class instance. /// The argument is null. public Translation Tokens(object? tokens) { if (string.IsNullOrWhiteSpace(this.Text) || tokens == null) return this; // get dictionary of tokens Dictionary tokenLookup = new(StringComparer.OrdinalIgnoreCase); { // from dictionary if (tokens is IDictionary inputLookup) { foreach (DictionaryEntry entry in inputLookup) { string? key = entry.Key.ToString()?.Trim(); if (key != null) tokenLookup[key] = entry.Value?.ToString(); } } // from object properties else { Type type = tokens.GetType(); foreach (PropertyInfo prop in type.GetProperties()) tokenLookup[prop.Name] = prop.GetValue(tokens)?.ToString(); foreach (FieldInfo field in type.GetFields()) tokenLookup[field.Name] = field.GetValue(tokens)?.ToString(); } } // format translation string text = Regex.Replace(this.Text, @"{{([ \w\.\-]+)}}", match => { string key = match.Groups[1].Value.Trim(); return tokenLookup.TryGetValue(key, out string? value) ? (value ?? "") : match.Value; }); return new Translation(this.Locale, this.Key, text); } /// Get whether the translation has a defined value. public bool HasValue() { return !string.IsNullOrEmpty(this.Text); } /// Get the translation text. Calling this method isn't strictly necessary, since you can assign a value directly to a string. /// Limitation with nullable reference types: if there's no text and you disabled the fallback via , this will return null but the return value will still be marked non-nullable. public override string ToString() { return this.Placeholder != null && !this.HasValue() ? this.Placeholder : this.Text!; } /// Get a string representation of the given translation. /// The translation key. /// Limitation with nullable reference types: if there's no text and you disabled the fallback via , this will return null but the return value will still be marked non-nullable. public static implicit operator string(Translation translation) { return translation.ToString(); } /********* ** Private methods *********/ /// Construct an instance. /// The locale for which the translation was fetched. /// The translation key. /// The underlying translation text. /// The value to return if the translations is undefined. private Translation(string locale, string key, string? text, string? placeholder) { this.Locale = locale; this.Key = key; this.Text = text; this.Placeholder = placeholder; } } }