Release 1.1.0 (#6)

* Add Find-Namespace cmdlet

- Add Find-Namespace cmdlet for discovering namespaces and making it
  easier to filter by namespace.

- Add argument completion for namespaces and namespace names

- Add Not parameter to Find-* cmdlets to negate matches.

- Fix an issue where the Find-* cmdlets would return all matches in
  the AppDomain when passed null pipeline input.

* Add namespace input support Find-*

- Add support for NamespaceInfo objects as pipeline input for the other
  Find-* cmdlets

- Fix Not parameter support Find-* cmdlets

- Fix ExpectingInput support for Find-* cmdlets

- Add argument completion for the Find-Type parameter "Namespace"

* Add assembly name argument completion

* Update help to reflect parameter changes

* Refactor build process

- Update development dependencies

- Update microsoft/powershell docker container for CircleCI

- Add a standalone build.ps1 that should be invokable with no installed
  development dependencies

- Add release folder to AppVeyor artifacts

* Refactor tests

- Replace custom assertion functions with custom assertion operators

- Add tests for new argument completers, Find-Namespace, and new parameters

* Fix AppVeyor error

* Update release notes

Author: SeeminglyScience

.circleci/config.yml

@@ -3,12 +3,12 @@ jobs:
     build:
         working_directory: ~/classexplorer
         docker:
-            - image: microsoft/powershell@sha256:6d36c498c1fdbb3ef42acabea1d06b12870e390fd3053993974ebaa6ba507849
+            - image: microsoft/powershell@sha256:c0bd0f7ad40bcc76130cb5e772515546e3d200f8a416a273b2605a942d9775f5
         steps:
             - checkout
             - run:
                 name: Run build script
-                command: 'powershell -File ./tools/InvokeCircleCI.ps1'
+                command: 'pwsh -File ./tools/InvokeCircleCI.ps1'
             - store_artifacts:
                 path: ./testresults/pester.xml
                 prefix: tests

ClassExplorer.build.ps1

@@ -1,19 +1,23 @@
-#requires -Module InvokeBuild, Pester, PlatyPS -Version 5.1
+#requires -Version 5.1
 
 [CmdletBinding()]
 param(
     [ValidateSet('Debug', 'Release')]
-    [string]
-    $Configuration = 'Debug',
+    [string] $Configuration = 'Debug',
 
-    [switch]
-    $GenerateCodeCoverage
+    [switch] $GenerateCodeCoverage,
+
+    [switch] $Force
 )
 
 $moduleName = 'ClassExplorer'
-$manifest   = Test-ModuleManifest -Path          $PSScriptRoot\module\$moduleName.psd1 `
-                                  -ErrorAction   Ignore `
-                                  -WarningAction Ignore
+$testModuleManifestSplat = @{
+    ErrorAction   = 'Ignore'
+    WarningAction = 'Ignore'
+    Path          = "$PSScriptRoot\module\$moduleName.psd1"
+}
+
+$manifest = Test-ModuleManifest @testModuleManifestSplat
 
 $script:Settings = @{
     Name          = $moduleName
@@ -39,13 +43,33 @@ $script:Discovery = @{
 }
 
 $tools = "$PSScriptRoot\tools"
+$script:GetDotNet = Get-Command $tools\GetDotNet.ps1
 $script:CreateFormatDefinitions = Get-Command $tools\CreateFormatDefinitions.ps1
-$script:dotnet = & $tools\GetDotNet.ps1 -Unix:$Discovery.IsUnix
+$script:AssertModule = Get-Command $tools\AssertRequiredModule.ps1
+$script:GetOpenCover = Get-Command $tools\GetOpenCover.ps1
 
-if ($GenerateCodeCoverage.IsPresent) {
-    $script:openCover = & $tools\GetOpenCover.ps1
+task AssertDotNet {
+    $script:dotnet = & $GetDotNet -Unix:$Discovery.IsUnix
 }
 
+task AssertOpenCover -If { $GenerateCodeCoverage.IsPresent } {
+    if ($Discovery.IsUnix) {
+        Write-Warning 'Generating code coverage from .NET core is currently unsupported, disabling code coverage generation.'
+        $script:GenerateCodeCoverage = $false
+        return
+    }
+
+    $script:openCover = & $GetOpenCover
+}
+
+task AssertRequiredModules {
+    & $AssertModule Pester 4.1.1 -Force:$Force.IsPresent
+    & $AssertModule InvokeBuild 5.0.0 -Force:$Force.IsPresent
+    & $AssertModule platyPS 0.9.0 -Force:$Force.IsPresent
+}
+
+# TODO: Look into replacing this junk with PSDepend
+task AssertDevDependencies -Jobs AssertDotNet, AssertOpenCover, AssertRequiredModules
 
 task Clean {
     if ($PSScriptRoot -and (Test-Path $PSScriptRoot\Release)) {
@@ -66,9 +90,6 @@ task BuildDocs -If { $Discovery.HasDocs } {
     $releaseDocs = '{0}\{1}' -f $Folders.Release, $PSCulture
 
     $null = New-Item $releaseDocs -ItemType Directory -Force -ErrorAction SilentlyContinue
-    if ($Discovery.IsUnix) {
-        Write-Host -ForegroundColor Green 'The mkdir errors below are fine, they''re due to a alias in platyPS'
-    }
     $null = New-ExternalHelp -Path $sourceDocs -OutputPath $releaseDocs
 }
 
@@ -123,12 +144,14 @@ task DoTest -If { $Discovery.HasTests -and $Settings.ShouldTest } {
             [System.Text.Encoding]::Unicode.GetBytes(
                 $scriptString))
 
-    $powershell = (Get-Command powershell).Source
+    $powershellCommand = 'powershell'
+    if ($Discovery.IsUnix) {
+        $powershellCommand = 'pwsh'
+    }
+
+    $powershell = (Get-Command $powershellCommand).Source
 
     if ($GenerateCodeCoverage.IsPresent) {
-        if ($Discovery.IsUnix) {
-            throw 'Generating code coverage from .NET core is currently unsupported.'
-        }
         # OpenCover needs full pdb's. I'm very open to suggestions for streamlining this...
         & $dotnet clean
         & $dotnet build --configuration $Configuration --framework net452 /p:DebugType=Full
@@ -185,7 +208,7 @@ task DoPublish {
     Publish-Module -Name $Folders.Release -NuGetApiKey $apiKey -Confirm
 }
 
-task Build -Jobs Clean, BuildDll, CopyToRelease, BuildDocs, BuildFormat
+task Build -Jobs AssertDevDependencies, Clean, BuildDll, CopyToRelease, BuildDocs, BuildFormat
 
 task Test -Jobs Build, DoTest
 

appveyor.yml

@@ -7,16 +7,16 @@ install:
 - ps: >-
     Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force
 
-    Install-Module Pester -RequiredVersion 4.0.6 -Scope CurrentUser -Force -SkipPublisherCheck
+    Install-Module Pester -RequiredVersion 4.1.1 -Scope CurrentUser -Force -SkipPublisherCheck
 
-    Install-Module InvokeBuild -RequiredVersion 3.2.1 -Scope CurrentUser -Force
+    Install-Module InvokeBuild -RequiredVersion 5.0.0 -Scope CurrentUser -Force
 
-    Install-Module platyPS -RequiredVersion 0.8.1 -Scope CurrentUser -Force
+    Install-Module platyPS -RequiredVersion 0.9.0 -Scope CurrentUser -Force
 
     choco install codecov --no-progress
 build_script:
 - ps: >-
-    Invoke-Build -Task Prerelease -Configuration Release -GenerateCodeCoverage
+    . "$PWD\build.ps1" -Force
 
     $resultsFile = "$PWD\testresults\pester.xml"
 
@@ -30,3 +30,12 @@ build_script:
         $Error | Format-List * -Force
         exit 1;
     }
+on_finish:
+- ps: >-
+    Add-Type -AssemblyName System.IO.Compression.FileSystem
+
+    $zipPath = "$pwd\ClassExplorer.zip"
+
+    [System.IO.Compression.ZipFile]::CreateFromDirectory("$pwd\Release", $zipPath)
+
+    Push-AppveyorArtifact $zipPath

build.ps1

@@ -0,0 +1,16 @@
+[CmdletBinding()]
+param(
+    [switch] $Force
+)
+end {
+    & "$PSScriptRoot\tools\AssertRequiredModule.ps1" InvokeBuild 5.0.0 -Force:$Force.IsPresent
+    $invokeBuildSplat = @{
+        Task = 'PreRelease'
+        File = "$PSScriptRoot/ClassExplorer.build.ps1"
+        GenerateCodeCoverage = $true
+        Force = $Force.IsPresent
+        Configuration = 'Release'
+    }
+
+    Invoke-Build @invokeBuildSplat
+}

docs/en-US/ClassExplorer.md

@@ -18,6 +18,10 @@ ClassExplorer is a PowerShell module that enables quickly searching the AppDomai
 
 The Find-Member cmdlet searches the AppDomain for members that fit specified criteria. You can search the entire AppDomain, search in specific types, or filter an existing list of members.
 
+### [Find-Namespace](Find-Namespace.md)
+
+The Find-Namespace cmdlet searches the AppDomain for namespaces that fit a specific criteria. You can search the entire AppDomain, specific assemblies, or get the namespace of specific types or members.
+
 ### [Find-Type](Find-Type.md)
 
 The Find-Type cmdlet searches the AppDomain for .NET classes that match specified criteria.

docs/en-US/Find-Member.md

@@ -119,7 +119,6 @@ Find-Member Parse* -ParameterType System.Management.Automation.Language.Token
 Find all members that start with the word Parse and take Token as a parameter. This example also
 demonstrates how this will even match the element of a type that is both an array and ByRef type.
 
-
 ### -------------------------- EXAMPLE 5 --------------------------
 
 ```powershell
@@ -281,6 +280,22 @@ Accept pipeline input: False
 Accept wildcard characters: True
 ```
 
+### -Not
+
+Specifies that this cmdlet should only return object that do not match the criteria.
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -ParameterType
 
 Specifies a type that a member must accept as a parameter to be matched. This parameter will also match base types, implemented interfaces, and the element type of array, byref, pointer and generic types.
@@ -363,11 +378,13 @@ Accept wildcard characters: False
 
 ## INPUTS
 
-### Type, MemberInfo, PSObject
+### ClassExplorer.NamespaceInfo, System.Type, System.Reflection.MemberInfo, PSObject
+
+If you pass NamespaceInfo objects to this cmdlet it will match members from types declared in that namespace.
 
 If you pass Type objects to this cmdlet it will match members from that type.
 
-If you pass MemberInfo objects to this cmdlet it will filter them.
+If you pass MemberInfo objects as input this cmdlet will return the input if it matches the specified criteria.  You can use this to chain Find-Member commands to filter output.
 
 If you pass any other type to this cmdlet it will match members from that object's type.
 
@@ -382,5 +399,6 @@ Matched MemberInfo objects will be returned to the pipeline.
 ## RELATED LINKS
 
 [Find-Type](Find-Type.md)
+[Find-Namespace](Find-Namespace.md)
 [Get-Assembly](Get-Assembly.md)
 [Get-Parameter](Get-Parameter.md)