Add string input/output support to migration tool

Adds ConvertTo-PSResourceGetString function and -InputScript parameter
to the entry-point script, enabling direct string-to-string conversion
without needing files on disk.

Usage:
  .\ConvertTo-PSResourceGet.ps1 -InputScript 'Install-Module -Name Pester'
  'Find-Module -Name Az' | .\ConvertTo-PSResourceGet.ps1

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Author: adityapatwardhan

tool/migration/ConvertTo-PSResourceGet.ps1

@@ -6,15 +6,19 @@
     Converts PowerShellGet v2 cmdlet usage to PSResourceGet equivalents.
 
 .DESCRIPTION
-    Scans PowerShell files (.ps1, .psm1, .psd1) for PSGet v2 cmdlet usage
-    (e.g., Install-Module, Find-Module) and converts them to their
-    PSResourceGet equivalents (e.g., Install-PSResource, Find-PSResource).
+    Scans PowerShell files (.ps1, .psm1, .psd1) or inline script strings for
+    PSGet v2 cmdlet usage (e.g., Install-Module, Find-Module) and converts them
+    to their PSResourceGet equivalents (e.g., Install-PSResource, Find-PSResource).
 
     By default, runs in WhatIf/report mode. Use -Apply to modify files.
 
 .PARAMETER Path
     Path to a file or directory to scan. Supports wildcards.
-    Defaults to the current directory.
+    Defaults to the current directory. Cannot be used with -InputScript.
+
+.PARAMETER InputScript
+    A string containing PowerShell script text to convert. The converted string
+    is returned as output. Cannot be used with -Path.
 
 .PARAMETER Recurse
     When Path is a directory, scan subdirectories recursively.
@@ -39,17 +43,31 @@
 .EXAMPLE
     # Scan a single file and get structured output
     .\ConvertTo-PSResourceGet.ps1 -Path .\deploy.ps1 -PassThru
+
+.EXAMPLE
+    # Convert a script string and get the converted text back
+    .\ConvertTo-PSResourceGet.ps1 -InputScript 'Install-Module -Name Pester -Force'
+
+.EXAMPLE
+    # Pipe a string for conversion
+    'Find-Module -Name Az -AllowPrerelease' | .\ConvertTo-PSResourceGet.ps1
 #>
 
-[CmdletBinding(SupportsShouldProcess)]
+[CmdletBinding(SupportsShouldProcess, DefaultParameterSetName = 'Path')]
 param(
-    [Parameter(Position = 0)]
-    [string] $Path = '.',
+    [Parameter(Position = 0, ParameterSetName = 'Path')]
+    [string] $Path,
+
+    [Parameter(Mandatory, ParameterSetName = 'String', ValueFromPipeline)]
+    [string] $InputScript,
 
+    [Parameter(ParameterSetName = 'Path')]
     [switch] $Recurse,
 
+    [Parameter(ParameterSetName = 'Path')]
     [switch] $Apply,
 
+    [Parameter(ParameterSetName = 'Path')]
     [string] $BackupPath,
 
     [switch] $PassThru
@@ -59,6 +77,23 @@ param(
 $modulePath = Join-Path $PSScriptRoot 'PSGetMigration.psm1'
 Import-Module $modulePath -Force
 
+# String input mode
+if ($PSCmdlet.ParameterSetName -eq 'String') {
+    $result = ConvertTo-PSResourceGetString -InputScript $InputScript
+    if ($PassThru) {
+        $result
+    }
+    else {
+        $result.ConvertedScript
+    }
+    return
+}
+
+# File/directory mode
+if (-not $Path) {
+    $Path = '.'
+}
+
 # Resolve files to scan
 $resolvedPath = Resolve-Path -Path $Path -ErrorAction Stop
 

tool/migration/PSGetMigration.psd1

@@ -16,6 +16,7 @@
         'Find-PSGetCommand',
         'Convert-PSGetCommand',
         'ConvertTo-PSResourceGetScript',
+        'ConvertTo-PSResourceGetString',
         'Format-MigrationReport'
     )
     CmdletsToExport   = @()

tool/migration/PSGetMigration.psm1

@@ -454,6 +454,87 @@ function ConvertTo-PSResourceGetScript {
 
 #endregion
 
+#region String Converter
+
+function ConvertTo-PSResourceGetString {
+    <#
+    .SYNOPSIS
+        Converts PSGet v2 cmdlet usage in a script string to PSResourceGet equivalents.
+    .PARAMETER InputScript
+        A string containing PowerShell script text with PSGet v2 commands.
+    .OUTPUTS
+        PSCustomObject with: ConvertedScript, Conversions (detail array), Warnings
+    .EXAMPLE
+        $result = ConvertTo-PSResourceGetString -InputScript 'Install-Module -Name Pester -Force'
+        $result.ConvertedScript  # → 'Install-PSResource -Name Pester -Reinstall'
+    #>
+    [CmdletBinding()]
+    [OutputType([PSCustomObject])]
+    param(
+        [Parameter(Mandatory, ValueFromPipeline)]
+        [string] $InputScript
+    )
+
+    process {
+        # Write to a temp file so the AST parser can process it
+        $tempFile = [System.IO.Path]::GetTempFileName() -replace '\.tmp$', '.ps1'
+        try {
+            [System.IO.File]::WriteAllText($tempFile, $InputScript)
+
+            $commands = @(Find-PSGetCommand -Path $tempFile)
+            $allWarnings = [System.Collections.Generic.List[string]]::new()
+
+            if ($commands.Count -eq 0) {
+                return [PSCustomObject]@{
+                    ConvertedScript = $InputScript
+                    Conversions     = @()
+                    Warnings        = @()
+                }
+            }
+
+            # Convert each command and collect results
+            $conversions = foreach ($cmd in $commands) {
+                $result = Convert-PSGetCommand -CommandInfo $cmd
+                $result | Add-Member -NotePropertyName 'StartOffset' -NotePropertyValue $cmd.StartOffset
+                $result | Add-Member -NotePropertyName 'EndOffset' -NotePropertyValue $cmd.EndOffset
+                foreach ($w in $result.Warnings) { $allWarnings.Add($w) }
+                $result
+            }
+
+            # Apply replacements in reverse offset order
+            $output = $InputScript
+            $sortedConversions = $conversions |
+                Where-Object { $_.Status -eq 'Converted' -and $null -ne $_.ConvertedText } |
+                Sort-Object -Property StartOffset -Descending
+
+            foreach ($conv in $sortedConversions) {
+                $output = $output.Substring(0, $conv.StartOffset) +
+                          $conv.ConvertedText +
+                          $output.Substring($conv.EndOffset)
+            }
+
+            return [PSCustomObject]@{
+                ConvertedScript = $output
+                Conversions     = @($conversions | ForEach-Object {
+                    [PSCustomObject]@{
+                        Line          = $_.Line
+                        OriginalText  = $_.OriginalText
+                        ConvertedText = $_.ConvertedText
+                        Warnings      = $_.Warnings
+                        Status        = $_.Status
+                    }
+                })
+                Warnings        = $allWarnings.ToArray()
+            }
+        }
+        finally {
+            Remove-Item $tempFile -Force -ErrorAction SilentlyContinue
+        }
+    }
+}
+
+#endregion
+
 #region Formatting
 
 function Format-MigrationReport {
@@ -540,5 +621,6 @@ Export-ModuleMember -Function @(
     'Find-PSGetCommand',
     'Convert-PSGetCommand',
     'ConvertTo-PSResourceGetScript',
+    'ConvertTo-PSResourceGetString',
     'Format-MigrationReport'
 )

tool/migration/Tests/PSGetMigration.Tests.ps1

@@ -282,4 +282,58 @@ Find-Module -Name Az -AllowPrerelease
             }
         }
     }
-}
+
+    Context 'ConvertTo-PSResourceGetString' {
+        It 'Converts a simple command string' {
+            $result = ConvertTo-PSResourceGetString -InputScript 'Install-Module -Name Pester'
+            $result.ConvertedScript | Should -Be 'Install-PSResource -Name Pester'
+            $result.Conversions.Count | Should -Be 1
+        }
+
+        It 'Converts multiple commands in a script string' {
+            $script = @'
+Install-Module -Name Pester -Force
+Find-Module -Name Az -AllowPrerelease
+'@
+            $result = ConvertTo-PSResourceGetString -InputScript $script
+            $result.ConvertedScript | Should -Match 'Install-PSResource'
+            $result.ConvertedScript | Should -Match 'Find-PSResource'
+            $result.ConvertedScript | Should -Match '-Prerelease'
+            $result.ConvertedScript | Should -Not -Match 'Install-Module'
+            $result.ConvertedScript | Should -Not -Match 'Find-Module'
+            $result.Conversions.Count | Should -Be 2
+        }
+
+        It 'Returns the original string when no PSGet commands are found' {
+            $script = 'Get-Module -Name Pester'
+            $result = ConvertTo-PSResourceGetString -InputScript $script
+            $result.ConvertedScript | Should -Be $script
+            $result.Conversions.Count | Should -Be 0
+        }
+
+        It 'Collects warnings from removed parameters' {
+            $result = ConvertTo-PSResourceGetString -InputScript 'Install-Module -Name Pester -AllowClobber -Force'
+            $result.Warnings.Count | Should -BeGreaterThan 0
+            $result.ConvertedScript | Should -Match '-Reinstall'
+        }
+
+        It 'Preserves surrounding script content' {
+            $script = @'
+# Setup
+$moduleName = 'Pester'
+Install-Module -Name $moduleName -Scope CurrentUser
+Write-Host 'Done'
+'@
+            $result = ConvertTo-PSResourceGetString -InputScript $script
+            $result.ConvertedScript | Should -Match '# Setup'
+            $result.ConvertedScript | Should -Match '\$moduleName = ''Pester'''
+            $result.ConvertedScript | Should -Match 'Install-PSResource'
+            $result.ConvertedScript | Should -Match "Write-Host 'Done'"
+        }
+
+        It 'Accepts pipeline input' {
+            $result = 'Find-Module -Name Az' | ConvertTo-PSResourceGetString
+            $result.ConvertedScript | Should -Be 'Find-PSResource -Name Az'
+        }
+    }
+}