Testing Guide#

Overview of the testing strategy, organization, and execution in Lazurite.

Running Tests#

Use the just recipes for a consistent testing experience:

• just test: Run tests with a 60s timeout and verbose output.
• just test-quiet: Run tests with a 30s timeout and quiet output (failures only). Useful for identifying hanging tests or pinpointing errors.
• just check: Run format, lint, and all tests. Recommended before any commit.

Organization#

Test files must mirror the lib/src directory structure.

• Source: lib/src/features/feed/application/feed_notifier.dart
• Test: test/src/features/feed/application/feed_notifier_test.dart

All shared test helpers and mocks are located in test/helpers/.

Core Documentation#

• Testing Patterns: Guidance on Riverpod, Drift, and Async patterns.
• Tests By Type: Specific setup and examples for Widget, Repository, DAO, and Router tests.
• Troubleshooting & Pitfalls: Solutions for common issues like pending timers, memory leaks, and font loading.

Reference Examples#

• Widget Tests: test/src/features/search/presentation/screens/search_screen_test.dart
• Repository Tests: test/src/features/feeds/infrastructure/feed_repository_test.dart
• DAO Tests: test/src/infrastructure/db/daos/saved_feeds_dao_test.dart
• Router Tests: test/src/app/router_test.dart