capod/.claude/rules/testing.md

description, paths

description	paths
Unit test conventions — JUnit 5, kotest assertions, mockk, BaseTest, and which Gradle task runs which source set	app/src/test/** app/src/testFoss/** app/src/testGplay/** app/build.gradle.kts buildSrc/src/main/java/Dependencies.kt

Testing

The stack here is not the Android default — check this before reaching for a familiar library.

Libraries

• JUnit 5 (org.junit.jupiter.api.Test). Gradle sets useJUnitPlatform().
• kotest for assertions: io.kotest.matchers.shouldBe, shouldBeNull, shouldBeInstanceOf, shouldContainExactly, io.kotest.assertions.throwables.shouldThrow. Use kotest for new assertions — MediaControlTest still uses JUnit Assertions.* and is a legacy exception.
• mockk for mocking. Not Mockito.
• Turbine is not a dependency. testhelpers.flow.FlowTest provides a Flow<T>.test() helper — use it rather than adding one.

Base classes

Extend testhelpers.BaseTest, or the applicable specialized base that already extends it:

• BaseBlePodsTest — BLE advertisement parsing per pod model
• BaseAapSessionTest — AAP protocol/session tests

BaseTest installs a JUnitLogger and calls unmockkAll() in @AfterAll. Skipping it can leave global mockk and logging state behind for later test classes.

The only exceptions are the two Robolectric-backed Compose UI tests (UpgradeScreenFossComposeTest, UpgradeScreenComposeTest), which use JUnit 4 @RunWith/@Rule via junit-vintage-engine. Don't copy that pattern for a plain unit test.

Source sets and Gradle tasks

Each task compiles and runs only its own flavor — running the wrong one silently skips your test.

Test location	Task
app/src/test/ (shared)	either; run both before pushing
app/src/testFoss/	./gradlew testFossDebugUnitTest
app/src/testGplay/	./gradlew testGplayDebugUnitTest

CI runs both. Flavor-specific tests are for code that only exists in that flavor — billing in gplay, the sponsor-based upgrade flow in foss.