Add query language for type signatures

.github/workflows/build.yml

@@ -0,0 +1,50 @@
+name: build
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+
+env:
+  DOTNET_CLI_TELEMETRY_OPTOUT: 1
+  POWERSHELL_TELEMETRY_OPTOUT: 1
+  DOTNET_SKIP_FIRST_TIME_EXPERIENCE: 1
+  DOTNET_NOLOGO: true
+
+defaults:
+    run:
+      shell: pwsh
+
+jobs:
+  build:
+    name: Build and Test
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ ubuntu-latest, macos-latest, windows-latest ]
+    steps:
+    - name: Check Version
+      run: $PSVersionTable
+    - uses: actions/checkout@v1
+    - name: Test and Build
+      run: ./build.ps1 -Force
+    - uses: actions/upload-artifact@v1
+      if: matrix.os == 'windows-latest'
+      with:
+        name: ClassExplorer
+        path: ./Release/ClassExplorer
+    - uses: actions/upload-artifact@v1
+      if: matrix.os != 'windows-latest'
+      with:
+        name: ClassExplorer-${{ matrix.os }}
+        path: ./Release/ClassExplorer
+    - name: Upload Test Results
+      if: always()
+      uses: actions/upload-artifact@v2
+      with:
+        name: Unit Test Results (${{ matrix.os }})
+        path: ./TestResults/Pester.xml

.github/workflows/publish.yml

@@ -0,0 +1,32 @@
+name: publish
+on:
+  release:
+      types: [ published ]
+
+env:
+  DOTNET_CLI_TELEMETRY_OPTOUT: 1
+  POWERSHELL_TELEMETRY_OPTOUT: 1
+  DOTNET_SKIP_FIRST_TIME_EXPERIENCE: 1
+  DOTNET_NOLOGO: true
+
+
+defaults:
+    run:
+      shell: pwsh
+
+jobs:
+  build:
+    name: Publish
+    runs-on: windows-latest
+    steps:
+    - uses: actions/checkout@v1
+    - name: Test and Build
+      run: ./build.ps1 -Force -Publish
+      env:
+        GALLERY_API_KEY: ${{ secrets.GALLERY_API_KEY }}
+    - name: Upload Test Results
+      if: always()
+      uses: actions/upload-artifact@v2
+      with:
+        name: Unit Test Results
+        path: ./TestResults/Pester.xml

.vscode/extensions.json

@@ -2,7 +2,7 @@
     // See http://go.microsoft.com/fwlink/?LinkId=827846
     // for the documentation about the extensions.json format
     "recommendations": [
-        "ms-vscode.csharp",
+        "ms-dotnettools.csharp",
         "ms-vscode.powershell"
     ]
 }

.vscode/launch.json

@@ -2,24 +2,35 @@
     "version": "0.2.0",
     "configurations": [
         {
-            "name": ".NET Core Attach",
+            "name": ".NET Attach",
+            "type": "coreclr",
+            "request": "attach",
+            "justMyCode": true,
+        },
+        {
+            "name": ".NET Classic Attach",
             "type": "clr",
             "request": "attach",
-            "processId": "${command:pickProcess}"
+            "justMyCode": true,
+        },
+        {
+            "name": ".NET Attach (!jmc)",
+            "type": "coreclr",
+            "request": "attach",
+            "justMyCode": false,
         },
         {
-            "name": ".NET Core Launch (console)",
+            "name": ".NET Classic Attach (!jmc)",
             "type": "clr",
+            "request": "attach",
+            "justMyCode": false,
+        },
+        {
+            "name": "PowerShell Launch Current File",
+            "type": "PowerShell",
             "request": "launch",
-            "preLaunchTask": "Build",
-            "program": "powershell",
-            "args": [
-                "-NoExit",
-                ". ${workspaceRoot}/debugHarness.ps1"],
-            "cwd": "${workspaceRoot}",
-            "stopAtEntry": false,
-            "console": "externalTerminal"
-        }
+            "script": "${file}",
+            "cwd": "${file}"
+        },
     ]
 }
-

.vscode/tasks.json

@@ -1,83 +1,24 @@
-// Available variables which can be used inside of strings.
-// ${workspaceRoot}: the root folder of the team
-// ${file}: the current opened file
-// ${relativeFile}: the current opened file relative to workspaceRoot
-// ${fileBasename}: the current opened file's basename
-// ${fileDirname}: the current opened file's dirname
-// ${fileExtname}: the current opened file's extension
-// ${cwd}: the current working directory of the spawned process
 {
     // See https://go.microsoft.com/fwlink/?LinkId=733558
     // for the documentation about the tasks.json format
-    "version": "0.1.0",
-    "runner": "terminal",
-
-    // Start PowerShell
-    "windows": {
-        "command": "PowerShell.exe"
-    },
-    "linux": {
-        "command": "/usr/bin/powershell"
-    },
-    "osx": {
-        "command": "/usr/local/bin/powershell"
-    },
-
-    // The command is a shell script
-    "isShellCommand": true,
-
-    // Show the output window always
-    "showOutput": "always",
-
-    "args": [
-        "-NoProfile", "-ExecutionPolicy", "Bypass"
-    ],
-
-    // Associate with test task runner
+    "version": "2.0.0",
     "tasks": [
         {
-            "taskName": "Clean",
-            "suppressTaskName": true,
-            "showOutput": "always",
+            "label": "build",
+            "command": "dotnet",
+            "type": "shell",
             "args": [
-                "Invoke-Build -Task Clean"
-            ]
-        },
-        {
-            "taskName": "Build",
-            "suppressTaskName": true,
-            "isBuildCommand": true,
-            "showOutput": "always",
-            "args": [
-                "Invoke-Build"
-            ]
-        },
-        {
-            "taskName": "Test",
-            "suppressTaskName": true,
-            "isTestCommand": true,
-            "showOutput": "always",
-            "args": [
-                "Invoke-Build -Task Test"
-            ]
-        },
-        {
-            "taskName": "Test With Coverage",
-            "suppressTaskName": true,
-            "isTestCommand": true,
-            "showOutput": "always",
-            "args": [
-                "Invoke-Build -Task Test -GenerateCodeCoverage"
-            ]
-        },
-        {
-            "taskName": "Install",
-            "suppressTaskName": true,
-            "showOutput": "always",
-            "args": [
-                "Invoke-Build -Task Install -Configuration Release"
-            ]
+                "build",
+                // Ask dotnet build to generate full paths for file names.
+                "/property:GenerateFullPaths=true",
+                // Do not generate summary otherwise it leads to duplicate errors in Problems panel
+                "/consoleloggerparameters:NoSummary"
+            ],
+            "group": {
+                "isDefault": true,
+                "kind": "build",
+            },
+            "problemMatcher": "$msCompile"
         }
     ]
 }
-

ClassExplorer.build.ps1

@@ -44,9 +44,9 @@ $script:Discovery = @{
 
 $tools = "$PSScriptRoot\tools"
 $script:GetDotNet = Get-Command $tools\GetDotNet.ps1
-$script:CreateFormatDefinitions = Get-Command $tools\CreateFormatDefinitions.ps1
 $script:AssertModule = Get-Command $tools\AssertRequiredModule.ps1
 $script:GetOpenCover = Get-Command $tools\GetOpenCover.ps1
+$script:GenerateSignatureMarkdown = Get-Command $tools\GenerateSignatureMarkdown.ps1
 
 task AssertDotNet {
     $script:dotnet = & $GetDotNet -Unix:$Discovery.IsUnix
@@ -63,12 +63,15 @@ task AssertOpenCover -If { $GenerateCodeCoverage.IsPresent } {
 }
 
 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
+    & $AssertModule Pester 5.3.0 -Force:$Force.IsPresent
+    & $AssertModule InvokeBuild 5.8.4 -Force:$Force.IsPresent
+    & $AssertModule platyPS 0.14.2 -Force:$Force.IsPresent
+
+    # Cannot import powershell-yaml and platyPS in the same session due to
+    # assembly conflict.
+    & $AssertModule powershell-yaml 0.4.2 -Force:$Force.IsPresent -NoImport
 }
 
-# TODO: Look into replacing this junk with PSDepend
 task AssertDevDependencies -Jobs AssertDotNet, AssertOpenCover, AssertRequiredModules
 
 task Clean {
@@ -82,7 +85,7 @@ task Clean {
     }
 
     $null = New-Item $Folders.Results -ItemType Directory
-    & $dotnet clean
+    & $dotnet clean --verbosity quiet -nologo
 }
 
 task BuildDocs -If { $Discovery.HasDocs } {
@@ -91,29 +94,30 @@ task BuildDocs -If { $Discovery.HasDocs } {
 
     $null = New-Item $releaseDocs -ItemType Directory -Force -ErrorAction SilentlyContinue
     $null = New-ExternalHelp -Path $sourceDocs -OutputPath $releaseDocs
+
+    # Cannot import powershell-yaml and platyPS in the same session due to
+    # assembly conflict.
+    $generateSignatureMarkdownPath = $GenerateSignatureMarkdown.Source
+    Start-Job {
+        & $using:generateSignatureMarkdownPath -AboutHelp $using:releaseDocs\about_Type_Signatures.help.txt
+        & $using:generateSignatureMarkdownPath $using:PSScriptRoot\docs\en-US\about_Type_Signatures.help.md
+    } | Receive-Job -Wait -AutoRemoveJob
 }
 
 task BuildDll {
     if (-not $Discovery.IsUnix) {
-        & $dotnet build --configuration $Configuration --framework net452
+        & $dotnet publish --configuration $Configuration --framework net471 --verbosity quiet -nologo
     }
-    & $dotnet build --configuration $Configuration --framework netcoreapp2.0
-}
-
-task BuildFormat {
-    $xmlFolder = '{0}\xml' -f $Folders.Release
-
-    $null = New-Item $xmlFolder -ItemType Directory
-    & $CreateFormatDefinitions -Destination $xmlFolder
+    & $dotnet publish --configuration $Configuration --framework netcoreapp3.1 --verbosity quiet -nologo
 }
 
 task CopyToRelease  {
     $powershellSource  = '{0}\*' -f $Folders.PowerShell
     $release           = $Folders.Release
     $releaseDesktopBin = "$release\bin\Desktop"
     $releaseCoreBin    = "$release\bin\Core"
-    $sourceDesktopBin  = '{0}\net452\{1}*' -f $Folders.Build, $Settings.Name
-    $sourceCoreBin     = '{0}\netcoreapp2.0\{1}*' -f $Folders.Build, $Settings.Name
+    $sourceDesktopBin  = '{0}\net471\publish\*' -f $Folders.Build
+    $sourceCoreBin     = '{0}\netcoreapp3.1\publish\*' -f $Folders.Build
     Copy-Item -Path $powershellSource -Destination $release -Recurse -Force
 
     if (-not $Discovery.IsUnix) {
@@ -153,12 +157,12 @@ task DoTest -If { $Discovery.HasTests -and $Settings.ShouldTest } {
 
     if ($GenerateCodeCoverage.IsPresent) {
         # 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
+        # & $dotnet clean
+        & $dotnet publish --configuration $Configuration --framework net471 --verbosity quiet -nologo /p:DebugType=Full
 
         $moduleName = $Settings.Name
         $release = '{0}\bin\Desktop\{1}' -f $Folders.Release, $moduleName
-        $coverage = '{0}\net452\{1}' -f $Folders.Build, $moduleName
+        $coverage = '{0}\net471\{1}' -f $Folders.Build, $moduleName
 
         Rename-Item "$release.pdb" -NewName "$moduleName.pdb.tmp"
         Rename-Item "$release.dll" -NewName "$moduleName.dll.tmp"
@@ -208,7 +212,7 @@ task DoPublish {
     Publish-Module -Name $Folders.Release -NuGetApiKey $apiKey -Confirm
 }
 
-task Build -Jobs AssertDevDependencies, Clean, BuildDll, CopyToRelease, BuildDocs, BuildFormat
+task Build -Jobs AssertDevDependencies, Clean, BuildDll, CopyToRelease, BuildDocs
 
 task Test -Jobs Build, DoTest
 
@@ -219,4 +223,3 @@ task Install -Jobs PreRelease, DoInstall
 task Publish -Jobs PreRelease, DoPublish
 
 task . Build
-