Psx

1.0.21284.43438

HashTable/HashTable.ps1

                                #region Copyright & License

# Copyright © 2012 - 2020 François Chabot

#

# Licensed under the Apache License, Version 2.0 (the "License");

# you may not use this file except in compliance with the License.

# You may obtain a copy of the License at

#

# http://www.apache.org/licenses/LICENSE-2.0

#

# Unless required by applicable law or agreed to in writing, software

# distributed under the License is distributed on an "AS IS" BASIS,

# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

# See the License for the specific language governing permissions and

# limitations under the License.

#endregion

Set-StrictMode -Version Latest

<#

.SYNOPSIS

    Compare two HashTables and returns an array of differences.

.DESCRIPTION

    The Compare-HashTable function computes differences between two HashTables. Results are returned as an array of

    objects with the properties: "Key" (the name of the key for which there is a difference), "SideIndicator" (one of

    "<=", "!=" or "=>"), "ReferenceValue" an "DifferenceValue" (resp. the Reference and Difference value associated

    with the Key).

.PARAMETER ReferenceHashTable

    The HashTable used as a reference for comparison.

.PARAMETER DifferenceHashTable

    The HashTable that is compared to the reference HashTable.

.EXAMPLE

    Compare-HashTable @{ a = 1 ; b = 2 ; c = 3 } @{ b = 2 ; c = 4 ; e = 5}

    Returns a difference for ("3 <="), c (3 "!=" 4) and e ("=>" 5).

.EXAMPLE

    $ReferenceHashTable = @{ a = 1 ; b = 2 ; c = 3 ; f = $null ; g = 6 }

    $DifferenceHashTable = @{ b = 2 ; c = 4 ; e = 5 ; f = $null ; g = $null }

    Compare-HashTable $ReferenceHashTable $DifferenceHashTable

    Returns a difference for a ("3 <="), c (3 "!=" 4), e ("=>" 5) and g (6 "<=").

.NOTES

    See https://gist.github.com/dbroeglin/c6ce3e4639979fa250cf

#>

function Compare-HashTable {

    [CmdletBinding()]

    [OutputType([PSCustomObject[]])]

    param (

        [Parameter(Mandatory = $true)]

        [HashTable]

        $ReferenceHashTable,

        [Parameter(Mandatory = $true)]

        [HashTable]

        $DifferenceHashTable,

        [Parameter(Mandatory = $false, DontShow)]

        [string]

        $Prefix = ''

    )

    Resolve-ActionPreference -Cmdlet $PSCmdlet -SessionState $ExecutionContext.SessionState

    $ReferenceHashTable.Keys + $DifferenceHashTable.Keys | Sort-Object -Unique -PipelineVariable key | ForEach-Object -Process {

        $propertyName = if ($Prefix) { "$Prefix.$key" } else { $key }

        if ($ReferenceHashTable.ContainsKey($key) -and !$DifferenceHashTable.ContainsKey($key)) {

            [PSCustomObject]@{Key = $propertyName ; ReferenceValue = $ReferenceHashTable.$key ; SideIndicator = '<' ; DifferenceValue = $null } | Tee-Object -Variable difference

            Write-Verbose -Message $difference

        } elseif (!$ReferenceHashTable.ContainsKey($key) -and $DifferenceHashTable.ContainsKey($key)) {

            [PSCustomObject]@{Key = $propertyName ; ReferenceValue = $null ; SideIndicator = '>' ; DifferenceValue = $DifferenceHashTable.$key } | Tee-Object -Variable difference

            Write-Verbose -Message $difference

        } else {

            $referenceValue, $differenceValue = $ReferenceHashTable.$key, $DifferenceHashTable.$key

            if ($referenceValue -ne $differenceValue) {

                [PSCustomObject]@{Key = $propertyName ; ReferenceValue = $referenceValue ; SideIndicator = '<>' ; DifferenceValue = $differenceValue } | Tee-Object -Variable difference

                Write-Verbose -Message $difference

            }

        }

    }

}

<#

.SYNOPSIS

    Returns a new HashTable which is the merging of the input hash tables.

.DESCRIPTION

    Properties are not overwritten during the merge operation unless forced. Even when forced it is possible to

    provide a list of properties not to overwrite.

.EXAMPLE

.NOTES

    © 2020 be.stateless.

#>

function Merge-HashTable {

    [CmdletBinding()]

    [OutputType([HashTable])]

    param(

        [Parameter(Position = 0, Mandatory = $true, ValueFromPipeline = $true)]

        [HashTable[]]

        $HashTable,

        [Parameter(Mandatory = $false)]

        [string[]]

        $Exclude = @(),

        [Parameter(Mandatory = $false)]

        [switch]

        $Force

    )

    begin {

        Resolve-ActionPreference -Cmdlet $PSCmdlet -SessionState $ExecutionContext.SessionState

        $result = @{ }

    }

    process {

        $HashTable | ForEach-Object -Process { $_ } -PipelineVariable currentHashTable | Select-Object -ExpandProperty Keys -PipelineVariable key | ForEach-Object -Process {

            $propertyExists = $result.ContainsKey($key)

            if (-not $propertyExists -or ($Force -and $key -notin $Exclude) ) {

                $result.$key = $currentHashTable.$key

                if ($propertyExists) {

                    Write-Verbose -Message "Property '$key' has been overwritten because it has been defined multiple times."

                }

            }

        }

    }

    end {

        $result

    }

}

# SIG # Begin signature block

# MIII0QYJKoZIhvcNAQcCoIIIwjCCCL4CAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB

# gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR

# AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQU3rbnipP9PvjBgS5uIN/+ojSl

# fEagggVMMIIFSDCCAzCgAwIBAgIJAJkr3mJdTBkUMA0GCSqGSIb3DQEBCwUAMEEx

# PzA9BgNVBAMeNgBpAGMAcgBhAGYAdABzAG8AZgB0AHcAYQByAGUAQABzAHQAYQB0

# AGUAbABlAHMAcwAuAGIAZTAeFw0yMTA2MjUxNDEyMjNaFw00MTA2MjAxNDEyMjNa

# MEExPzA9BgNVBAMeNgBpAGMAcgBhAGYAdABzAG8AZgB0AHcAYQByAGUAQABzAHQA

# YQB0AGUAbABlAHMAcwAuAGIAZTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoC

# ggIBAOeqdUHBv7sxSeX3aj6yPKj7PAvs8izpVXjyEBl5aR8mQneVcXuF53AH7EW1

# 6E5p4+Az5pJPGUD5c3tXhiGMF7vgLhQjO6hlaVBRIqiIYHikNLwMNy6YBMc/QQYM

# rPhqHEFsZ53dkBIIj3M8e3kFcTFA09n25yDtTPDab4nd9yUhc9Qc8+nfpIzfYsoP

# 1pZ3nCzhw6hN2/44v1dkQrG3dRYwt+px65p6NPNZWEJpt4VCJjIFh+lBYJdxm9d4

# X/rAnlHIkbv7liOavWDzgHVabS3hdAWtcDmynm+7+FcZDFqPWNCl3e4SS7xe4s/R

# CKFKA0IsfKkSk9YJlLgeSQIEXUOOWXJAGaLqnRD8xWLZsc4Oi9GZg7XV1mv/S88c

# oztXnwtAN3OOlRKBh2QbomMgxeMO0GvsLE/cq5Q/YKAoz+KGr/7LcZq9jzQ8IPus

# ZvWLeDXmxPiwJjpZc1koLgfGIEX2NStQTT3QmacWr9thrWcKvI+4uBmI4exS9B4a

# R3nV91w5EY+2RoYsHqej9LWwNamO96+jMX9pxprTX+EkLUuMAikw/po8sBC9MUUn

# 5pMWmUv7DCtQOLGGBDDMMMkn4ZcjpCEEdPGHRKfqNnD27ssGtDjiNzfQrsm67toU

# bBwUF+gyJq/YckWquYJhA9ZOFWEADuIwGnsOzsoRvuQyY+p9AgMBAAGjQzBBMA4G

# A1UdDwEB/wQEAwIHgDAWBgNVHSUBAf8EDDAKBggrBgEFBQcDAzAXBgNVHREEEDAO

# ggxzdGF0ZWxlc3MuYmUwDQYJKoZIhvcNAQELBQADggIBACithYM3qckZRc9+Xbfu

# a6gWr3HwjrW+FHKgjfrcOm8ZnLVapb9xFqsqrRQqd3RXWQDINEGrtI2rSfrzyfoK

# UiTgldIfQNP1ZcGY229d++90t3hdo2mlt05hjYlbMENloJHpsEP0vQZmwOcEimCT

# ex1pymYM+P9pj3j8UD1PT1eIZot6or8fBRl63UybyDSrM7L4UOkkAOniKxWy5pW6

# 6duS8SR+SZpr3Bv44NyXPj0Nv+MIpLmsLrd7XPBFmnGxzY01ZO9vzi9KEhM2wT5i

# jPqHDNOvfPiADtAa+EyUBzdJiqy9heCz/TMZQgMWGwtfqJNxWZmsHcha2anW4Qt+

# mzrLO4GojWoVog9uVSAq+l0a+YQsd1u1kUmm4vgZCFyUA+lEp4LkI7ca2VBHkLPD

# w+u2DoDMRiqFPZjO7BCKjGc0jj9B/qGR3JVt+tqDdB621xXf2YGF2oFvxZQ/keGt

# 0ujfJ+JwN3nCulDAA4773q6KUnfykyrvAgITNbRJL6TngeRKtw9VIJBPxzqMzLpV

# 5ggXNituwLaD1CCBJ1oo9DZHpL9gplXp1wGrelJOTiJhh+pdNsPtRH7CrranWa5h

# LFLuigqin0eewQ5giJ1VaiBVEseOmiZog+27UpFIv40aDzgGL3YxB/Mu0ojwrQtp

# WLmqJCmWnR5qxOm0yK+zNWe0MYIC7zCCAusCAQEwTjBBMT8wPQYDVQQDHjYAaQBj

# AHIAYQBmAHQAcwBvAGYAdAB3AGEAcgBlAEAAcwB0AGEAdABlAGwAZQBzAHMALgBi

# AGUCCQCZK95iXUwZFDAJBgUrDgMCGgUAoHgwGAYKKwYBBAGCNwIBDDEKMAigAoAA

# oQKAADAZBgkqhkiG9w0BCQMxDAYKKwYBBAGCNwIBBDAcBgorBgEEAYI3AgELMQ4w

# DAYKKwYBBAGCNwIBFTAjBgkqhkiG9w0BCQQxFgQUHvU46GP/FGGiaTp2Pj9WtSIZ

# zw8wDQYJKoZIhvcNAQEBBQAEggIAcg8yzHgWMdNnWI0XULpSNV+SQzd3rUndlqeK

# 5D5F8H8GXcXqCzV45kRdH11aVhxYoR/U4dFYn+QH2KiagPMYwAn4XTqs/e2zbkLD

# MFbMlQuEE0xy3HhA1twb2+Q9KtQKPD78xAD2kqAlqSQZ9VwP3CFU3oYMXkGyQQKR

# 7B6cOPpNrv+/NvPVehmnF65uGq6ZlygYtMD9HKSUZJJJwMPUyby1JZGz/qvqmlHv

# WwuUbvqbGJqHlZ0yK5rcYUWhrT87h5/TdHbmFkCAp5k+oKx77IZhclA4AB5KKq/S

# g3Ck8yX+rTc5On/ErwNvInBmv8j3/lJY0Srknw/XQtphFNhw8cid0KUVcBjysDy9

# D0T3Lk2yx3DtL9gABQHivLuA/h2sqUFDJ7jQ21I82/VvfFdqwh4WgbQwk5RdaZD7

# cLYpfbl97t7JU/5kC72GgrN1vmmCdxOnJ0Pp5JaPjmQBtb72JLZSpO0yHmc7vjPF

# rBZ+UeQ0Aexvb3xC2D1WK8meeVSBJuR332ejJLc2uRfkkipGPDxlqzn/6jcv8+Oy

# JNPV0SEDuNbbOxVb0euc4CTl7RXgXYcQsxkZxPjcwtnRhsZCmtx1hKukXST5Mf0J

# eOEqE+99ANl5+3YCJsxBzQQcEvZpUJmHhewvEWCwAb8xkpDLV2wVwZjbARayik5t

# zbl2hB0=

# SIG # End signature block