Re-structured and formalized the scripts and modules.

2026-01-01 16:59:35 +01:00 · 2024-04-25 13:39:01 -07:00
parent 683c087537
commit b9b68ba1a6
8 changed files with 440 additions and 103 deletions
--- a/Scripts/Terminal.Gui.PowerShell.Analyzers.psm1
+++ b/Scripts/Terminal.Gui.PowerShell.Analyzers.psm1
@@ -0,0 +1,105 @@
+<#
+  .SYNOPSIS
+  Builds all analyzer projects in Debug and Release configurations.
+  .DESCRIPTION
+  Uses dotnet build to build all analyzer projects, with optional behavior changes via switch parameters.
+  .PARAMETER AutoClose
+  Automatically close running Visual Studio processes which have the Terminal.sln solution loaded, before taking any other actions.
+  .PARAMETER AutoLaunch
+  Automatically start a new Visual Studio process and load the solution after completion.
+  .PARAMETER Force
+  Carry out operations unconditionally and do not prompt for confirmation.
+  .PARAMETER NoClean
+  Do not delete the bin and obj folders before building the analyzers. Usually best not to use this, but can speed up the builds slightly.
+  .PARAMETER Quiet
+  Write less text output to the terminal.
+  .INPUTS
+  None
+  .OUTPUTS
+  None
+#>
+Function Build-Analyzers {
+  [CmdletBinding()]
+  param(
+    [Parameter(Mandatory=$false, HelpMessage="Automatically close running Visual Studio processes which have the Terminal.sln solution loaded, before taking any other actions.")]
+    [switch]$AutoClose,
+    [Parameter(Mandatory=$false, HelpMessage="Automatically start a new Visual Studio process and load the solution after completion.")]
+    [switch]$AutoLaunch,
+    [Parameter(Mandatory=$false, HelpMessage="Carry out operations unconditionally and do not prompt for confirmation.")]
+    [switch]$Force,
+    [Parameter(Mandatory=$false, HelpMessage="Do not delete the bin and obj folders before building the analyzers.")]
+    [switch]$NoClean,
+    [Parameter(Mandatory=$false, HelpMessage="Write less text output to the terminal.")]
+    [switch]$Quiet
+  )
+  
+  if($AutoClose) {
+    if(!$Quiet) {
+      Write-Host Closing Visual Studio processes
+    }
+    Close-Solution
+  }
+
+  if($Force){
+    $response = 'Y'
+  }
+  elseif(!$Force && $NoClean){
+    $response = ($r = Read-Host "Pre-build Terminal.Gui.InternalAnalyzers without removing old build artifacts? [Y/n]") ? $r : 'Y'
+  }
+  else{
+    $response = ($r = Read-Host "Delete bin and obj folders for Terminal.Gui and Terminal.Gui.InternalAnalyzers and pre-build Terminal.Gui.InternalAnalyzers? [Y/n]") ? $r : 'Y'
+  }
+
+  if (($response -ne 'Y')) {
+    Write-Host Took no action
+    return
+  }
+  
+  New-Variable -Name solutionRoot -Visibility Public -Value (Resolve-Path ..)
+  Push-Location $solutionRoot
+  New-Variable -Name solutionFile -Visibility Public -Value (Resolve-Path ./Terminal.sln)
+  $mainProjectRoot = Resolve-Path ./Terminal.Gui
+  $mainProjectFile = Join-Path $mainProjectRoot Terminal.Gui.csproj
+  $analyzersRoot = Resolve-Path ./Analyzers
+  $internalAnalyzersProjectRoot = Join-Path $analyzersRoot Terminal.Gui.Analyzers.Internal
+  $internalAnalyzersProjectFile = Join-Path $internalAnalyzersProjectRoot Terminal.Gui.Analyzers.Internal.csproj
+  
+  if(!$NoClean) {
+    if(!$Quiet) {
+      Write-Host Deleting bin and obj folders for Terminal.Gui
+    }
+    if(Test-Path $mainProjectRoot/bin) {
+      Remove-Item -Recurse -Force $mainProjectRoot/bin
+      Remove-Item -Recurse -Force $mainProjectRoot/obj
+    }
+
+    if(!$Quiet) {
+      Write-Host Deleting bin and obj folders for Terminal.Gui.InternalAnalyzers
+    }
+    if(Test-Path $internalAnalyzersProjectRoot/bin) {
+      Remove-Item -Recurse -Force $internalAnalyzersProjectRoot/bin
+      Remove-Item -Recurse -Force $internalAnalyzersProjectRoot/obj
+    }
+  }
+  
+  if(!$Quiet) {
+    Write-Host Building analyzers in Debug configuration
+  }
+  dotnet build $internalAnalyzersProjectFile --no-incremental --nologo --force --configuration Debug
+
+  if(!$Quiet) {
+    Write-Host Building analyzers in Release configuration
+  }
+  dotnet build $internalAnalyzersProjectFile --no-incremental --nologo --force --configuration Release
+
+  if(!$AutoLaunch) {
+    Write-Host -ForegroundColor Green Finished. Restart Visual Studio for changes to take effect.
+  } else {
+    if(!$Quiet) {
+      Write-Host -ForegroundColor Green Finished. Re-loading Terminal.sln.
+    }
+    Open-Solution
+  }
+
+  return
+}