Add GetCanonicalRelativePath.

2 files changed, 22 insertions, 0 deletions

diff --git a/src/WixToolset.Extensibility/Services/IBackendHelper.cs b/src/WixToolset.Extensibility/Services/IBackendHelper.cs
index 26023674..bfec5256 100644
--- a/src/WixToolset.Extensibility/Services/IBackendHelper.cs
+++ b/src/WixToolset.Extensibility/Services/IBackendHelper.cs
@@ -36,6 +36,17 @@ namespace WixToolset.Extensibility.Services
         IResolvedDirectory CreateResolvedDirectory(string directoryParent, string name);
 
         /// <summary>
+        /// Validates path is relative and canonicalizes it.
+        /// For example, "a\..\c\.\d.exe" => "c\d.exe".
+        /// </summary>
+        /// <param name="sourceLineNumbers"></param>
+        /// <param name="elementName"></param>
+        /// <param name="attributeName"></param>
+        /// <param name="relativePath"></param>
+        /// <returns>The original value if not relative, otherwise the canonicalized relative path.</returns>
+        string GetCanonicalRelativePath(SourceLineNumber sourceLineNumbers, string elementName, string attributeName, string relativePath);
+
+        /// <summary>
         /// Creates a tracked file.
         /// </summary>
         /// <param name="path">Destination path for the build output.</param>
diff --git a/src/WixToolset.Extensibility/Services/IParseHelper.cs b/src/WixToolset.Extensibility/Services/IParseHelper.cs
index a7c5eb1b..08bcd911 100644
--- a/src/WixToolset.Extensibility/Services/IParseHelper.cs
+++ b/src/WixToolset.Extensibility/Services/IParseHelper.cs
@@ -341,6 +341,17 @@ namespace WixToolset.Extensibility.Services
         YesNoDefaultType GetAttributeYesNoDefaultValue(SourceLineNumber sourceLineNumbers, XAttribute attribute);
 
         /// <summary>
+        /// Validates path is relative and canonicalizes it.
+        /// For example, "a\..\c\.\d.exe" => "c\d.exe".
+        /// </summary>
+        /// <param name="sourceLineNumbers"></param>
+        /// <param name="elementName"></param>
+        /// <param name="attributeName"></param>
+        /// <param name="relativePath"></param>
+        /// <returns>The original value if not relative, otherwise the canonicalized relative path.</returns>
+        string GetCanonicalRelativePath(SourceLineNumber sourceLineNumbers, string elementName, string attributeName, string relativePath);
+
+        /// <summary>
         /// Gets a source line number for an element.
         /// </summary>
         /// <param name="element">Element to get source line number.</param>