feat: add Path APIs

Author: vinniefalco

include/mrdox/Support/Path.hpp

@@ -0,0 +1,31 @@
+//
+// Licensed under the Apache License v2.0 with LLVM Exceptions.
+// See https://llvm.org/LICENSE.txt for license information.
+// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
+//
+// Copyright (c) 2023 Vinnie Falco (vinnie.falco@gmail.com)
+//
+// Official repository: https://github.com/cppalliance/mrdox
+//
+
+#ifndef MRDOX_SUPPORT_PATH_HPP
+#define MRDOX_SUPPORT_PATH_HPP
+
+#include <mrdox/Platform.hpp>
+#include <string>
+#include <string_view>
+
+namespace clang {
+namespace mrdox {
+
+/** Return a full path from a possibly relative path.
+*/
+std::string
+makeFullPath(
+    std::string_view pathName,
+    std::string_view workingDir);
+
+} // mrdox
+} // clang
+
+#endif

source/Support/Path.cpp

@@ -10,10 +10,40 @@
 //
 
 #include "Path.hpp"
+#include <llvm/Support/FileSystem.h>
+#include <llvm/Support/Path.h>
 
 namespace clang {
 namespace mrdox {
 
+//------------------------------------------------
+
+std::string
+makeFullPath(
+    std::string_view pathName,
+    std::string_view workingDir)
+{
+    namespace path = llvm::sys::path;
+
+    llvm::SmallString<0> result;
+
+    if(! path::is_absolute(pathName))
+    {
+        result = workingDir;
+        path::append(result, path::Style::posix, pathName);
+        path::remove_dots(result, true, path::Style::posix);
+        return std::string(result);
+    }
+
+    result = pathName;
+    path::remove_dots(result, true);
+    convert_to_slash(result);
+    return std::string(result);
+}
+
+
+//------------------------------------------------
+
 llvm::StringRef
 convert_to_slash(
     llvm::SmallVectorImpl<char> &path,

source/Support/Path.hpp

@@ -19,11 +19,13 @@
 namespace clang {
 namespace mrdox {
 
-/// Replaces backslashes with slashes if Windows in place.
-///
-/// @param path A path that is transformed to native format.
-/// On Unix, this function is a no-op because backslashes
-/// are valid path chracters.
+/** Replaces backslashes with slashes if Windows in place.
+
+    @param path A path that is transformed to native format.
+
+    On Unix, this function is a no-op because backslashes
+    are valid path chracters.
+*/
 llvm::StringRef
 convert_to_slash(
     llvm::SmallVectorImpl<char> &path,