consolidate scripts and function

Author: ramsessanchez

.azure-pipelines/common-templates/install-tools.yml

@@ -78,33 +78,9 @@ steps:
   - task: PowerShell@2
     displayName: Pre-populate autorest extension cache
     inputs:
-      targetType: inline
+      targetType: filePath
       pwsh: true
-      script: |
-        # Autorest resolves extensions from ~/.autorest/<pkg>/<version>/node_modules/.
-        # Pre-install every extension referenced by autorest-configuration.md so autorest
-        # makes zero npm network calls during module generation.
-        # Registry and auth are read from ~/.npmrc (copied from the authenticated .npmrc above).
-        $extensions = @(
-            "@autorest/core@3.10.4",
-            "@autorest/modelerfour@4.24.3"
-        )
-        foreach ($ext in $extensions) {
-            $parts   = $ext -split '@(?=[^@]+$)'   # split on last @
-            $pkg     = $parts[0]
-            $ver     = $parts[1]
-            $cacheDir = Join-Path $env:USERPROFILE ".autorest\$($pkg.Replace('/','\'))\$ver"
-            $nodeModules = Join-Path $cacheDir "node_modules\$($pkg.Replace('/','\'))"
-            if (Test-Path $nodeModules) {
-                Write-Host "Cache already present: $ext"
-                continue
-            }
-            New-Item -ItemType Directory -Force -Path $cacheDir | Out-Null
-            Write-Host "Pre-installing $ext into $cacheDir"
-            npm install $ext --prefix $cacheDir
-            if ($LASTEXITCODE -ne 0) { throw "Failed to pre-install $ext (exit $LASTEXITCODE)" }
-            Write-Host "Done: $ext"
-        }
+      filePath: $(Build.SourcesDirectory)/tools/utilities/PrePopulateAutorestCache.ps1
 
   - task: Npm@1
     displayName: Install Rush

tools/ReadModuleReadMe.ps1

@@ -6,17 +6,7 @@ param(
     [Parameter(Mandatory = $true)][ValidateNotNullOrEmpty()][string] $FieldToRead
 ) 
 $ErrorActionPreference = "Stop"
-
-function ConvertFrom-SimpleYaml {
-    param([string]$Yaml)
-    $result = @{}
-    $Yaml -split "`n" | ForEach-Object {
-        if ($_.Trim() -match '^([^:]+):\s*(.*)$') {
-            $result[$Matches[1].Trim()] = $Matches[2].Trim()
-        }
-    }
-    return $result
-}
+. "$PSScriptRoot\utilities\utils.ps1"
 
 $FieldValue = $null
 # Read readme.md.

tools/Utilities/PrePopulateAutorestCache.ps1

@@ -0,0 +1,42 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+<#
+.SYNOPSIS
+    Pre-populates the autorest extension cache so that autorest makes zero npm
+    network calls during module generation.
+
+.DESCRIPTION
+    Autorest resolves extensions from ~/.autorest/<pkg>/<version>/node_modules/.
+    This script pre-installs every extension referenced by
+    autorest-configuration.md into that cache layout.
+    Registry and auth are read from ~/.npmrc (copied from the authenticated
+    .npmrc earlier in the pipeline).
+#>
+
+[CmdletBinding()]
+param()
+
+$extensions = @(
+    "@autorest/core@3.10.4",
+    "@autorest/modelerfour@4.24.3"
+)
+
+foreach ($ext in $extensions) {
+    $parts   = $ext -split '@(?=[^@]+$)'   # split on last @
+    $pkg     = $parts[0]
+    $ver     = $parts[1]
+    $cacheDir = Join-Path $env:USERPROFILE ".autorest\$($pkg.Replace('/','\'))\$ver"
+    $nodeModules = Join-Path $cacheDir "node_modules\$($pkg.Replace('/','\'))"
+
+    if (Test-Path $nodeModules) {
+        Write-Host "Cache already present: $ext"
+        continue
+    }
+
+    New-Item -ItemType Directory -Force -Path $cacheDir | Out-Null
+    Write-Host "Pre-installing $ext into $cacheDir"
+    npm install $ext --prefix $cacheDir
+    if ($LASTEXITCODE -ne 0) { throw "Failed to pre-install $ext (exit $LASTEXITCODE)" }
+    Write-Host "Done: $ext"
+}

tools/Utilities/utils.ps1

@@ -24,4 +24,18 @@ Function Get-LocalCertificate {
         $global:DefaultCertificate = $pfxCertificate
     }
     return $global:DefaultCertificate
+}
+
+<#
+    Converts a simple single-level YAML string into a hashtable.
+#>
+Function ConvertFrom-SimpleYaml {
+    param([string]$Yaml)
+    $result = @{}
+    $Yaml -split "`n" | ForEach-Object {
+        if ($_.Trim() -match '^([^:]+):\s*(.*)$') {
+            $result[$Matches[1].Trim()] = $Matches[2].Trim()
+        }
+    }
+    return $result
 }

tools/WriteToModuleReadMe.ps1

@@ -7,17 +7,7 @@ param(
     [Parameter(Mandatory = $true)][ValidateNotNullOrEmpty()][string] $NewFieldValue
 ) 
 $ErrorActionPreference = "Stop"
-
-function ConvertFrom-SimpleYaml {
-    param([string]$Yaml)
-    $result = @{}
-    $Yaml -split "`n" | ForEach-Object {
-        if ($_.Trim() -match '^([^:]+):\s*(.*)$') {
-            $result[$Matches[1].Trim()] = $Matches[2].Trim()
-        }
-    }
-    return $result
-}
+. "$PSScriptRoot\utilities\utils.ps1"
 
 # Read readme.md.
 $ReadMeContent = Get-Content $ReadMePath -Delimiter "### Versioning"