fix: InputObject hashtable no longer mutated by Get-Dependency (#35)

CHANGELOG.md

@@ -7,6 +7,12 @@
 
 ## [Unreleased]
 
+### Fixed
+
+- `Get-Dependency -InputObject` no longer mutates the caller's hashtable:
+  `PSDependOptions` is now preserved after the call, so a second invocation
+  with the same object still honors global options such as `Target` (#35).
+
 ## [0.4.1] - 2026-06-12
 
 ### Added
@@ -127,7 +133,7 @@
 ### Fixed
 
 - `Get-Dependency` operator-precedence bug when `DependencyType` is
   set inside `PSDependOptions`: parenthesization was incorrect, so the
   global default failed to apply to dependencies without an explicit
   type (#131, #173).
 - `Find-PSDependLocally` now consults *all* installed versions of a
@@ -138,7 +144,7 @@
   passing it to `Import-Module`, preventing failures when prerelease
   segments or `vX.Y.Z` tags appear in the resolved version (#140).
 - `Chocolatey` install path now passes `--yes` to `choco install`
   (previously the script contained the typo `--yess`), so installs
   no longer hang waiting on confirmation, and the surrounding code
   was tidied for readability (#174).
 - `Git` handler now uses the full `Dependency.Target` path when the

PSDepend/Public/Get-Dependency.ps1

@@ -25,7 +25,7 @@
 
         These are parsed from dependency PSD1 files as follows:
 
         Simple syntax, intepreted:
             @{
                 DependencyName = 'Version'
             }
@@ -128,7 +128,7 @@
     .LINK
         https://github.com/PowerShellOrg/PSDepend
     #>
     [cmdletbinding(DefaultParameterSetName = 'File')]
     param(
         [parameter(ParameterSetName = 'File')]
         [string[]]$Path = $PWD.Path,
@@ -146,7 +146,7 @@
         [hashtable]$Credentials
     )
 
     # Helper to pick from global psdependoptions, or return a default
     function Get-GlobalOption {
         param(
             $Options = $PSDependOptions,
@@ -179,7 +179,7 @@
     }
 
     function Inject-Variable {
         [cmdletbinding()]
         param( $Value )
         $Output = $Value
         switch ($Value) {
@@ -214,14 +214,14 @@
 
     # Helper to take in a dependency hash and output Dependency objects
     function Parse-Dependency {
         [cmdletbinding()]
         param(
             $ParamSet = $PSCmdlet.ParameterSetName
         )
 
         # Global settings....
         $PSDependOptions = $null
         if ($Dependencies.Containskey('PSDependOptions')) {
             $PSDependOptions = $Dependencies.PSDependOptions
             $Dependencies.Remove('PSDependOptions')
         }
@@ -358,7 +358,7 @@
                         $DependencyType = 'Git'
                     }
                     else {
                         # finally, psgallerymodule
                         $DependencyType = 'PSGalleryModule'
                     }
                 }
@@ -437,7 +437,7 @@
     elseif ($PSCmdlet.ParameterSetName -eq 'Hashtable') {
         $DependencyFile = 'Hashtable'
         $ParsedDependencies = foreach ($InputDependency in $InputObject) {
-            $Dependencies = $InputDependency
+            $Dependencies = $InputDependency.Clone()
 
             Parse-Dependency -ParamSet $PSCmdlet.ParameterSetName
         }

Tests/PSDepend.Tests.ps1

@@ -1,5 +1,5 @@
 BeforeDiscovery {
     if ($null -eq $env:BHPSModuleManifest) {
         & "$PSScriptRoot/../Build.ps1" -Task Init
     }
     $manifest = Import-PowerShellDataFile -Path $env:BHPSModuleManifest
@@ -119,6 +119,27 @@
             $Dependencies | Should -BeNullOrEmpty
         }
 
+        It 'Does not mutate the caller''s InputObject — PSDependOptions key survives after Get-Dependency' {
+            $inputObj = @{
+                PSDependOptions = @{ Target = 'CurrentUser' }
+                Pester          = 'latest'
+            }
+            $null = Get-Dependency -InputObject $inputObj
+            $inputObj.ContainsKey('PSDependOptions') | Should -Be $True
+        }
+
+        It 'Does not mutate the caller''s InputObject — PSDependOptions honored on a second Get-Dependency call' {
+            $inputObj = @{
+                PSDependOptions = @{ Target = 'CurrentUser' }
+                Pester          = 'latest'
+            }
+            $null = Get-Dependency -InputObject $inputObj
+            $deps2 = Get-Dependency -InputObject $inputObj
+            $inputObj.ContainsKey('PSDependOptions') | Should -Be $True
+            $inputObj.PSDependOptions.Target | Should -Be 'CurrentUser'
+            ($deps2 | Where-Object DependencyName -eq 'Pester').Target | Should -Be 'CurrentUser'
+        }
+
         It 'Parses -InputObject hashtable as PSGalleryModule by default' {
             $Dependencies = Get-Dependency -InputObject @{ Pester = 'latest' }
             $Dependencies.DependencyName | Should -Be 'Pester'