Running tests on Linux from Windows

The Linux/Unix code path is exercised in CI on ubuntu-latest, but you can also run the suite locally against a Linux container — useful when changing platform-specific code.

Requirements

• Rancher Desktop (or Docker Desktop) with the dockerd / moby engine enabled so docker is on PATH
• PowerShell 7+

Usage

pwsh ./scripts/test-linux.ps1

The script mounts the repo into mcr.microsoft.com/dotnet/sdk:10.0 and runs dotnet build + dotnet test. The host's bin/ and obj/ folders are shadowed inside the container with anonymous volumes, so the Linux build neither sees the Windows IDE artifacts nor writes back into the host tree. A named volume (VcsToolkit-nuget) caches NuGet packages between runs.

Useful switches:

pwsh ./scripts/test-linux.ps1 -Filter "FullyQualifiedName~TestMethodName"
pwsh ./scripts/test-linux.ps1 -Configuration Debug -Rebuild