Automatic Tool Installation: Installs necessary .NET tools if not already present
PATH Management: Automatically adds .NET tools to PATH
Test Execution: Runs the complete test suite
Coverage Collection: Collects code coverage data
Report Generation: Creates HTML coverage reports
Summary Statistics: Provides coverage metrics

Usage Options

Full Mode (Default)

Runs tests with coverage collection and generates a detailed report.

# Bash (Linux/macOS)
./scripts/run-tests-with-coverage.sh

# PowerShell (Windows)
.\scripts\run-tests-with-coverage.ps1

Tests Only Mode

Runs tests quickly without coverage collection (faster execution).

# Bash (Linux/macOS)
./scripts/run-tests-with-coverage.sh --tests-only

# PowerShell (Windows)
.\scripts\run-tests-with-coverage.ps1 tests-only

Coverage Only Mode

Generates coverage report from existing coverage data.

# Bash (Linux/macOS)
./scripts/run-tests-with-coverage.sh --coverage-only

# PowerShell (Windows)
.\scripts\run-tests-with-coverage.ps1 coverage-only

Help

Shows usage information and available options.

# Bash (Linux/macOS)
./scripts/run-tests-with-coverage.sh --help

# PowerShell (Windows)
.\scripts\run-tests-with-coverage.ps1 help

Prerequisites

The scripts will automatically install the following tools if not present:

coverlet.collector: For code coverage collection
dotnet-reportgenerator-globaltool: For generating HTML reports

Output

Test Results

Test execution status and results
Pass/fail statistics
Execution time

Coverage Data

File: coverage.cobertura.xml
Format: Cobertura XML format
Location: Project root directory

Coverage Report

Directory: coverage-report/
Main File: coverage-report/index.html
Format: Interactive HTML report
Features:
- Line-by-line coverage details
- Branch coverage information
- File-level statistics
- Search and filter capabilities

Coverage Summary

The scripts provide a summary of coverage metrics:

Line Coverage: Percentage of code lines executed
Branch Coverage: Percentage of code branches executed
File Coverage: Coverage statistics per file

Troubleshooting

Common Issues

Permission Denied (Bash script)

chmod +x scripts/run-tests-with-coverage.sh

PowerShell Execution Policy (PowerShell script)

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

No Coverage Data Generated
- This is normal if no code was executed during tests
- Check that tests are actually running the code under test
Tools Not Found
- The scripts will automatically install missing tools
- Ensure you have .NET SDK installed

Manual Tool Installation

If automatic installation fails, you can install tools manually:

# Install coverage collector
dotnet tool install --global coverlet.collector

# Install report generator
dotnet tool install --global dotnet-reportgenerator-globaltool

Integration with CI/CD

These scripts can be integrated into CI/CD pipelines:

# Example GitHub Actions step
- name: Run Tests with Coverage
  run: ./scripts/run-tests-with-coverage.sh --tests-only

- name: Generate Coverage Report
  run: ./scripts/run-tests-with-coverage.sh --coverage-only

Customization

The scripts can be customized by modifying:

Coverage collection options: Modify the dotnet test command parameters
Report generation: Change report types and output formats
Tool installation: Add or remove required tools
Output directories: Modify coverage and report directories

Support

For issues or questions about the scripts:

Check the troubleshooting section above
Review the script output for error messages
Ensure all prerequisites are met
Verify .NET SDK is properly installed