🚀 [Feature]: Enable skips on SourceCode.PSModule tests (#84)

## Description

- Implements a inline way to skip tests on source code tests.
  - Fixes #73
- Allow to hold completers in the `src/functions/public` folder.
- Improve gathering of info from the source code.

## Type of change

<!-- Use the check-boxes [x] on the options that are relevant. -->

- [ ] 📖 [Docs]
- [ ] 🪲 [Fix]
- [ ] 🩹 [Patch]
- [ ] ⚠️ [Security fix]
- [x] 🚀 [Feature]
- [ ] 🌟 [Breaking change]

## Checklist

<!-- Use the check-boxes [x] on the options that are relevant. -->

- [x] I have performed a self-review of my own code
- [x] I have commented my code, particularly in hard-to-understand areas

Author: MariusStorhaug

scripts/tests/PSModule/SourceCode.Tests.ps1

@@ -1,5 +1,6 @@
 #Requires -Modules @{ModuleName='PSSemVer'; ModuleVersion='1.0'}
-
+#SkipTest:FunctionTest:Difficult to test due to the nature of the function.
+#SkipTest:Verbose:Just want to test that a function can have multiple skips.
 function New-PSModuleTest {
     <#
         .SYNOPSIS
@@ -28,11 +29,10 @@ function New-PSModuleTest {
         [string] $Name
     )
     Write-Debug "Debug message"
+    Write-Verbose "Verbose message" -Verbose
     Write-Output "Hello, $Name!"
 }
 
 New-Alias New-PSModuleTestAlias3 New-PSModuleTest
 New-Alias -Name New-PSModuleTestAlias4 -Value New-PSModuleTest
-
-
 Set-Alias New-PSModuleTestAlias5 New-PSModuleTest

tests/src/functions/public/New-PSModuleTest.ps1

@@ -1,4 +1,5 @@
-function Test-PSModuleTest {
+#SkipTest:Verbose:Just want to test that a function can have multiple skips.
+function Test-PSModuleTest {
     <#
         .SYNOPSIS
         Performs tests on a module.
@@ -15,4 +16,5 @@
         [string] $Name
     )
     Write-Output "Hello, $Name!"
+    Write-Verbose 'Verbose message' -Verbose
 }

tests/src/functions/public/Test-PSModuleTest.ps1

@@ -0,0 +1,8 @@
+Register-ArgumentCompleter -CommandName New-PSModuleTest -ParameterName Name -ScriptBlock {
+    param($commandName, $parameterName, $wordToComplete, $commandAst, $fakeBoundParameters)
+    $null = $commandName, $parameterName, $wordToComplete, $commandAst, $fakeBoundParameters
+
+    'Alice', 'Bob', 'Charlie' | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {
+        [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
+    }
+}

tests/src/functions/public/completers.ps1

@@ -1,5 +1,6 @@
 #Requires -Modules @{ModuleName='PSSemVer'; ModuleVersion='1.0'}
-
+#SkipTest:FunctionTest:Difficult to test due to the nature of the function.
+#SkipTest:Verbose:Just want to test that a function can have multiple skips.
 function New-PSModuleTest {
     <#
         .SYNOPSIS
@@ -27,11 +28,11 @@ function New-PSModuleTest {
         [Parameter(Mandatory)]
         [string] $Name
     )
+    Write-Debug "Debug message"
+    Write-Verbose "Verbose message" -Verbose
     Write-Output "Hello, $Name!"
 }
 
 New-Alias New-PSModuleTestAlias3 New-PSModuleTest
 New-Alias -Name New-PSModuleTestAlias4 -Value New-PSModuleTest
-
-
 Set-Alias New-PSModuleTestAlias5 New-PSModuleTest

tests/srcWithManifest/functions/public/New-PSModuleTest.ps1

@@ -1,4 +1,5 @@
-function Test-PSModuleTest {
+#SkipTest:Verbose:Just want to test that a function can have multiple skips.
+function Test-PSModuleTest {
     <#
         .SYNOPSIS
         Performs tests on a module.
@@ -15,4 +16,5 @@
         [string] $Name
     )
     Write-Output "Hello, $Name!"
+    Write-Verbose 'Verbose message' -Verbose
 }

tests/srcWithManifest/functions/public/Test-PSModuleTest.ps1

@@ -2,9 +2,6 @@
     It 'Function: Get-PSModuleTest' {
         Get-PSModuleTest -Name 'World' | Should -Be 'Hello, World!'
     }
-    It 'Function: New-PSModuleTest' {
-        New-PSModuleTest -Name 'World' | Should -Be 'Hello, World!'
-    }
     It 'Function: Set-PSModuleTest' {
         Set-PSModuleTest -Name 'World' | Should -Be 'Hello, World!'
     }