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