Path.h

// Copyright (c) Stefano Cristiano
// SPDX-License-Identifier: MIT
#pragma once
#include "../Strings/StringView.h"
 
namespace SC
{
struct String;
 
 
struct SC_COMPILER_EXPORT Path
{
    enum Type
    {
        AsPosix,
        AsWindows,
#if SC_PLATFORM_WINDOWS
        AsNative = AsWindows
#else
        AsNative = AsPosix
#endif
    };
    struct ParsedView
    {
        bool endsWithSeparator = false;
 
        // TODO: ParsedView::directory and base are not defined consistently
 
        Type       type = AsPosix; 
        StringView root;           
        StringView directory;      
        StringView base;           
        StringView name;           
        StringView ext;            
 
        [[nodiscard]] bool parseWindows(StringView input);
 
        [[nodiscard]] bool parsePosix(StringView input);
    };
 
    [[nodiscard]] static bool join(String& output, Span<const StringView> inputs,
                                   StringView separator = SeparatorStringView(), bool skipEmpty = false);
 
    [[nodiscard]] static bool parseNameExtension(const StringView input, StringView& name, StringView& extension);
 
    [[nodiscard]] static bool parse(StringView input, Path::ParsedView& pathView, Type type);
 
    [[nodiscard]] static StringView dirname(StringView input, Type type, int repeat = 0);
 
    [[nodiscard]] static StringView basename(StringView input, Type type);
 
    [[nodiscard]] static StringView basename(StringView input, StringView suffix);
 
    [[nodiscard]] static bool isAbsolute(StringView input, Type type);
 
    struct Windows
    {
        static const char Separator = '\\';
 
        [[nodiscard]] static constexpr StringView SeparatorStringView() { return "\\"_a8; };
    };
 
    struct Posix
    {
        static const char Separator = '/';
 
        [[nodiscard]] static constexpr StringView SeparatorStringView() { return "/"_a8; }
    };
 
#if SC_PLATFORM_WINDOWS
    static constexpr char Separator = '\\';
#else
    static constexpr char Separator = '/';
#endif
 
#if SC_PLATFORM_WINDOWS
    [[nodiscard]] static constexpr StringView SeparatorStringView() { return "\\"_a8; };
#else
    [[nodiscard]] static constexpr StringView SeparatorStringView() { return "/"_a8; }
#endif
 
    template <int numComponents = 64>
    [[nodiscard]] static bool normalize(String& output, StringView view, Type type)
    {
        StringView components[numComponents];
        return normalize(output, view, type, components);
    }
 
    [[nodiscard]] static bool normalize(String& output, StringView view, Type type, Span<StringView> components);
 
    [[nodiscard]] static bool relativeFromTo(StringView source, StringView destination, String& output, Type type,
                                             Type outputType = AsNative);
 
    [[nodiscard]] static bool append(String& output, Span<const StringView> paths, Type inputType);
 
    [[nodiscard]] static bool endsWithSeparator(StringView path);
 
    [[nodiscard]] static StringView removeStartingSeparator(StringView path);
 
    [[nodiscard]] static bool normalizeUNCAndTrimQuotes(String& outputPath, StringView fileLocation, Type type,
                                                        Span<StringView> components);
 
  private:
    [[nodiscard]] static bool appendTrailingSeparator(String& path, Type type);
 
    [[nodiscard]] static StringView removeTrailingSeparator(StringView path);
    struct Internal;
};
 
} // namespace SC