Localization model validation

src/Microsoft.TemplateEngine.Orchestrator.RunnableProjects/IFileSystemInfoExtensions.cs

@@ -0,0 +1,45 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+#nullable enable
+
+using System.IO;
+using Microsoft.TemplateEngine.Abstractions.Mount;
+
+namespace Microsoft.TemplateEngine.Orchestrator.RunnableProjects
+{
+    internal static class IFileSystemInfoExtensions
+    {
+        /// <summary>
+        /// Returns full path to <paramref name="fileSystemInfo"/> including mount point URI in a format
+        /// that is suitable for displaying in the CLI or printing to logs.
+        /// This method wraps the path with quotes if it contains spaces.
+        /// </summary>
+        /// <param name="fileSystemInfo">the file system info to get full path for.</param>
+        /// <returns>
+        /// Full path to <paramref name="fileSystemInfo"/> including mount point URI.
+        /// If mount point is not a directory, the path is returned as 'mount point URI(path inside mount point)'.
+        /// </returns>
+        internal static string GetDisplayPath(this IFileSystemInfo fileSystemInfo)
+        {
+            string result = string.Empty;
+            if (fileSystemInfo.MountPoint.EnvironmentSettings.Host.FileSystem.DirectoryExists(fileSystemInfo.MountPoint.MountPointUri))
+            {
+                //mount point is a directory, combine paths
+                result = Path.Combine(fileSystemInfo.MountPoint.MountPointUri, fileSystemInfo.FullPath.Trim('/', '\\'));
+            }
+            else
+            {
+                //assuming file or anything else
+                result = $"{fileSystemInfo.MountPoint.MountPointUri}({fileSystemInfo.FullPath})";
+            }
+
+            if (result.Contains(" "))
+            {
+                result = '"' + result + '"';
+            }
+
+            return result;
+        }
+    }
+}

src/Microsoft.TemplateEngine.Orchestrator.RunnableProjects/IRunnableProjectConfig.cs

@@ -42,14 +42,14 @@ internal interface IRunnableProjectConfig
 
         IReadOnlyList<string> IgnoreFileNames { get; }
 
-        IReadOnlyList<IPostActionModel> PostActionModel { get; }
+        IReadOnlyList<IPostActionModel> PostActionModels { get; }
 
         IReadOnlyList<ICreationPathModel> PrimaryOutputs { get; }
 
         string GeneratorVersions { get; }
 
         IReadOnlyDictionary<string, IBaselineInfo> BaselineInfo { get; }
 
-        void Evaluate(IParameterSet parameters, IVariableCollection rootVariableCollection, IFileSystemInfo configFile);
+        void Evaluate(IParameterSet parameters, IVariableCollection rootVariableCollection);
     }
 }

src/Microsoft.TemplateEngine.Orchestrator.RunnableProjects/ISymbolModel.cs

@@ -1,20 +1,40 @@
 // Licensed to the .NET Foundation under one or more agreements.
 // The .NET Foundation licenses this file to you under the MIT license.
 
+#nullable enable
+
 using System.Collections.Generic;
 
 namespace Microsoft.TemplateEngine.Orchestrator.RunnableProjects
 {
+    /// <summary>
+    /// Model, representing the data of a symbol.
+    /// </summary>
     internal interface ISymbolModel
     {
+        /// <summary>
+        /// Gets the type of the symbol.
+        /// </summary>
         string Type { get; }
 
-        string Binding { get; set; }
+        /// <summary>
+        /// Gets the name of the host property or the environment variable which will provide the value of this symbol.
+        /// </summary>
+        string? Binding { get; }
 
-        string Replaces { get; set; }
+        /// <summary>
+        /// Gets the text that should be replaced by the value of this symbol.
+        /// </summary>
+        string? Replaces { get; }
 
+        /// <summary>
+        /// Gets the replacement contexts that determine when this symbol is allowed to do replacement operations.
+        /// </summary>
         IReadOnlyList<IReplacementContext> ReplacementContexts { get; }
 
-        string FileRename { get; set; }
+        /// <summary>
+        /// Gets the part of the file name that should be replaced with the value of this symbol.
+        /// </summary>
+        string? FileRename { get; }
     }
 }