Merge pull request #6537 from maddieclayton/docsscript

Add script to generate output types for docs

Author: Maddie Clayton

.gitignore

@@ -218,6 +218,8 @@ pingme.txt
 groupMapping*.json
 /tools/index.json
 /Package/index.json
+/tools/outputtypes.json
+/Package/outputtypes.json
 
 *.msi
 *.wixpdb

build.proj

@@ -280,7 +280,7 @@
 
     <Exec ContinueOnError="false"
       Command="&quot;$(PowerShellCommand)&quot; -NonInteractive -NoLogo -NoProfile -Command &quot; . $(LibraryToolsFolder)\NewHelpIndex.ps1 -OutputFile $(PackageDirectory)\index.json -BuildConfig $(Configuration) &quot;" 
-	  Condition=" '$(Scope)' == 'All' or '$(Scope)' == 'Latest' and $(CodeSign) == 'true'"/>
+	    Condition=" ('$(Scope)' == 'All' or '$(Scope)' == 'Latest') and $(CodeSign) == 'true'"/>
 
     <!-- Copying modules to be signed -->
 
@@ -314,6 +314,11 @@
           Condition= " '$(Scope)' == 'All' or '$(Scope)' == 'Stack' "/>
 
     <CallTarget Targets="CodeSignBinaries" Condition=" '$(CodeSign)' == 'true' " />
+
+    <Exec ContinueOnError="false"
+      Command="&quot;$(PowerShellCommand)&quot; -NonInteractive -NoLogo -NoProfile -Command &quot; . $(LibraryToolsFolder)\NewOutputTypeIndex.ps1 -OutputFile $(PackageDirectory)\outputtypes.json -BuildConfig $(Configuration) &quot;" 
+      Condition=" ('$(Scope)' == 'All' or '$(Scope)' == 'Latest') and $(CodeSign) == 'true'"/>
+      
     <!-- AzureRM -->
     <Copy SourceFiles="$(PackageDirectory)\$(Configuration)\AzureRM.psd1"
           DestinationFolder="$(LibraryToolsFolder)\AzureRM" Condition= " '$(Scope)' == 'All' or '$(Scope)' == 'Latest' "/>

tools/NewOutputTypeIndex.ps1

@@ -0,0 +1,48 @@
+param(
+    [Parameter(Mandatory = $false)]
+    [string] $BuildConfig = "Debug",
+    [Parameter(Mandatory = $false)]
+    [string] $OutputFile = "$PSScriptRoot/outputtypes.json"
+)
+
+# Get all psd1 files
+$psd1Files = Get-Childitem $PSScriptRoot\..\src\Package\$BuildConfig\ResourceManager -Recurse | where {$_.Name -like "*.psd1" }
+$psd1Files += Get-Childitem $PSScriptRoot\..\src\Package\$BuildConfig\Storage -Recurse | where {$_.Name -like "*.psd1" }
+
+$profilePsd1 = $psd1Files | Where-Object {$_.Name -like "*AzureRM.Profile.psd1"}
+Import-LocalizedData -BindingVariable "psd1File" -BaseDirectory $profilePsd1.DirectoryName -FileName $profilePsd1.Name
+foreach ($nestedModule in $psd1File.RequiredAssemblies)
+{
+    $dllPath = Join-Path -Path $profilePsd1.DirectoryName -ChildPath $nestedModule
+    $Assembly = [Reflection.Assembly]::LoadFrom($dllPath)
+}
+
+
+$outputTypes = New-Object System.Collections.Generic.HashSet[string]
+
+$psd1Files | ForEach {
+    Import-LocalizedData -BindingVariable "psd1File" -BaseDirectory $_.DirectoryName -FileName $_.Name
+    foreach ($nestedModule in $psd1File.NestedModules)
+    {
+        $dllPath = Join-Path -Path $_.DirectoryName -ChildPath $nestedModule
+        $Assembly = [Reflection.Assembly]::LoadFrom($dllPath)
+        $exportedTypes = $Assembly.GetTypes()
+        foreach ($exportedType in $exportedTypes)
+        {
+            foreach ($attribute in $exportedType.CustomAttributes)
+            {
+                if ($attribute.AttributeType.Name -eq "OutputTypeAttribute")
+                {
+                    $cmdletOutputTypes = $attribute.ConstructorArguments.Value.Value
+                    foreach ($cmdletOutputType in $cmdletOutputTypes)
+                    {
+                        $outputTypes.Add($cmdletOutputType.FullName) | Out-Null
+                    }
+                }
+            }
+        }
+    }
+}
+
+$json = ConvertTo-Json $outputTypes
+$json | Out-File "$OutputFile"