TestCommand class

Command to execute Flutter unit tests across the project and all modules.

This command provides comprehensive testing capabilities for modular Flutter projects, supporting selective testing of specific apps, features, or pages. It automatically generates bundle test files and handles coverage reporting.

Purpose:

• Execute unit tests across modular project structure
• Generate and manage bundle test files for efficient test execution
• Support selective testing by app, feature, or page
• Provide code coverage analysis and reporting
• Combine coverage data from multiple modules

Test Hierarchy:

Project
├── Apps (Optional)
│   └── Features
│       └── Pages
└── Features (Global)
    └── Pages

Usage Examples:

# Run all tests
morpheme test

# Test specific feature
morpheme test --feature authentication

# Test specific page in feature
morpheme test --feature authentication --page login

# Run with coverage
morpheme test --coverage

# Custom reporter
morpheme test --reporter json --file-reporter json:reports/tests.json

Parameters:

• --apps (-a): Target specific app for testing
• --feature (-f): Target specific feature for testing
• --page (-p): Target specific page for testing
• --coverage (-c): Enable code coverage reporting
• --reporter (-r): Set test result output format
• --file-reporter: Save test results to file

Bundle Test Generation: The command automatically generates bundle_test.dart files that import and execute all individual test files within a module, enabling efficient batch test execution.

Coverage Integration: When coverage is enabled, the command collects LCOV data from all modules and combines it into a unified coverage report at the project root.

Exceptions:

• Throws ValidationException if invalid test targets are specified
• Throws FileSystemException if test file operations fail
• Throws TestExecutionException if test runs fail