add PowerShell scripts for Windows

Author: lucaspimentel

install-jdks-windows.ps1

@@ -0,0 +1,50 @@
+# Enable error handling
+Set-StrictMode -Version Latest
+$ErrorActionPreference = 'Stop'
+$ProgressPreference = 'SilentlyContinue'
+
+# winget may not be available for a few minutes if you just signed into Windows for the first time
+if (-not (Get-Command 'winget.exe' -ErrorAction SilentlyContinue)) {
+  # this command will ensure it is available.
+  Add-AppxPackage -RegisterByFamilyName -MainPackage Microsoft.DesktopAppInstaller_8wekyb3d8bbwe -ErrorAction SilentlyContinue
+}
+
+# if winget is still not available, it may not be pre-installed in your Windows version
+if (-not (Get-Command 'winget.exe' -ErrorAction SilentlyContinue)) {
+  Write-Host 'Installing WinGet PowerShell module from PSGallery...'
+  Install-PackageProvider -Name NuGet -Force | Out-Null
+  Install-Module -Name Microsoft.WinGet.Client -Force -Repository PSGallery | Out-Null
+  Write-Host 'Using Repair-WinGetPackageManager cmdlet to bootstrap WinGet...'
+  Repair-WinGetPackageManager
+  Write-Host 'WinGet.'
+}
+
+# install the required JDKs
+$jdkVersions = @('8', '11', '17', '21')
+
+foreach ($jdkVersion in $jdkVersions) {
+  Write-Host "ℹ️ Installing EclipseAdoptium.Temurin.${jdkVersion}.JDK"
+  winget install --silent --disable-interactivity --accept-package-agreements --source winget --exact --id "EclipseAdoptium.Temurin.${jdkVersion}.JDK"
+}
+
+# find the JDK installation paths
+if (Test-Path 'C:\Program Files\Eclipse Adoptium') {
+  $jdkDirs = Get-ChildItem -Path 'C:\Program Files\Eclipse Adoptium' -Directory
+} else {
+  Write-Host '❌ Directory "C:\Program Files\Eclipse Adoptium" does not exist. Cannot set environment variables.'
+  exit 1
+}
+
+# set the required JDK environment variables
+foreach ($jdkDir in $jdkDirs) {
+  if ($jdkDir.Name -match 'jdk-(\d+)\..*-hotspot') {
+    $jdkDirFullName = $jdkDir.FullName
+    $version = $matches[1]
+    $envVarName = "JAVA_${version}_HOME"
+    Write-Host "ℹ️ Setting $envVarName=$jdkDirFullName"
+    [System.Environment]::SetEnvironmentVariable($envVarName, $jdkDirFullName, [System.EnvironmentVariableTarget]::User)
+  }
+}
+
+Write-Host 'ℹ️ Setting JAVA_HOME=%JAVA_8_HOME%'
+[System.Environment]::SetEnvironmentVariable('JAVA_HOME', '%JAVA_8_HOME%', [System.EnvironmentVariableTarget]::User)

setup.ps1

@@ -0,0 +1,130 @@
+# Enable error handling
+Set-StrictMode -Version Latest
+$ErrorActionPreference = 'Stop'
+
+function TestJvm {
+  param ($JavaHomeName, $ExpectedJavaVersion)
+
+  if (-not (Test-Path "env:$JavaHomeName")) {
+    Write-Host "❌ $JavaHomeName is not set. Please set $JavaHomeName to refer to a JDK $ExpectedJavaVersion installation." -ForegroundColor Red
+    exit 1
+  }
+  else {
+    $javaHome = Get-Item "env:$JavaHomeName" | Select-Object -ExpandProperty Value
+
+    try {
+      # try to handle differences between PowerShell 7 and Windows PowerShell 5
+      $ErrorActionPreference = 'Continue'
+      $javaVersionOutput = & "$javaHome\bin\java.exe" -version 2>&1
+    }
+    catch {
+      Write-Host "❌ Error running `"$javaHome\bin\java.exe -version`". Please check that $JavaHomeName is set to a JDK $ExpectedJavaVersion installation."
+      exit 1
+    }
+    finally {
+      $ErrorActionPreference = 'Stop'
+    }
+
+    if ($javaVersionOutput[0] -notmatch "version `"$ExpectedJavaVersion") {
+      Write-Host "❌ $JavaHomeName is set to $javaHome, but it does not refer to a JDK $ExpectedJavaVersion installation." -ForegroundColor Red
+      exit 1
+    }
+    else {
+      Write-Host "✅ $JavaHomeName is set to $javaHome."
+    }
+  }
+}
+
+Write-Host 'ℹ️ Checking required JVM:'
+if (Test-Path 'env:JAVA_HOME') {
+  TestJvm 'JAVA_HOME' '1.8'
+}
+
+TestJvm 'JAVA_8_HOME' '1.8'
+TestJvm 'JAVA_11_HOME' '11'
+TestJvm 'JAVA_17_HOME' '17'
+TestJvm 'JAVA_21_HOME' '21'
+TestJvm 'JAVA_GRAALVM17_HOME' '17'
+
+# Check for required commands (e.g., git, docker)
+function TestCommand {
+  param ($command)
+
+  if (Get-Command $command -ErrorAction SilentlyContinue) {
+    Write-Host "✅ The $command command line is installed."
+  }
+  else {
+    Write-Host "❌ The $command command line is missing. Please install $command." -ForegroundColor Red
+    exit 1
+  }
+}
+
+function Get-FileHashMD5 {
+  param ($file)
+  return (Get-FileHash -Path $file -Algorithm MD5).Hash
+}
+
+function TestHook {
+  param ($hookName)
+
+  $hookChecksum = Get-FileHashMD5 ".githooks/$hookName"
+  $hooksPath = (git config core.hooksPath) -or '.git/hooks'
+
+  if ((Test-Path ".git/hooks/$hookName") -and (Get-FileHashMD5 ".git/hooks/$hookName" -eq $hookChecksum)) {
+    Write-Host "✅ $hookName hook is installed in repository."
+  }
+  elseif ((Test-Path "$hooksPath/$hookName") -and (Get-FileHashMD5 "$hooksPath/$hookName" -eq $hookChecksum)) {
+    Write-Host "✅ $hookName hook is installed in git hooks path."
+  }
+  else {
+    Write-Host "🟨 $hookName hook was not found (optional but recommended)."
+  }
+}
+
+function TestGitConfig {
+  param ($configName, $expectedValue)
+
+  $actualValue = git config $configName
+
+  if ($actualValue -eq $expectedValue) {
+    Write-Host "✅ git config $configName is set to $expectedValue."
+  }
+  elseif (-not $actualValue) {
+    Write-Host "❌ git config $configName is not set. Please set it to $expectedValue." -ForegroundColor Red
+  }
+  else {
+    Write-Host "🟨 git config $configName is set to $actualValue (expected: $expectedValue)."
+  }
+}
+
+Write-Host 'ℹ️ Checking git configuration:'
+TestCommand 'git'
+TestHook 'pre-commit'
+TestGitConfig 'submodule.recurse' 'true'
+
+# Check Docker environment
+function TestDockerServer {
+  try {
+    # try to handle differences between PowerShell 7 and Windows PowerShell 5
+    $ErrorActionPreference = 'Continue'
+    docker info *> $null
+
+    if ($LASTEXITCODE -eq 0) {
+      Write-Host "✅ The Docker server is running."
+    }
+    else {
+      Write-Host "🟨 The Docker server is not running. Please start it to run all tests."
+    }
+  }
+  catch {
+    Write-Host "❌ Error running `"docker info *> $null`"."
+    exit 1
+  }
+  finally {
+    $ErrorActionPreference = 'Stop'
+  }
+}
+
+Write-Host 'ℹ️ Checking Docker environment:'
+TestCommand 'docker'
+TestDockerServer