Add AvoidConflicts integration tests

- Created test-avoidconflicts.ps1 with comprehensive test scenarios
- Created test-avoidconflicts.yml workflow file
- Tests validate default import, SqlServer module compatibility, and verbose logging
- Workflow uses psmodulecache for efficient SqlServer module installation

Co-authored-by: Chrissy LeMaire <potatoqualitee@users.noreply.github.com>

Author: github-actions[bot]

tests/test-avoidconflicts.ps1

@@ -0,0 +1,105 @@
+# Test the AvoidConflicts parameter
+Write-Host "=== Testing AvoidConflicts Parameter ===" -ForegroundColor Cyan
+
+$testsPassed = 0
+$testsFailed = 0
+
+# Test 1: Import dbatools.library normally (without AvoidConflicts)
+Write-Host "`n--- Test 1: Default import without AvoidConflicts ---" -ForegroundColor Yellow
+try {
+    Remove-Module dbatools.library -ErrorAction SilentlyContinue
+    Import-Module ./artifacts/dbatools.library/dbatools.library.psd1 -Force
+
+    $loaded = [System.AppDomain]::CurrentDomain.GetAssemblies() | Where-Object { $_.GetName().Name -eq 'Microsoft.Data.SqlClient' }
+    if ($loaded) {
+        Write-Host "[PASS] Microsoft.Data.SqlClient loaded by default" -ForegroundColor Green
+        $testsPassed++
+    } else {
+        Write-Host "[FAIL] Microsoft.Data.SqlClient not loaded" -ForegroundColor Red
+        $testsFailed++
+    }
+} catch {
+    Write-Host "[FAIL] Exception: $_" -ForegroundColor Red
+    $testsFailed++
+}
+
+# Test 2: Import SqlServer module first, then dbatools.library with AvoidConflicts
+Write-Host "`n--- Test 2: Import with AvoidConflicts after SqlServer module ---" -ForegroundColor Yellow
+try {
+    Remove-Module dbatools.library -ErrorAction SilentlyContinue
+    Remove-Module SqlServer -ErrorAction SilentlyContinue
+
+    # Import SqlServer module first
+    Write-Host "Importing SqlServer module..." -ForegroundColor Gray
+    Import-Module SqlServer -ErrorAction Stop
+
+    # Get the SqlClient version loaded by SqlServer
+    $sqlServerClient = [System.AppDomain]::CurrentDomain.GetAssemblies() | Where-Object { $_.GetName().Name -eq 'Microsoft.Data.SqlClient' }
+    if ($sqlServerClient) {
+        Write-Host "SqlServer module loaded Microsoft.Data.SqlClient version: $($sqlServerClient.GetName().Version)" -ForegroundColor Gray
+    }
+
+    # Import dbatools.library with AvoidConflicts and capture verbose output
+    Write-Host "Importing dbatools.library with -AvoidConflicts..." -ForegroundColor Gray
+    $verboseOutput = Import-Module ./artifacts/dbatools.library/dbatools.library.psd1 -ArgumentList $true -Verbose 4>&1 | Out-String
+
+    if ($verboseOutput -match "Skipping.*already loaded") {
+        Write-Host "[PASS] Verbose output shows assemblies were skipped" -ForegroundColor Green
+        Write-Host "  Verbose message: $($verboseOutput -split "`n" | Where-Object { $_ -match 'Skipping' } | Select-Object -First 1)" -ForegroundColor Gray
+        $testsPassed++
+    } else {
+        Write-Host "[FAIL] No verbose output about skipping assemblies" -ForegroundColor Red
+        Write-Host "  Verbose output was: $verboseOutput" -ForegroundColor Gray
+        $testsFailed++
+    }
+} catch {
+    Write-Host "[FAIL] Exception: $_" -ForegroundColor Red
+    $testsFailed++
+}
+
+# Test 3: Verify module still functions with AvoidConflicts
+Write-Host "`n--- Test 3: Module functional after AvoidConflicts ---" -ForegroundColor Yellow
+try {
+    if ([Microsoft.SqlServer.Management.Smo.Server] -as [type]) {
+        Write-Host "[PASS] SMO types available after AvoidConflicts" -ForegroundColor Green
+        $testsPassed++
+    } else {
+        Write-Host "[FAIL] SMO types not available" -ForegroundColor Red
+        $testsFailed++
+    }
+} catch {
+    Write-Host "[FAIL] Exception: $_" -ForegroundColor Red
+    $testsFailed++
+}
+
+# Test 4: Verify no conflicts when importing both modules
+Write-Host "`n--- Test 4: No conflicts with both modules loaded ---" -ForegroundColor Yellow
+try {
+    # Try using both modules
+    $smoType = [Microsoft.SqlServer.Management.Smo.Server]
+    $sqlClientType = [Microsoft.Data.SqlClient.SqlConnection]
+
+    Write-Host "[PASS] Both modules can coexist without conflicts" -ForegroundColor Green
+    Write-Host "  SMO type available: $($smoType.FullName)" -ForegroundColor Gray
+    Write-Host "  SqlClient type available: $($sqlClientType.FullName)" -ForegroundColor Gray
+    $testsPassed++
+} catch {
+    Write-Host "[FAIL] Exception: $_" -ForegroundColor Red
+    $testsFailed++
+}
+
+# Summary
+Write-Host "`n========================================" -ForegroundColor White
+Write-Host "       TEST SUMMARY" -ForegroundColor White
+Write-Host "========================================" -ForegroundColor White
+Write-Host "Passed: $testsPassed" -ForegroundColor Green
+Write-Host "Failed: $testsFailed" -ForegroundColor $(if ($testsFailed -gt 0) { 'Red' } else { 'Green' })
+Write-Host "Total:  $($testsPassed + $testsFailed)" -ForegroundColor White
+
+if ($testsFailed -eq 0) {
+    Write-Host "`nALL AVOIDCONFLICTS TESTS PASSED!" -ForegroundColor Green
+    exit 0
+} else {
+    Write-Host "`nSOME TESTS FAILED - REVIEW BEFORE MERGE" -ForegroundColor Red
+    exit 1
+}

tests/test-avoidconflicts.yml

@@ -0,0 +1,62 @@
+name: Test AvoidConflicts
+
+on:
+  workflow_dispatch:
+  pull_request:
+    paths:
+      - 'dbatools.library.psm1'
+      - 'tests/test-avoidconflicts.ps1'
+      - '.github/workflows/test-avoidconflicts.yml'
+
+defaults:
+  run:
+    shell: pwsh
+
+jobs:
+  test-avoidconflicts:
+    runs-on: windows-latest
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Setup .NET
+      uses: actions/setup-dotnet@v4
+      with:
+        dotnet-version: |
+          8.0.x
+          6.0.x
+
+    - name: Install .NET Framework targeting packs
+      shell: pwsh
+      run: |
+        choco install netfx-4.7.2-devpack -y --no-progress
+
+    - name: Cache SqlServer PowerShell module
+      uses: potatoqualitee/psmodulecache@v6.2
+      with:
+        modules-to-cache: SqlServer
+        shell: pwsh
+
+    - name: Build the library
+      shell: pwsh
+      run: |
+        ./build/build.ps1
+
+    - name: Install SqlServer module
+      shell: pwsh
+      run: |
+        if (-not (Get-Module -ListAvailable -Name SqlServer)) {
+          Write-Host "Installing SqlServer module..." -ForegroundColor Cyan
+          Install-Module -Name SqlServer -Force -AllowClobber -SkipPublisherCheck
+        } else {
+          Write-Host "SqlServer module already installed" -ForegroundColor Green
+        }
+
+        # Verify installation
+        $module = Get-Module -ListAvailable -Name SqlServer | Select-Object -First 1
+        Write-Host "SqlServer module version: $($module.Version)" -ForegroundColor Cyan
+
+    - name: Run AvoidConflicts tests
+      shell: pwsh
+      run: |
+        ./tests/test-avoidconflicts.ps1