First attempt at a Pester test for Windows

Author: janhoy

.github/workflows/pester-tests.yml

@@ -0,0 +1,44 @@
+name: Powershell Pester Tests
+
+on:
+  push:
+    branches: [ main, SOLR-17508-* ]
+    paths:
+      - 'solr/packaging/powershell-tests/**'
+      - 'solr/packaging/build.gradle'
+      - 'solr/bin/solr.cmd'
+      - 'solr/bin/solr.in.cmd'
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  pester-tests:
+    runs-on: windows-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Java
+        uses: actions/setup-java@v3
+        with:
+          java-version: '21'
+          distribution: 'temurin'
+
+      - name: Build Solr distribution
+        run: |
+          cd solr/packaging
+          gradle installFullDist
+        shell: powershell
+
+      - name: Run Pester tests
+        run: |
+          cd solr/packaging
+          gradle pesterTests
+        shell: powershell
+
+      - name: Upload test results
+        if: always()
+        uses: actions/upload-artifact@v3
+        with:
+          name: pester-test-results
+          path: solr/packaging/build/test-output/

solr/packaging/build.gradle

@@ -273,6 +273,65 @@ task integrationTests(type: BatsTask) {
   environment BATS_LIB_PREFIX: "$nodeProjectDir/node_modules"
 }
 
+task pesterTests {
+  dependsOn installFullDist
+  onlyIf { Os.isFamily(Os.FAMILY_WINDOWS) }
+
+  def integrationTestOutput = "$buildDir/test-output"
+  def solrHome = "$integrationTestOutput/solr-home"
+  def solrTestFailuresDir = "$integrationTestOutput/failure-snapshots"
+  var solrPort = Integer.parseInt((String) project.findProperty('pester.port') ?: System.getProperty("pester.port", "-1"))
+  while (solrPort > 64000 || solrPort < 0) { // We need room for +1000 for ZK
+    try (ServerSocket s = new ServerSocket(0)) {
+      solrPort = s.getLocalPort()
+    } catch (Exception e) {
+      println("WARN: Could not assign random port for Pester tests. Using default port 8983.")
+      solrPort = 8983
+    }
+  }
+
+  inputs.dir(distDir)
+  outputs.dir(integrationTestOutput)
+
+  doFirst {
+    delete integrationTestOutput
+    mkdir integrationTestOutput
+    mkdir solrHome
+    mkdir solrTestFailuresDir
+
+    println("Running Pester tests with Solr base port ${solrPort}")
+  }
+
+  doLast {
+    exec {
+      executable "powershell"
+      args = [
+        "-Command",
+        "& { " +
+        "Import-Module Pester -MinimumVersion 5.0; " +
+        "\$config = New-PesterConfiguration; " +
+        "\$config.Run.Path = 'powershell-tests'; " +
+        "\$config.Run.Exit = \$true; " +
+        "\$config.TestResult.OutputPath = '${integrationTestOutput}/test-results.xml'; " +
+        "\$env:SOLR_TIP = '${distDir}'; " +
+        "\$env:SOLR_HOME = '${solrHome}'; " +
+        "\$env:SOLR_PID_DIR = '${solrHome}'; " +
+        "\$env:SOLR_PORT = ${solrPort}; " +
+        "\$env:SOLR2_PORT = ${solrPort + 1}; " +
+        "\$env:SOLR3_PORT = ${solrPort + 2}; " +
+        "\$env:ZK_PORT = ${solrPort + 1000}; " +
+        "\$env:SOLR_LOGS_DIR = '${solrHome}/logs'; " +
+        "\$env:TEST_OUTPUT_DIR = '${integrationTestOutput}'; " +
+        "\$env:TEST_FAILURE_DIR = '${solrTestFailuresDir}'; " +
+        "Invoke-Pester -Configuration \$config; " +
+        "}"
+      ]
+
+      workingDir projectDir.toString()
+    }
+  }
+}
+
 class BatsTask extends Exec {
   @InputDirectory
   String testDir = 'test'

solr/packaging/powershell-tests/Test-Version.ps1

@@ -0,0 +1,54 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+<#
+  Pester tests for Solr version command
+  Ported from test/test_version.bats
+#>
+
+BeforeAll {
+  # Get the Solr installation directory from environment variable
+  $script:SolrTip = $env:SOLR_TIP
+  if (-not $SolrTip) {
+    throw "SOLR_TIP environment variable is not set"
+  }
+
+  # Determine the Solr executable based on OS
+  $script:SolrCmd = Join-Path $SolrTip "bin\solr.cmd"
+
+  if (-not (Test-Path $SolrCmd)) {
+    throw "Solr executable not found at: $SolrCmd"
+  }
+
+  Write-Host "Using Solr installation at: $SolrTip"
+  Write-Host "Using Solr command: $SolrCmd"
+}
+
+Describe "Solr Version Command" {
+  Context "When using --version flag" {
+    It "--version returns Solr version" {
+      $output = & $SolrCmd --version 2>&1
+      $output | Should -Contain "Solr version is:"
+    }
+  }
+
+  Context "When using version as direct command" {
+    It "version as direct tool call still runs" {
+      $output = & $SolrCmd version 2>&1
+      $output | Should -Contain "Solr version is:"
+    }
+  }
+}