PathUtils.cs

// Copyright (c) ServiceStack, Inc. All Rights Reserved.
// License: https://raw.github.com/ServiceStack/ServiceStack/master/license.txt


using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Runtime.CompilerServices;
using System.Text;
using ServiceStack.Text;

namespace ServiceStack;

public static class PathUtils
{
    public static string MapAbsolutePath(this string relativePath, string appendPartialPathModifier)
    {
        return PclExport.Instance.MapAbsolutePath(relativePath, appendPartialPathModifier);
    }

    /// <summary>
    /// Maps the path of a file in the context of a VS project in a Console App
    /// </summary>
    /// <param name="relativePath">the relative path</param>
    /// <returns>the absolute path</returns>
    /// <remarks>Assumes static content is two directories above the /bin/ directory,
    /// eg. in a unit test scenario  the assembly would be in /bin/Debug/.</remarks>
    public static string MapProjectPath(this string relativePath)
    {
        var sep = PclExport.Instance.DirSep;
        return Env.HasMultiplePlatformTargets
            ? PclExport.Instance.MapAbsolutePath(relativePath, $"{sep}..{sep}..{sep}..")
            : PclExport.Instance.MapAbsolutePath(relativePath, $"{sep}..{sep}..");
    }
    /// <summary>
    /// Maps the path of a file in the context of a VS 2017+ multi-platform project in a Console App
    /// </summary>
    /// <param name="relativePath">the relative path</param>
    /// <returns>the absolute path</returns>
    /// <remarks>Assumes static content is two directories above the /bin/ directory,
    /// eg. in a unit test scenario  the assembly would be in /bin/Debug/net45</remarks>
    public static string MapProjectPlatformPath(this string relativePath)
    {
        var sep = PclExport.Instance.DirSep;
        return PclExport.Instance.MapAbsolutePath(relativePath, $"{sep}..{sep}..{sep}..");
    }

    /// <summary>
    /// Maps the path of a file in the bin\ folder of a self-hosted scenario
    /// </summary>
    /// <param name="relativePath">the relative path</param>
    /// <returns>the absolute path</returns>
    /// <remarks>Assumes static content is copied to /bin/ folder with the assemblies</remarks>
    public static string MapAbsolutePath(this string relativePath)
    {
        return PclExport.Instance.MapAbsolutePath(relativePath, null);
    }

    /// <summary>
    /// Maps the path of a file in an ASP.NET hosted scenario
    /// </summary>
    /// <param name="relativePath">the relative path</param>
    /// <returns>the absolute path</returns>
    /// <remarks>Assumes static content is in the parent folder of the /bin/ directory</remarks>
    public static string MapHostAbsolutePath(this string relativePath)
    {
        var sep = PclExport.Instance.DirSep;
#if !NETCORE
            return PclExport.Instance.MapAbsolutePath(relativePath, $"{sep}..");
#else
        return PclExport.Instance.MapAbsolutePath(relativePath, $"{sep}..{sep}..{sep}..");
#endif
    }

    internal static string CombinePaths(StringBuilder sb, params string[] paths)
    {
        AppendPaths(sb, paths);
        return sb.ToString();
    }

    public static void AppendPaths(StringBuilder sb, string[] paths)
    {
        foreach (var path in paths)
        {
            if (string.IsNullOrWhiteSpace(path))
                continue;

            if (sb.Length > 0 && sb[sb.Length - 1] != '/')
                sb.Append("/");

            sb.Append(path.Replace('\\', '/').TrimStart('/'));
        }
    }

    public static string CombinePaths(params string[] paths)
    {
        var sb = StringBuilderThreadStatic.Allocate();
        AppendPaths(sb, paths);
        return StringBuilderThreadStatic.ReturnAndFree(sb);
    }

    /// <summary>
    /// Create Directory if not exists 
    /// </summary>
    public static string AssertDir(this string dirPath)
    {
        if (!dirPath.DirectoryExists())
            dirPath.CreateDirectory();
        return dirPath;
    }

    /// <summary>
    /// Create Directory if not exists 
    /// </summary>
    public static string AssertDir(this DirectoryInfo dirInfo) => dirInfo?.FullName.AssertDir();
    /// <summary>
    /// Create Directory if not exists 
    /// </summary>
    public static string AssertDir(this FileInfo fileInfo) => fileInfo.DirectoryName?.AssertDir();

    private static readonly char[] Slashes = { '/', '\\' };

    [MethodImpl(MethodImplOptions.AggressiveInlining)] //only trim/allocate if need to
    private static string TrimEndIf(this string path, char[] chars)
    {
        if (string.IsNullOrWhiteSpace(path) || chars == null || chars.Length == 0)
            return path;
                
        var lastChar = path[path.Length - 1];
        foreach (var c in chars)
        {
            if (c == lastChar)
                return path.TrimEnd(chars);
        }
        return path;
    }

    public static string CombineWith(this string path, string withPath)
    {
        if (path == null)
            path = "";
        if (string.IsNullOrWhiteSpace(withPath))
            return path;
        var startPath = path.TrimEndIf(Slashes);
        return startPath + (withPath[0] == '/' ? withPath : "/" + withPath);
    }
        
    public static string CombineWith(this string path, params string[] thesePaths)
    {
        if (path == null)
            path = "";

        if (thesePaths.Length == 1 && thesePaths[0] == null) return path;
        var startPath = path.TrimEndIf(Slashes);

        var sb = StringBuilderThreadStatic.Allocate();
        sb.Append(startPath);
        AppendPaths(sb, thesePaths);
        return StringBuilderThreadStatic.ReturnAndFree(sb);
    }

    public static string CombineWith(this string path, params object[] thesePaths)
    {
        if (thesePaths.Length == 1 && thesePaths[0] == null) return path;

        var sb = StringBuilderThreadStatic.Allocate();
        sb.Append(path.TrimEndIf(Slashes));
        AppendPaths(sb, ToStrings(thesePaths));
        return StringBuilderThreadStatic.ReturnAndFree(sb);
    }

    public static string ResolvePaths(this string path)
    {
        if (path == null || path.IndexOfAny("./", "/.") == -1)
            return path;

        var schemePos = path.IndexOf("://", StringComparison.Ordinal);
        var prefix = schemePos >= 0
            ? path.Substring(0, schemePos + 3)
            : "";

        var parts = path.Substring(prefix.Length).Split('/').ToList();
        var combinedPaths = new List<string>();
        foreach (var part in parts)
        {
            if (string.IsNullOrEmpty(part) || part == ".")
                continue;

            if (part == ".." && combinedPaths.Count > 0)
                combinedPaths.RemoveAt(combinedPaths.Count - 1);
            else
                combinedPaths.Add(part);
        }

        var resolvedPath = string.Join("/", combinedPaths);
        if (path[0] == '/' && prefix.Length == 0)
            resolvedPath = "/" + resolvedPath;

        return path[path.Length - 1] == '/' && resolvedPath.Length > 0
            ? prefix + resolvedPath + "/"
            : prefix + resolvedPath;
    }

    public static string[] ToStrings(object[] thesePaths)
    {
        var to = new string[thesePaths.Length];
        for (var i = 0; i < thesePaths.Length; i++)
        {
            to[i] = thesePaths[i].ToString();
        }
        return to;
    }

    internal static List<To> Map<To>(System.Collections.IEnumerable items, Func<object, To> converter)
    {
        if (items == null)
            return new List<To>();

        var list = new List<To>();
        foreach (var item in items)
        {
            list.Add(converter(item));
        }
        return list;
    }    
}