osu/osu.Game/Localisation/ResourceManagerLocalisationStore.cs

// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
// See the LICENCE file in the repository root for full licence text.

#nullable disable

using System;
using System.Collections.Generic;
using System.Globalization;
using System.IO;
using System.Linq;
using System.Resources;
using System.Threading;
using System.Threading.Tasks;
using osu.Framework.Localisation;

namespace osu.Game.Localisation
{
    public class ResourceManagerLocalisationStore : ILocalisationStore
    {
        private readonly Dictionary<string, ResourceManager> resourceManagers = new Dictionary<string, ResourceManager>();

        public ResourceManagerLocalisationStore(string cultureCode)
        {
            EffectiveCulture = new CultureInfo(cultureCode);
        }

        public void Dispose()
        {
        }

        public string Get(string lookup)
        {
            string[] split = lookup.Split(':');

            if (split.Length < 2)
                return null;

            string ns = split[0];
            string key = split[1];

            lock (resourceManagers)
            {
                if (!resourceManagers.TryGetValue(ns, out var manager))
                {
                    var loadedAssemblies = AppDomain.CurrentDomain.GetAssemblies();

                    // Traverse backwards through periods in the namespace to find a matching assembly.
                    string assemblyName = ns;

                    while (!string.IsNullOrEmpty(assemblyName))
                    {
                        var matchingAssembly = loadedAssemblies.FirstOrDefault(asm => asm.GetName().Name == assemblyName);

                        if (matchingAssembly != null)
                        {
                            resourceManagers[ns] = manager = new ResourceManager(ns, matchingAssembly);
                            break;
                        }

                        int lastIndex = Math.Max(0, assemblyName.LastIndexOf('.'));
                        assemblyName = assemblyName.Substring(0, lastIndex);
                    }
                }

                if (manager == null)
                    return null;

                // When using the English culture, prefer the fallbacks rather than osu-resources baked strings.
                // They are guaranteed to be up-to-date, and is also what a developer expects to see when making changes to `xxxStrings.cs` files.
                if (EffectiveCulture.Name == @"en")
                    return null;

                try
                {
                    return manager.GetString(key, EffectiveCulture);
                }
                catch (MissingManifestResourceException)
                {
                    // in the case the manifest is missing, it is likely that the user is adding code-first implementations of new localisation namespaces.
                    // it's fine to ignore this as localisation will fallback to default values.
                    return null;
                }
            }
        }

        public Task<string> GetAsync(string lookup, CancellationToken cancellationToken = default)
        {
            return Task.FromResult(Get(lookup));
        }

        public Stream GetStream(string name)
        {
            throw new NotImplementedException();
        }

        public IEnumerable<string> GetAvailableResources()
        {
            throw new NotImplementedException();
        }

        public CultureInfo EffectiveCulture { get; }
    }
}