tests

Author: Pxtl

src/UrlQueryStringParser/Tests/ConvertFrom-UrlQueryString.tests.ps1

@@ -0,0 +1,68 @@
+Import-Module $PSScriptRoot\.. -Force
+
+Describe 'ConvertFrom-UrlQueryString functionality' -Tags Unit {
+    InModuleScope UrlQueryStringParser {
+        BeforeAll {
+            $complexExampleQueryString = "?foo=bar&oogy&array=one&baz=quux&array=two&boogy&array=three&empty=&array=four&last"
+        }
+
+        It 'Parses simple query string correctly' {
+            $qs = '?a=1&b=two&c=3'
+            $result = ConvertFrom-UrlQueryString -QueryString $qs
+
+            $result.Count | Should -Be 3
+            $result['a'] | Should -Be '1'
+            $result['b'] | Should -Be 'two'
+            $result['c'] | Should -Be '3'
+        }
+
+        It 'Handles URL encoded values and repeated keys' {
+            $qs = 'name=John%20Doe&age=30&name=Jane'
+            $result = ConvertFrom-UrlQueryString -QueryString $qs
+
+            $result['name'].Count | Should -Be 2
+            $result['name'] | Should -Contain 'John Doe'
+            $result['name'] | Should -Contain 'Jane'
+            $result['age'] | Should -Be '30'
+        }
+
+        It 'Returns zero-count hashtable for empty string' {
+            (ConvertFrom-UrlQueryString "").Keys.Count | Should -Be 0
+        }
+
+        It 'Converts from pseudo-empty querystring (just "?") to empty dict' {
+            (ConvertFrom-UrlQueryString "?").Keys.Count | Should -Be 0
+        }
+
+        It 'Converts from from simple single-entry querystring to single-entry dict' {
+            (ConvertFrom-UrlQueryString "foo=bar")["foo"] | Should -Be "bar"
+        }
+
+        It 'Converts from from simple single-entry querystring with ? prefix to single-entry dict' {
+            (ConvertFrom-UrlQueryString "?foo=bar")["foo"] | Should -Be "bar"
+        }
+
+        It 'Converts valueless entries with no = to $true' {
+            (ConvertFrom-UrlQueryString "foo")["foo"] | Should -Be $true
+        }
+
+        It 'Converts valueless entries with = by dropping them' {
+            (ConvertFrom-UrlQueryString "foo=")["foo"].Length | Should -Be 0
+        }
+        
+        It 'Converts a complex example querystring while preserving the order of the keys' {
+            $result = ConvertFrom-UrlQueryString $complexExampleQueryString
+            $result.Keys -join "," | Should -Be "foo,oogy,array,baz,boogy,empty,last"
+        }
+
+        It 'Converts repeated keys into arrays while preserving value-order' {
+            $result = ConvertFrom-UrlQueryString $complexExampleQueryString
+            $result['array'] -join "," | Should -Be "one,two,three,four"
+        }
+
+        It 'Returns a case-insensitive dict' {
+            $result = ConvertFrom-UrlQueryString $complexExampleQueryString
+            { $result['ArRaY'] } | Should -Not -Throw
+        }
+    }
+}

src/UrlQueryStringParser/Tests/ConvertTo-UrlQueryString.tests.ps1

@@ -0,0 +1,77 @@
+Import-Module $PSScriptRoot\.. -Force
+
+Describe 'ConvertFrom-UrlQueryString functionality' -Tags Unit {
+    InModuleScope UrlQueryStringParser {
+        It 'Converts a complex example dict correctly' {
+            $exampleOrderedDict = [ordered] @{
+                foo="bar"
+                oogy=$true
+                array='one','two','three','four'
+                baz="quux"
+                boogy=$true
+                empty=''
+                donotshow=$false
+                last=$true
+            }
+
+            ConvertTo-UrlQueryString $exampleOrderedDict | 
+                Should -Be "?foo=bar&oogy&array=one&array=two&array=three&array=four&baz=quux&boogy&empty=&last"
+        }
+
+        It 'Converts properly with empty ContinuationOfString' {
+            ConvertTo-UrlQueryString @{foo=$true} -ContinuationOfString '' |
+                Should -Be '?foo' 
+        }
+
+        It 'Converts properly with non-empty ContinuationOfString' {
+            ConvertTo-UrlQueryString @{foo=$true} -ContinuationOfString '?bar=baz'|
+                Should -Be '?bar=baz&foo'
+        }
+        
+        It 'Converts an empty dict with non-empty -ContinuationOfString to just be -ContinuationOfString.' {
+            ConvertTo-UrlQueryString @{} -ContinuationOfString '?bar=baz' |
+                Should -Be "?bar=baz"
+        }
+
+        It 'Converts empty dict to empty UrlQueryString' {
+            ConvertTo-UrlQueryString @{} |
+                Should -Be ""
+        }
+
+        It 'Converts dict with $null values to empty UrlQueryString' {
+            ConvertTo-UrlQueryString @{foo=$null;bar=$null} |
+                Should -Be ""
+        }
+
+        It 'Skips encoding spaces when -DoMinimalEncode is set' {
+            ConvertTo-UrlQueryString  @{foo='bar baz quux'} -DoMinimalEncode |
+                Should -Be "?foo=bar baz quux"
+        }
+
+        It 'Encodes $ in keys' {
+            ConvertTo-UrlQueryString  @{'$foo'='bar'} |
+                Should -Be "?%24foo=bar"
+        }
+
+        It 'Skips encoding $ in keys when -DoMinimalEncode is set.' {
+            ConvertTo-UrlQueryString  @{'$foo'='bar'} -DoMinimalEncode |
+                Should -Be "?`$foo=bar"
+        }
+
+        It 'Encodes other various characters correctly when -DoMinimalEncode is set.' {
+            ConvertTo-UrlQueryString ([ordered]@{
+                allow = 'example equals= colon: at@ slash/ brackets[[] dollar$ comma, semicolon; question? parens()) star* exclaim! space space'
+                disallow = "example hash# ampersand& percent% plus+ tab`t linebreak`r`n "
+            }) -DoMinimalEncode |
+                Should -Be (
+                    '?allow=example equals= colon: at@ slash/ brackets[[] dollar$ comma, semicolon; question? parens()) star* exclaim! space space' + 
+                    '&disallow=example hash%23 ampersand%26 percent%25 plus%2B tab%09 linebreak%0D%0A '
+                )
+        }
+
+        It 'Encodes spaces correctly when -DoMinimalEncode is not set.' {
+            ConvertTo-UrlQueryString  @{foo='bar baz quux'} |
+                Should -Be "?foo=bar%20baz%20quux"
+        }
+    }
+}

src/UrlQueryStringParser/UrlQueryStringParser.psm1

@@ -95,7 +95,7 @@ function ConvertFrom-UrlQueryString {
                 $QueryString = $QueryString.Substring(1, $QueryString.Length - 1)
             }
             $queryEntries = $QueryString -split "&"
-            foreach($entry in $queryEntries) {
+            foreach ($entry in $queryEntries) {
                 if ($entry -like '*=*') {
                     $equalsCharIndex = $entry.IndexOf("=")
                     $field = $entry.Substring(0, $equalsCharIndex)