5429008d98
Introduce comprehensive documentation covering architecture (ARCHITECTURE.md), concerns (CONCERNS.md), coding conventions (CONVENTIONS.md), integrations (INTEGRATIONS.md), technology stack (STACK.md), codebase structure (STRUCTURE.md), and testing patterns (TESTING.md). Enhance testing with additional test cases for external sign-in flows, ensuring accurate timestamp recording for identity links.
48 lines
2 KiB
Markdown
48 lines
2 KiB
Markdown
# Testing Patterns
|
|
|
|
## Test Stack and Commands
|
|
|
|
- Framework: xUnit 2.9.3.
|
|
- Assertion/mocking: xUnit assertions, NSubstitute 5.3.0, ASP.NET Core TestServer, SQLite in-memory EF Core.
|
|
|
|
```bash
|
|
dotnet test Elsa.sln
|
|
dotnet test test/unit/Elsa.ExternalAuthentication.UnitTests/Elsa.ExternalAuthentication.UnitTests.csproj
|
|
dotnet test test/integration/Elsa.ExternalAuthentication.IntegrationTests/Elsa.ExternalAuthentication.IntegrationTests.csproj
|
|
```
|
|
|
|
## Test Layout
|
|
|
|
- Test projects are separated under `test/unit`, `test/integration`, `test/component`, and `test/performance`.
|
|
- Test files use `*Tests.cs`; xUnit setup uses constructors or `IAsyncLifetime`.
|
|
- Shared helpers live under `src/common/Elsa.Testing.Shared*`.
|
|
|
|
## Test Scope Matrix
|
|
|
|
| Scope | Covered | Typical target | Notes |
|
|
|---|---|---|---|
|
|
| Unit | Yes | Validators, in-memory stores, isolated services | Fast and dependency-light |
|
|
| Integration | Yes | Broker flow, REST endpoints, SQLite persistence | Used for external-auth tracking regression |
|
|
| Component | Yes | Workflow runtime behavior | Not needed for this identity defect |
|
|
| E2E browser | `[TODO]` | Studio rendering | Studio repository is separate |
|
|
|
|
## Mocking and Isolation Strategy
|
|
|
|
- Prefer real in-memory provisioners and stores for state assertions.
|
|
- Substitute adapters, role providers, and notification senders at boundaries.
|
|
- SQLite `Data Source=:memory:` provides isolated durable-store tests.
|
|
|
|
## Coverage and Quality Signals
|
|
|
|
- Coverlet generates Cobertura, LCOV, and OpenCover output.
|
|
- Default project threshold is 10% total line coverage.
|
|
- Focused filtered runs may disable coverage; the full project run enforces the threshold.
|
|
|
|
## Evidence
|
|
|
|
- `test/Directory.Build.props`
|
|
- `test/integration/Elsa.ExternalAuthentication.IntegrationTests/Broker/BrokerSecurityTests.cs`
|
|
- `test/integration/Elsa.ExternalAuthentication.IntegrationTests/Persistence/ExternalAuthenticationPersistenceTests.cs`
|
|
- `test/integration/Elsa.ExternalAuthentication.IntegrationTests/Links/ExternalIdentityLinkTests.cs`
|
|
|