using System; using System.Collections.Generic; using System.IO; namespace StardewModdingAPI.Toolkit.Utilities { /// Provides an API for case-insensitive relative path lookups within a root directory. internal class CaseInsensitivePathLookup { /********* ** Fields *********/ /// The root directory path for relative paths. private readonly string RootPath; /// A case-insensitive lookup of file paths within the . Each path is listed in both file path and asset name format, so it's usable in both contexts without needing to re-parse paths. private readonly Lazy> RelativePathCache; /// The case-insensitive path caches by root path. private static readonly Dictionary CachedRoots = new(StringComparer.OrdinalIgnoreCase); /********* ** Public methods *********/ /// Construct an instance. /// The root directory path for relative paths. public CaseInsensitivePathLookup(string rootPath) { this.RootPath = rootPath; this.RelativePathCache = new(this.GetRelativePathCache); } /// Get the exact capitalization for a given relative file path. /// The relative path. /// Returns the resolved path in file path format, else the normalized . public string GetFilePath(string relativePath) { return this.GetImpl(PathUtilities.NormalizePath(relativePath)); } /// Get the exact capitalization for a given asset name. /// The relative path. /// Returns the resolved path in asset name format, else the normalized . public string GetAssetName(string relativePath) { return this.GetImpl(PathUtilities.NormalizeAssetName(relativePath)); } /// Add a relative path that was just created by a SMAPI API. /// The relative path. This must already be normalized in asset name or file path format. public void Add(string relativePath) { // skip if cache isn't created yet (no need to add files manually in that case) if (!this.RelativePathCache.IsValueCreated) return; // skip if already cached if (this.RelativePathCache.Value.ContainsKey(relativePath)) return; // make sure path exists relativePath = PathUtilities.NormalizePath(relativePath); if (!File.Exists(Path.Combine(this.RootPath, relativePath))) throw new InvalidOperationException($"Can't add relative path '{relativePath}' to the case-insensitive cache for '{this.RootPath}' because that file doesn't exist."); // cache path this.CacheRawPath(this.RelativePathCache.Value, relativePath); } /// Get a cached dictionary of relative paths within a root path, for case-insensitive file lookups. /// The root path to scan. public static CaseInsensitivePathLookup GetCachedFor(string rootPath) { rootPath = PathUtilities.NormalizePath(rootPath); if (!CaseInsensitivePathLookup.CachedRoots.TryGetValue(rootPath, out CaseInsensitivePathLookup? cache)) CaseInsensitivePathLookup.CachedRoots[rootPath] = cache = new CaseInsensitivePathLookup(rootPath); return cache; } /********* ** Private methods *********/ /// Get the exact capitalization for a given relative path. /// The relative path. This must already be normalized into asset name or file path format (i.e. using or respectively). /// Returns the resolved path in the same format if found, else returns the path as-is. private string GetImpl(string relativePath) { // invalid path if (string.IsNullOrWhiteSpace(relativePath)) return relativePath; // already cached if (this.RelativePathCache.Value.TryGetValue(relativePath, out string? resolved)) return resolved; // keep capitalization as-is if (File.Exists(Path.Combine(this.RootPath, relativePath))) { // file exists but isn't cached for some reason // cache it now so any later references to it are case-insensitive this.CacheRawPath(this.RelativePathCache.Value, relativePath); } return relativePath; } /// Get a case-insensitive lookup of file paths (see ). private Dictionary GetRelativePathCache() { Dictionary cache = new(StringComparer.OrdinalIgnoreCase); foreach (string path in Directory.EnumerateFiles(this.RootPath, "*", SearchOption.AllDirectories)) { string relativePath = path.Substring(this.RootPath.Length + 1); this.CacheRawPath(cache, relativePath); } return cache; } /// Add a raw relative path to the cache. /// The cache to update. /// The relative path to cache, with its exact filesystem capitalization. private void CacheRawPath(IDictionary cache, string relativePath) { string filePath = PathUtilities.NormalizePath(relativePath); string assetName = PathUtilities.NormalizeAssetName(relativePath); cache[filePath] = filePath; cache[assetName] = assetName; } } }