Testing

You'll learn how to run the full test suite and focused filters while developing auth or FGA features.

Test layout#

• tests/SqlOS.Tests — unit tests
• tests/SqlOS.IntegrationTests — real SQL Server (Aspire container)
• examples/SqlOS.Example.IntegrationTests — example API flows
• examples/SqlOS.Todo.IntegrationTests — Todo sample flows
• tests/SqlOS.Benchmarks — performance benchmarks

Run everything#

dotnet build SqlOS.sln
./scripts/unit-tests.sh
./scripts/integration-tests.sh
./scripts/docs-check.sh

docs-check.sh runs the website lint, production build, and link validation across repo and site docs.

Integration coverage#

Integration tests use Aspire and SQL Server containers for:

• Auth and FGA schema bootstrap
• OAuth, OTP, and invitation flows
• AuthServer resilience across app instance replacement, including persisted signing keys and full PKCE token exchange
• Client registration and resource indicators
• FGA checks and EF query composition
• Example and Todo sample end-to-end paths

Focused runs#

dotnet test tests/SqlOS.Tests/SqlOS.Tests.csproj --filter SqlOSInvitationServiceTests
dotnet test tests/SqlOS.Tests/SqlOS.Tests.csproj --filter RequestEmailOtpSignupAsync
dotnet test tests/SqlOS.IntegrationTests/SqlOS.IntegrationTests.csproj --filter AuthServerSigningKeyResilienceIntegrationTests

Coverage settings live in tests/coverlet.runsettings.

Next steps#

• Getting Started
• Troubleshooting
• Contributing