Add New assertions in Pester

Author: nohwnd

JakubJares/New assertions in Pester/01_generic-value-assertions.ps1

@@ -0,0 +1,22 @@
+# pipeline syntax
+1 | Should-Be -Expected 1 # pass
+@(1) | Should-Be -Expected 1 # pass
+
+2 | Should-Be -Expected 1
+
+1 | Should-Be -Expected 1, 2
+
+1, 2 | Should-Be -Expected 1
+
+$null | Should-Be 1
+
+# parameter syntax
+Should-Be -Actual 1 -Expected 1 # pass
+
+Should-Be -Actual @(1) -Expected 1
+
+# special cases
+'$null' | Should-Be $null
+'' | Should-Be 'Jakub'
+
+

JakubJares/New assertions in Pester/02_type-specific-value-assertions.ps1

@@ -0,0 +1,29 @@
+# boolean
+$true | Should-BeTrue # pass
+
+1 | Should-BeTrue
+
+"false" | Should-BeTrue
+
+$null | Should-BeTrue
+
+# vs
+# pass
+1 | Should-BeTruthy
+# pass
+1 | Should-Be $true
+
+
+# string
+"abc" | Should-BeString "abc" # pass
+"ABC" | Should-BeString "abc" # pass
+
+"ABC" | Should-BeString "abc" -CaseSensitive
+
+" a b c " | Should-BeString "abc" -IgnoreWhitespace # pass
+" a b c " | Should-BeString "abc" -TrimWhitespace
+
+1 | Should-BeString "abc"
+
+"abc" | Should-BeLikeString "*bc" # pass
+"def" | Should-BeLikeString "*bc"

JakubJares/New assertions in Pester/03_collection-assertions.ps1

@@ -0,0 +1,10 @@
+# pass
+@(1) | Should-BeCollection -Expected @(1) 
+# pass
+1 | Should-BeCollection -Expected @(1)
+
+@(1, 2, 3) | Should-BeCollection @(3, 4, 5)
+
+
+
+

JakubJares/New assertions in Pester/04_combinator-assertions.ps1

@@ -0,0 +1,11 @@
+# pass
+@(1, 2, 3) | Should-All { $_ -gt 0 }
+
+@(1, 2, 3) | Should-All { $_ -lt 2 }
+
+@(1, 2, 3) | Should-All { $_ | Should-BeLessThan 2 }
+
+# pass
+@(1, 2, 3) | Should-Any { $_ | Should-BeLessThan 2 }
+
+@(1, 2, 3) | Should-Any { $_ | Should-BeGreaterThan 4 }

JakubJares/New assertions in Pester/05_equivalency.ps1

@@ -0,0 +1,73 @@
+
+# What is equivalency?
+
+# false, not the same instance
+# even though the shape is the same
+([PSCustomObject]@{ Name = 'Jakub' }) -eq  ([PSCustomObject]@{ Name = 'Jakub' })
+
+# if there was -equivalent operator then
+# true, different instances but same shape
+([PSCustomObject]@{ Name = 'Jakub' }) -equivalent  ([PSCustomObject]@{ Name = 'Jakub' })
+
+
+# DEMO 1 - pass
+$expected = [PSCustomObject] @{
+    Name = "Jakub"
+    Age = 36
+    Languages = "PowerShell", "C#"
+}
+
+$actual = [PSCustomObject] @{
+    Name = "Jakub"
+    Age = 36
+    Languages = "C#", "PowerShell"
+} 
+
+$actual | Should-BeEquivalent $expected
+
+# DEMO 2 - fail
+$expected = [PSCustomObject] @{
+    Name = "Jakub"
+    Age = 36
+    Languages = "PowerShell", "C#", "TypeScript"
+
+    DrinksCoffee = $true
+}
+
+$actual = [PSCustomObject] @{
+    Name = "Jakub"
+    Age = 36
+    Languages = "PowerShell", "C#"
+
+    HasSmallKeyboard = $true
+}
+
+$actual | Should-BeEquivalent $expected
+
+# DEMO 3 - pass, exclude paths not on expected
+$expected = [PSCustomObject] @{
+    Name = "Jakub"
+    Age = 36
+    Languages = @( 
+        [PSCustomObject]@{ Name = "PowerShell" }
+        [PSCustomObject]@{ Name = "C#" }
+    )
+}
+
+$actual = [PSCustomObject] @{
+    Name = "Jakub"
+    Age = 36
+    Languages = @( 
+        [PSCustomObject]@{ Name = "PowerShell"; Paradigm = "Scripting"  <# <-- #> }
+        [PSCustomObject]@{ Name = "C#";  Paradigm = "OOP" <# <-- #> }
+    )
+
+    HasSmallKeyboard = $true  <# <-- #>
+    HasBigDisplay = $true  <# <-- #>
+} 
+    
+Should-BeEquivalent -Actual $actual -Expected $Expected -ExcludePathsNotOnExpected
+
+
+
+

JakubJares/New assertions in Pester/06_time-assertions.ps1

@@ -0,0 +1,6 @@
+(Get-Item "C:\Windows\System32\notepad.exe").CreationTime |
+    Should-BeAfter 1week -Ago
+
+
+{ Start-Sleep -Second 1 } 
+    | Should-BeFasterThan 1s