LMBQ-178: Fixing test-dotnet path resolution, adding the ability to pass environment variables and repository details to build workflows

.github/actions/add-azure-application-insights-release-annotation/action.yml

@@ -20,7 +20,7 @@ runs:
     - name: Setup Scripts
       shell: pwsh
       run: |
-        "${{ github.action_path }}" >> $Env:GITHUB_PATH
+        '${{ github.action_path }}' >> $Env:GITHUB_PATH
 
     - name: Add Azure Application Insights Release Annotation
       shell: pwsh

.github/actions/auto-merge-pull-request/action.yml

@@ -17,7 +17,7 @@ runs:
     - name: Setup Scripts
       shell: pwsh
       run: |
-        (Resolve-Path "${{ github.action_path }}/../../../Scripts").Path >> $Env:GITHUB_PATH
+        (Resolve-Path '${{ github.action_path }}/../../../Scripts').Path >> $Env:GITHUB_PATH
 
     - name: Check Mergeability
       id: check-mergeability

.github/actions/auto-transition-jira-issue/action.yml

@@ -10,8 +10,8 @@ runs:
     - name: Setup Scripts
       shell: pwsh
       run: |
-        "${{ github.action_path }}" >> $Env:GITHUB_PATH
-        (Resolve-Path "${{ github.action_path }}/../../../Scripts").Path >> $Env:GITHUB_PATH
+        '${{ github.action_path }}' >> $Env:GITHUB_PATH
+        (Resolve-Path '${{ github.action_path }}/../../../Scripts').Path >> $Env:GITHUB_PATH
 
     - name: Check if Should Done
       id: check-done

.github/actions/build-dotnet/action.yml

@@ -91,8 +91,8 @@ runs:
     - name: Setup Scripts
       shell: pwsh
       run: |
-        "${{ github.action_path }}" >> $Env:GITHUB_PATH
-        (Resolve-Path "${{ github.action_path }}/../../../Scripts").Path >> $Env:GITHUB_PATH
+        '${{ github.action_path }}' >> $Env:GITHUB_PATH
+        (Resolve-Path '${{ github.action_path }}/../../../Scripts').Path >> $Env:GITHUB_PATH
 
     - name: Setup & Detect Cache Configuration
       id: detect-cache-configuration

.github/actions/cancel-workflow/action.yml

@@ -15,7 +15,7 @@ runs:
     - name: Setup Scripts
       shell: pwsh
       run: |
-        (Resolve-Path "${{ github.action_path }}/../../../Scripts").Path >> $Env:GITHUB_PATH
+        (Resolve-Path '${{ github.action_path }}/../../../Scripts').Path >> $Env:GITHUB_PATH
 
     - name: Cancel Workflow
       # Fork PRs won't have a token with write access to Actions, thus won't be able to cancel the workflow.

.github/actions/check-current-workflow-is-latest/action.yml

@@ -20,7 +20,7 @@ runs:
     - name: Setup Scripts
       shell: pwsh
       run: |
-        (Resolve-Path "${{ github.action_path }}/../../../Scripts").Path >> $Env:GITHUB_PATH
+        (Resolve-Path '${{ github.action_path }}/../../../Scripts').Path >> $Env:GITHUB_PATH
 
     - name: Check Current Workflow Equals Latest
       shell: pwsh

.github/actions/check-merge-queue-adds/action.yml

@@ -15,8 +15,8 @@ runs:
     - name: Setup Scripts
       shell: pwsh
       run: |
-        "${{ github.action_path }}" >> $Env:GITHUB_PATH
-        (Resolve-Path "${{ github.action_path }}/../../../Scripts").Path >> $Env:GITHUB_PATH
+        '${{ github.action_path }}' >> $Env:GITHUB_PATH
+        (Resolve-Path '${{ github.action_path }}/../../../Scripts').Path >> $Env:GITHUB_PATH
 
     - name: Check Merge Queue Adds
       id: check-merge-queue-adds

.github/actions/check-pull-request-labels/action.yml

@@ -23,8 +23,8 @@ runs:
     - name: Setup Scripts
       shell: pwsh
       run: |
-        "${{ github.action_path }}" >> $Env:GITHUB_PATH
-        (Resolve-Path "${{ github.action_path }}/../../../Scripts").Path >> $Env:GITHUB_PATH
+        '${{ github.action_path }}' >> $Env:GITHUB_PATH
+        (Resolve-Path '${{ github.action_path }}/../../../Scripts').Path >> $Env:GITHUB_PATH
 
     - name: Check Labels
       id: check-labels

.github/actions/check-pull-request-reviews/action.yml

@@ -14,8 +14,8 @@ runs:
     - name: Setup Scripts
       shell: pwsh
       run: |
-        "${{ github.action_path }}" >> $Env:GITHUB_PATH
-        (Resolve-Path "${{ github.action_path }}/../../../Scripts").Path >> $Env:GITHUB_PATH
+        '${{ github.action_path }}' >> $Env:GITHUB_PATH
+        (Resolve-Path '${{ github.action_path }}/../../../Scripts').Path >> $Env:GITHUB_PATH
 
     - name: Check Reviews
       id: check-reviews

.github/actions/checkout/action.yml

@@ -29,7 +29,7 @@ runs:
     - name: Setup Scripts
       shell: pwsh
       run: |
-        (Resolve-Path "${{ github.action_path }}/../../../Scripts").Path >> $Env:GITHUB_PATH
+        (Resolve-Path '${{ github.action_path }}/../../../Scripts').Path >> $Env:GITHUB_PATH
 
     - name: Set Checkout Token
       uses: Lombiq/GitHub-Actions/.github/actions/set-checkout-token@dev

.github/actions/create-jira-issues-for-community-activities/action.yml

@@ -21,8 +21,8 @@ runs:
     - name: Setup Scripts
       shell: pwsh
       run: |
-        "${{ github.action_path }}" >> $Env:GITHUB_PATH
-        (Resolve-Path "${{ github.action_path }}/../../../Scripts").Path >> $Env:GITHUB_PATH
+        '${{ github.action_path }}' >> $Env:GITHUB_PATH
+        (Resolve-Path '${{ github.action_path }}/../../../Scripts').Path >> $Env:GITHUB_PATH
 
     # Don't do anything for pull requests that are already related to an issue, i.e. their titles start with an issue
     # key.

.github/actions/get-changed-files-from-git-diff/action.yml

@@ -28,7 +28,7 @@ runs:
     - name: Setup
       shell: pwsh
       run: |
-        "${{ github.action_path }}" >> $Env:GITHUB_PATH
+        '${{ github.action_path }}' >> $Env:GITHUB_PATH
 
     - name: Git Diff
       id: git-diff

.github/actions/get-changed-gha-items/action.yml

@@ -19,7 +19,7 @@ runs:
     - name: Setup
       shell: pwsh
       run: |
-        "${{ github.action_path }}" >> $Env:GITHUB_PATH
+        '${{ github.action_path }}' >> $Env:GITHUB_PATH
 
     - name: Get GHA Items
       id: get-gha-items

.github/actions/install-dotnet-tool/action.yml

@@ -15,7 +15,7 @@ runs:
     - name: Setup Scripts
       shell: pwsh
       run: |
-        (Resolve-Path "${{ github.action_path }}/../../../Scripts").Path >> $Env:GITHUB_PATH
+        (Resolve-Path '${{ github.action_path }}/../../../Scripts').Path >> $Env:GITHUB_PATH
     - name: Install tool
       shell: pwsh
       run: |

.github/actions/markdown-lint/action.yml

@@ -38,7 +38,7 @@ runs:
 
     - name: Setup Scripts
       shell: pwsh
-      run: (Resolve-Path "${{ github.action_path }}/../../../Scripts").Path >> $Env:GITHUB_PATH
+      run: (Resolve-Path '${{ github.action_path }}/../../../Scripts').Path >> $Env:GITHUB_PATH
 
     - name: Copy files updated by markdown-lint automatic fixes
       if: inputs.fix == 'true'

.github/actions/msbuild/action.yml

@@ -45,8 +45,8 @@ runs:
     - name: Setup Scripts
       shell: pwsh
       run: |
-        "${{ github.action_path }}" >> $Env:GITHUB_PATH
-        (Resolve-Path "${{ github.action_path }}/../../../Scripts").Path >> $Env:GITHUB_PATH
+        '${{ github.action_path }}' >> $Env:GITHUB_PATH
+        (Resolve-Path '${{ github.action_path }}/../../../Scripts').Path >> $Env:GITHUB_PATH
 
     - name: Add MSBuild to PATH
       # v2.0.0

.github/actions/publish-nuget/action.yml

@@ -46,8 +46,8 @@ runs:
     - name: Setup Scripts
       shell: pwsh
       run: |
-        "${{ github.action_path }}" >> $Env:GITHUB_PATH
-        (Resolve-Path "${{ github.action_path }}/../../../Scripts").Path >> $Env:GITHUB_PATH
+        '${{ github.action_path }}' >> $Env:GITHUB_PATH
+        (Resolve-Path '${{ github.action_path }}/../../../Scripts').Path >> $Env:GITHUB_PATH
 
     - name: Setup NuGet Version
       id: setup

.github/actions/set-checkout-token/action.yml

@@ -20,7 +20,7 @@ runs:
     - name: Setup Scripts
       shell: pwsh
       run: |
-        (Resolve-Path "${{ github.action_path }}/../../../Scripts").Path >> $Env:GITHUB_PATH
+        (Resolve-Path '${{ github.action_path }}/../../../Scripts').Path >> $Env:GITHUB_PATH
 
     - name: Set Checkout Token
       shell: pwsh

.github/actions/set-environment-variables/action.yml

@@ -0,0 +1,25 @@
+name: Set Environment Variables
+description: >
+  Set environment variables from a JSON string of key-value pairs, passed in via the ENVIRONMENT_VARIABLES_JSON
+  environment variable. Intentionally not documented in Actions.md since it's only meant for internal use.
+
+runs:
+  using: composite
+  steps:
+    - name: Setup Scripts
+      if: ${{ env.ENVIRONMENT_VARIABLES_JSON }}
+      shell: pwsh
+      run: |
+        (Resolve-Path '${{ github.action_path }}/../../../Scripts').Path >> $Env:GITHUB_PATH
+
+    - name: Set Environment Variables
+      if: ${{ env.ENVIRONMENT_VARIABLES_JSON }}
+      shell: pwsh
+      run: |
+        $envVars = ConvertFrom-Json $env:ENVIRONMENT_VARIABLES_JSON
+        foreach ($key in $envVars.PSObject.Properties.Name)
+        {
+            Write-Output "Setting environment variable $key."
+            Write-Output "::add-mask::$($envVars.$key)"
+            Set-GitHubEnv $key $envVars.$key
+        }

.github/actions/set-gha-refs/action.yml

@@ -40,7 +40,7 @@ runs:
     - name: Setup
       shell: pwsh
       run: |
-        "${{ github.action_path }}" >> $Env:GITHUB_PATH
+        '${{ github.action_path }}' >> $Env:GITHUB_PATH
 
     - name: Set References
       shell: pwsh

.github/actions/setup-dotnet/action.yml

@@ -13,7 +13,7 @@ runs:
     - name: Setup Scripts
       shell: pwsh
       run: |
-        (Resolve-Path "${{ github.action_path }}/../../../Scripts").Path >> $Env:GITHUB_PATH
+        (Resolve-Path '${{ github.action_path }}/../../../Scripts').Path >> $Env:GITHUB_PATH
 
     - name: Set Environment Variables
       shell: pwsh

.github/actions/setup-sql-server/action.yml

@@ -7,7 +7,7 @@ runs:
     - name: Setup
       shell: pwsh
       run: |
-        "${{ github.action_path }}" >> $Env:GITHUB_PATH
+        '${{ github.action_path }}' >> $Env:GITHUB_PATH
 
     - name: Set up SQL Server
       shell: pwsh

.github/actions/spelling/action.yml

@@ -65,8 +65,8 @@ runs:
     - name: Setup Scripts
       shell: pwsh
       run: |
-        "${{ github.action_path }}" >> $Env:GITHUB_PATH
-        (Resolve-Path "${{ github.action_path }}/../../../Scripts").Path >> $Env:GITHUB_PATH
+        '${{ github.action_path }}' >> $Env:GITHUB_PATH
+        (Resolve-Path '${{ github.action_path }}/../../../Scripts').Path >> $Env:GITHUB_PATH
 
     # If the configuration path doesn't exist in the workspace, then it means that the workspace repository doesn't have
     # its own spell-checking configuration. In that case we don't need to copy anything, because the configuration files

.github/actions/spelling/dictionaries/Lombiq.common.txt

@@ -47,7 +47,9 @@ hastlayer
 hca
 HHmmss
 hotfixes
+htmlvalidate
 idx
+iframes
 iis
 img
 importmap

.github/actions/spelling/dictionaries/Security.txt

@@ -1,5 +1,6 @@
 amd
 clickjacking
+CORS
 Entra
 nosniff
 openapi

.github/actions/test-dotnet/Invoke-SolutionTests.ps1 → .github/actions/test-dotnet/Invoke-SolutionOrProjectTests.ps1

@@ -1,5 +1,5 @@
 param (
-    [string] $Solution,
+    [string] $SolutionOrProject,
     [string] $Verbosity,
     [string] $Filter,
     [string] $Configuration,
@@ -44,40 +44,58 @@ $connectionString = @(
 $Env:Lombiq_Tests_UI__SqlServerDatabaseConfiguration__ConnectionStringTemplate = $connectionString
 $Env:Lombiq_Tests_UI__BrowserConfiguration__Headless = 'true'
 
-$solutionName = [System.IO.Path]::GetFileNameWithoutExtension($Solution)
-$solutionDirectory = [System.IO.Path]::GetDirectoryName($Solution)
-
-Write-Output "Running tests for the $Solution solution."
-
-Write-Output 'Gathering test projects.'
-
-$tests = dotnet sln $Solution list |
-    Select-Object -Skip 2 |
-    Select-String '\.Tests\.' |
-    Select-String -NotMatch 'Lombiq.Tests.UI.csproj' |
-    Select-String -NotMatch 'Lombiq.Tests.csproj' |
-    Where-Object {
-        # While the test projects are run individually, passing in the solution name and solution dir via the
-        # conventional MSBuild properties allows build customization.
-        $switches = @(
-            "--configuration:$Configuration"
-            '--list-tests'
-            "--verbosity:$Verbosity"
-            "-p:SolutionName=""$solutionName"""
-            "-p:SolutionDir=""$solutionDirectory"""
-        )
-
-        # Without Out-String, Contains() below won't work for some reason.
-        $output = dotnet test @switches $PSItem 2>&1 | Out-String -Width 9999
-
-        if ($LASTEXITCODE -ne 0)
-        {
-            Write-Error "::error::dotnet test failed for the project $PSItem with the following output:`n$output"
-            exit 1
+if ($SolutionOrProject -like '*.sln')
+{
+    $solutionName = [System.IO.Path]::GetFileNameWithoutExtension($SolutionOrProject)
+    $solutionDirectory = [System.IO.Path]::GetDirectoryName($SolutionOrProject)
+
+    Write-Output "Running tests for the $SolutionOrProject solution."
+
+    Write-Output 'Gathering test projects.'
+
+    $tests = dotnet sln $SolutionOrProject list |
+        Select-Object -Skip 2 |
+        Select-String '\.Tests\.' |
+        Select-String -NotMatch 'Lombiq.Tests.UI.csproj' |
+        Select-String -NotMatch 'Lombiq.Tests.csproj' |
+        ForEach-Object {
+            $absolutePath = Resolve-Path -Path (Join-Path -Path $solutionDirectory -ChildPath $PSItem)
+
+            # While the test projects are run individually, passing in the solution name and solution dir via the
+            # conventional MSBuild properties allows build customization.
+            $switches = @(
+                "--configuration:$Configuration"
+                '--list-tests'
+                "--verbosity:$Verbosity"
+                "-p:SolutionName=""$solutionName"""
+                "-p:SolutionDir=""$solutionDirectory"""
+            )
+
+            # Without Out-String, Contains() below won't work for some reason.
+            $output = dotnet test @switches $absolutePath 2>&1 | Out-String -Width 9999
+
+            if ($LASTEXITCODE -ne 0)
+            {
+                Write-Error "::error::dotnet test failed for the project $absolutePath with the following output:`n$output"
+                exit 1
+            }
+
+            if (-not [string]::IsNullOrEmpty($output) -and $output.Contains('The following Tests are available'))
+            {
+                $absolutePath
+            }
         }
-
-        -not [string]::IsNullOrEmpty($output) -and $output.Contains('The following Tests are available')
-    }
+}
+elseif ($SolutionOrProject -like '*.csproj')
+{
+    Write-Output "Running tests for the $SolutionOrProject project."
+    $tests = @($SolutionOrProject)
+}
+else
+{
+    Write-Error "The $SolutionOrProject is not a solution or project file."
+    exit 1
+}
 
 Set-GitHubOutput 'test-count' $tests.Length
 Set-GitHubOutput 'dotnet-test-hang-dump' 0

.github/actions/test-dotnet/Test-SolutionTests.ps1

@@ -1,15 +1,15 @@
 <#
 .Synopsis
-   Local testing script to run the Invoke-SolutionTests script. This needs to be invoked from the solution folder.
+   Local testing script to run the Invoke-SolutionOrProjectTests script. This needs to be invoked from the solution folder.
 #>
 
 $switches = @{
-    Solution = '.\Lombiq.OSOCE.sln'
+    SolutionOrProject = '.\Lombiq.OSOCE.sln'
     Verbosity = 'quiet'
     Filter = ''
     Configuration = 'Debug'
     BlameHangTimeout = '600000'
     TestProcessTimeout = '600000'
 }
 
-.\tools\Lombiq.GitHub.Actions\.github\actions\test-dotnet\Invoke-SolutionTests.ps1 @switches
+.\tools\Lombiq.GitHub.Actions\.github\actions\test-dotnet\Invoke-SolutionOrProjectTests.ps1 @switches