[Tools] Apply current structure for Ps1XmlGenerator (Azure#23619)

* apply current structure

* polish

* Update tools/FormatPs1XmlGenerator/FormatPs1XmlGenerator.Test/FormatPs1XmlGenerator.Test.csproj

* Update generate-format.ps1xml-file.md

Author: BethanyZhou

documentation/development-docs/generate-format.ps1xml-file.md

@@ -359,21 +359,21 @@ This will place the column at the very beginning of the table.
 
     * Below is an example of how to generate a format.ps1xml file for the ```Az.Storage``` module:
     ```Powershell
-    PS E:\git\azure-powershell> New-FormatPs1Xml -OnlyMarkedProperties -ModulePath .\artifacts\Debug\Az.Storage\Az.Storage.psd1
+    PS E:\git\azure-powershell> New-FormatPs1Xml -OnlyMarkedProperties -ModulePath .\src\Storage\Storage\Az.Storage.psd1
     E:\git\azure-powershell\Microsoft.Azure.PowerShell.Cmdlets.Storage.Management.generated.format.ps1xml
     E:\git\azure-powershell\Microsoft.Azure.PowerShell.Cmdlets.Storage.generated.format.ps1xml
     ```
     * Below is an example of how to generate a format.ps1xml file for the ```Az.Account``` module:
     ```powershell
-    PS E:\git\azure-powershell> New-FormatPs1Xml -OnlyMarkedProperties -ModulePath .\artifacts\Debug\Az.Accounts\Az.Accounts.psd1
+    PS E:\git\azure-powershell> New-FormatPs1Xml -OnlyMarkedProperties -ModulePath .\src\Accounts\Accounts\Az.Accounts.psd1
     E:\git\azure-powershell\Microsoft.Azure.PowerShell.Cmdlets.Accounts.generated.format.ps1xml
     PS E:\git\azure-powershell>
     ```
 
 # How to test the format.ps1xml file.
 
 ## Let's take a look at how to check the newly created format.ps1xml file for the ```Az.Account``` module.
-**Note:** All the paths used in the example in the section are under **_azure-powershell/artifacts/Debug_**
+**Note:** All the paths used in the example in the section are under **_azure-powershell/src/<module_name>_**
 
 1. **Copy** the generated format.ps1xml file to the built module folder (this is where your module manifest file psd1 is located). In our example the module folder is 
 ```

tools/FormatPs1XmlGenerator/FormatPs1XmlGenerator.Test/FormatPs1XmlGenerator.Test.csproj

@@ -1,8 +1,9 @@
 <Project Sdk="Microsoft.NET.Sdk">
-	<Import Project="$(MSBuildThisFileDirectory)..\..\Common.Netcore.Dependencies.Test.targets" />
+	<Import Project="$(MSBuildThisFileDirectory)..\..\..\Repo.props" />
+	<Import Project="$(RepoTools)Common.Netcore.Dependencies.Test.targets" />
 
   <PropertyGroup>
-    <TargetFramework>netcoreapp3.1</TargetFramework>
+    <TargetFramework>netstandard2.0</TargetFramework>
     <IsPackable>false</IsPackable>
   </PropertyGroup>
 

tools/FormatPs1XmlGenerator/FormatPs1XmlGenerator.Test/NewFormatPs1XmlCommandShould.cs

@@ -11,17 +11,17 @@
 // limitations under the License.
 // ----------------------------------------------------------------------------------
 
+using System;
+using System.Linq;
+using System.Management.Automation;
+using System.Management.Automation.Runspaces;
+using Xunit;
+using System.IO;
+using System.Collections.Generic;
+using System.Xml.Linq;
+
 namespace FormatPs1XmlGenerator.Test
 {
-    using System;
-    using System.Linq;
-    using System.Management.Automation;
-    using System.Management.Automation.Runspaces;
-    using Xunit;
-    using System.IO;
-    using System.Collections.Generic;
-    using System.Xml.Linq;
-
     public class NewFormatPs1XmlCommandShould
     {
         private const string CmdletName = "New-FormatPs1Xml";

tools/FormatPs1XmlGenerator/FormatPs1XmlGenerator/NewFormatPs1XmlCommand.cs

@@ -15,6 +15,8 @@
 
 namespace FormatPs1XmlGenerator
 {
+    using Microsoft.Azure.Commands.ResourceManager.Common.ArgumentCompleters;
+
     using System;
     using System.Collections.Generic;
     using System.IO;
@@ -33,6 +35,13 @@ public class NewFormatPs1XmlCommand : PSCmdlet
         [Parameter(Position = 3, ValueFromPipeline = false, Mandatory = false)]
         public string OutputPath { get; set; }
 
+        [Parameter(Position = 4, ValueFromPipeline = false, Mandatory = false)]
+        [PSArgumentCompleter("Debug", "Release")]
+        public string Configuration { get; set; } = "Debug";
+
+        [Parameter(Position = 5, ValueFromPipeline = false, Mandatory = false)]
+        public string RepoArtifacts { get; set; } = "artifacts";
+
         [Parameter]
         public SwitchParameter Force { get; set; }
 
@@ -64,7 +73,11 @@ protected override void ProcessRecord()
                     }
                 }
 
-                foreach (var assemblyPath in GetAssemblyPath(ModulePath))
+                var moduleName = Path.GetFileNameWithoutExtension(ModulePath);
+                var RepoRoot = Path.GetDirectoryName(Path.GetDirectoryName(Path.GetDirectoryName(Path.GetDirectoryName(ModulePath))));
+                var moduleArtifactsOutputPath = Path.Combine(Path.Combine(RepoRoot, Path.Combine(RepoArtifacts, Configuration)), moduleName);
+
+                foreach (var assemblyPath in GetAssemblyPath(moduleArtifactsOutputPath, ModulePath))
                 {
                     Reflect(assemblyPath);
                 }
@@ -75,7 +88,7 @@ protected override void ProcessRecord()
             }
         }
 
-        internal static IEnumerable<string> GetAssemblyPath(string manifestPath)
+        internal static IEnumerable<string> GetAssemblyPath(string artifactsPath, string manifestPath)
         {
             // parse module (psd1 file) - get assemblies list
             var list = new List<string>();
@@ -85,9 +98,10 @@ internal static IEnumerable<string> GetAssemblyPath(string manifestPath)
                 var result = ps.Invoke();
                 var moduleInfo = (Hashtable)result[0].BaseObject;
                 if (moduleInfo == null) return list;
+
                 var nestedModules = (object[])moduleInfo["NestedModules"];
                 var moduleBase = Path.GetDirectoryName(manifestPath) ?? throw new InvalidOperationException("Unable to get module base directory from the manifest path");
-                list.AddRange(nestedModules.Select(nestedModule => Path.GetFullPath(Path.Combine(moduleBase, nestedModule.ToString()))));
+                list.AddRange(nestedModules.Select(nestedModule => Path.GetFullPath(Path.Combine(artifactsPath, nestedModule.ToString()))));
             }
 
             return list;