generating-tests

Generate xUnit tests for C#/.NET ABP Framework projects.

Quick Start

# Analyze source and generate tests
python scripts/generate_tests.py src/MyAppService.cs --type unit

Workflow

Copy this checklist and track progress:

Test Generation Progress:
- [ ] Step 1: Locate source file
- [ ] Step 2: Analyze public methods and dependencies
- [ ] Step 3: Select template based on source type
- [ ] Step 4: Generate test file
- [ ] Step 5: Validate generated tests compile

Step 1: Locate source

| Input | Action | |-------|--------| | File path | Read directly | | Class name | find api/src -name "*ClassName*.cs" -type f | | gaps | Run scripts/find_coverage_gaps.py |

Step 2: Analyze source

Extract from each public method:

• Method signature (name, parameters, return type)
• Constructor dependencies → mock with Substitute.For<T>()
• [Authorize] attributes → add 401/403 test cases
• FluentValidation rules → add validation error tests

Step 3: Select template

| Source Pattern | Reference | |----------------|-----------| | *AppService.cs | See reference/appservice-tests.md | | *Validator.cs | See reference/validator-tests.md | | *Controller.cs | See reference/integration-tests.md |

Step 4: Generate and write

Output locations:

• Unit tests: api/test/[Module].Application.Tests/[Class]Tests.cs
• Integration tests: api/test/[Module].HttpApi.Tests/[Class]IntegrationTests.cs

Step 5: Validate

dotnet build api/test/[Module].Application.Tests/

If build fails, fix compilation errors and rebuild.

Test Naming

Use pattern: [Method]_[Scenario]_[Expected]

| Example | Meaning | |---------|---------| | Create_ValidInput_ReturnsDto | Happy path | | Create_MissingName_ThrowsValidation | Validation failure | | Get_NotFound_ThrowsException | Entity not found | | Delete_Unauthorized_Returns403 | Permission denied |