using System; using System.Diagnostics.Contracts; using System.IO; using System.Linq; namespace StardewModdingAPI.Framework.Utilities { /// Provides utilities for normalising file paths. internal static class PathUtilities { /********* ** Properties *********/ /// The possible directory separator characters in a file path. private static readonly char[] PossiblePathSeparators = new[] { '/', '\\', Path.DirectorySeparatorChar, Path.AltDirectorySeparatorChar }.Distinct().ToArray(); /// The preferred directory separator chaeacter in an asset key. private static readonly string PreferredPathSeparator = Path.DirectorySeparatorChar.ToString(); /********* ** Public methods *********/ /// Get the segments from a path (e.g. /usr/bin/boop => usr, bin, and boop). /// The path to split. public static string[] GetSegments(string path) { return path.Split(PathUtilities.PossiblePathSeparators, StringSplitOptions.RemoveEmptyEntries); } /// Normalise path separators in a file path. /// The file path to normalise. [Pure] public static string NormalisePathSeparators(string path) { string[] parts = PathUtilities.GetSegments(path); string normalised = string.Join(PathUtilities.PreferredPathSeparator, parts); if (path.StartsWith(PathUtilities.PreferredPathSeparator)) normalised = PathUtilities.PreferredPathSeparator + normalised; // keep root slash return normalised; } /// Get a directory or file path relative to a given source path. /// The source folder path. /// The target folder or file path. [Pure] public static string GetRelativePath(string sourceDir, string targetPath) { // convert to URIs Uri from = new Uri(sourceDir.TrimEnd(PathUtilities.PossiblePathSeparators) + "/"); Uri to = new Uri(targetPath.TrimEnd(PathUtilities.PossiblePathSeparators) + "/"); if (from.Scheme != to.Scheme) throw new InvalidOperationException($"Can't get path for '{targetPath}' relative to '{sourceDir}'."); // get relative path string relative = PathUtilities.NormalisePathSeparators(Uri.UnescapeDataString(from.MakeRelativeUri(to).ToString())); if (relative == "") relative = "./"; return relative; } } }