Skip to main content

Curiosus.Localization

NuGet Downloads Coverage

Source-text based localization: code uses the default-language text itself as the key, translations live in .resx files under hashed keys and are cached per culture. Also adds plural-form helpers for IStringLocalizer.

Installation​

dotnet add package Curiosus.Localization

Usage​

Create Resources/Strings.resx (and Strings.en.resx etc.) in your assembly and wrap LocalizerCore in a static helper:

internal static class LNG
{
    private static readonly LocalizationOptions Options = new();
    private static readonly LocalizerCore Localizer = new(typeof(LNG).Assembly, Options);

    public static string Get(string source, params object[] arguments)
    {
        return Localizer.Get(Options.Prefix, source, false, arguments);
    }
}

var message = LNG.Get("Файл {0} не найден", fileName);

When CurrentUICulture matches LocalizationOptions.DefaultLanguage (ru by default) the source text is returned as is. Otherwise the text is looked up in the resources by the key ResourceKeyGenerator.Generate(prefix, source) (<prefix>_<xxHash of the text>), falling back to the source text. Set CheckResourceFiles = true to fail fast when resources for SupportedLanguages are missing.

Plural forms (Slavic rules: _1, _2, _5 suffixes) with any IStringLocalizer:

// looks up "FilesCount_1", "FilesCount_2" or "FilesCount_5"
var text = localizer.GetQuantityString("FilesCount", count, count);

See also​