Cursor rule

1---
2paths:
3  - "**/*.cs"
4  - "**/*.csx"
5  - "**/*.csproj"
6---
7# C# Testing
8 
9> This file extends [common/testing.md](../common/testing.md) with C#-specific content.
10 
11## Test Framework
12 
13- Prefer **xUnit** for unit and integration tests
14- Use **FluentAssertions** for readable assertions
15- Use **Moq** or **NSubstitute** for mocking dependencies
16- Use **Testcontainers** when integration tests need real infrastructure
17 
18## Test Organization
19 
20- Mirror `src/` structure under `tests/`
21- Separate unit, integration, and end-to-end coverage clearly
22- Name tests by behavior, not implementation details
23 
24```csharp
25public sealed class OrderServiceTests
26{
27    [Fact]
28    public async Task FindByIdAsync_ReturnsOrder_WhenOrderExists()
29    {
30        // Arrange
31        // Act
32        // Assert
33    }
34}
35```
36 
37## ASP.NET Core Integration Tests
38 
39- Use `WebApplicationFactory<TEntryPoint>` for API integration coverage
40- Test auth, validation, and serialization through HTTP, not by bypassing middleware
41 
42## Coverage
43 
44- Target 80%+ line coverage
45- Focus coverage on domain logic, validation, auth, and failure paths
46- Run `dotnet test` in CI with coverage collection enabled where available
47