Merge pull request 138 from dev/183-test-path-pester into develop

src/pester-tests/Test-Test-Path.Tests.ps1

@@ -0,0 +1,114 @@
+Describe "Test-Test-Path" {
+    $testdirectory = "/usr/bin"
+    $testfilename  = "vi" # use /usr/bin/vi since that's bundled with all linux
+    $testfile      = $testdirectory + "/" + $testfilename
+    It "Should be called on an existing path without error" {
+        { Test-Path $testdirectory }              | Should Not Throw
+        { Test-Path -Path $testdirectory }        | Should Not Throw
+        { Test-Path -LiteralPath $testdirectory } | Should Not Throw
+    }
+
+    It "Should allow piping objects to it" {
+        { $testdirectory | Test-Path  } | Should Not Throw
+
+        $testdirectory                  | Test-Path | Should Be $true
+        "/usr/bin/totallyFakeDirectory" | Test-Path | Should Be $false
+    }
+
+    It "Should return a boolean data type" {
+        { Test-Path -Path $testdirectory } | Should Be $true
+    }
+
+    It "Should be called on a nonexistant path without error" {
+        { Test-Path -Path "aNonexistant/path/that/should/error" } | Should Not Throw
+    }
+
+    It "Should return false for a nonexistant path" {
+        Test-Path -Path "aNonexistant/path/that/should/error" | Should Be $false
+    }
+
+    It "Should return true for an existing path" {
+        Test-Path -Path $testdirectory | Should Be $true
+    }
+
+    It "Should be able to accept a regular expression" {
+        { Test-Path -Path "/u*" }      | Should Not Throw
+        { Test-Path -Path "/u[a-z]r" } | Should Not Throw
+    }
+
+    It "Should be able to return the correct result when a regular expression is used" {
+        Test-Path -Path "/u*"      | Should Be $true
+        Test-Path -Path "/u[a-z]*" | Should Be $true
+
+        Test-Path -Path "/aoeu*"  | Should Be $false
+        Test-Path -Path "/u[A-Z]" | Should Be $false
+    }
+
+    It "Should return false when the Leaf pathtype is used on a directory" {
+        Test-Path -Path $testdirectory -PathType Leaf | Should Be $false
+    }
+
+    It "Should return true when the Leaf pathtype is used on an existing endpoint" {
+        Test-Path -Path $testfile -PathType Leaf | Should Be $true
+    }
+
+    It "Should return false when the Leaf pathtype is used on a nonexistant file" {
+        Test-Path -Path "aoeu" -PathType Leaf | Should Be $false
+    }
+
+    It "Should return true when the Leaf pathtype is used on a file using the Type alias instead of PathType" {
+        Test-Path -Path $testfile -Type Leaf | Should Be $true
+    }
+
+    It "Should be able to search multiple regular expressions using the include switch" {
+        Test-Path -Path "/usr/bin/*" -Include vi* | Should Be $true
+    }
+
+    It "Should be able to exclude a regular expression using the exclude switch" {
+        Test-Path -Path "/usr/bin/" -Exclude vi* | Should Be $true
+    }
+
+    It "Should be able to exclude multiple regular expressions using the exclude switch" {
+        # tests whether there's any files in the /usr directory that don't start with 'd' or 'g'
+        Test-Path -Path "/usr" -Exclude d*, g* | Should Be $true
+    }
+
+    It "Should return true if the syntax of the path is correct when using the IsValid switch" {
+        Test-Path -Path /this/is/a/valid/path -IsValid | Should Be $true
+    }
+
+    It "Should return false if the syntax of the path is incorrect when using the IsValid switch" {
+        Test-Path -Path C:/usr/bin -IsValid | Should Be $false
+    }
+
+    It "Should return true on paths containing spaces when the path is surrounded in quotes" {
+        Test-Path -Path "/totally a valid/path" -IsValid | Should Be $true
+    }
+
+    It "Should throw on paths containing spaces when the path is not surrounded in quotes" {
+        { Test-Path -Path /a path/without quotes/around/it -IsValid } | Should Throw
+    }
+
+    It "Should return true if a directory leads or trails with a space when surrounded by quotes" {
+        Test-Path -Path "/a path / with/funkyspaces" -IsValid | Should Be $true
+    }
+
+    It "Should return true on a valid path when the LiteralPath switch is used" {
+        Test-Path -LiteralPath "/usr/bin" | Should Be $true
+    }
+
+    It "Should return false if regular expressions are used with the LiteralPath switch" {
+        Test-Path -LiteralPath /*sr/bin | Should Be $false
+        Test-Path -LiteralPath /[usth]sr/bin | Should Be $false
+    }
+
+    It "Should return false if regular expressions are used with the LiteralPath alias PSPath switch" {
+        Test-Path -PSPath /*sr/bin | Should Be $false
+        Test-Path -PSPath /[aoeu]sr/bin | Should Be $false
+    }
+
+    It "Should return true if used on components other than filesystem objects" {
+        Test-Path Alias:\gci    | Should Be $true
+        Test-Path Env:\HOSTNAME | Should Be $true
+    }
+}