Android Unit Tests

barK automatically detects Android test environments and switches output accordingly — no configuration required.

---

How Test Detection Works

At runtime, barK inspects the JVM classpath for known testing frameworks:

Framework	Detected via
JUnit 4	org.junit.Test
Robolectric	org.robolectric.RobolectricTestRunner
Espresso	androidx.test.espresso.Espresso
AndroidX Test	androidx.test.core.app.ApplicationProvider

Only when any of these are found do the UnitTestTrainer classes activate.

---

Recommended Test Setup

ExampleTest.kt

class ExampleTest {

    @Before
    fun setup() {
        Bark.releaseAllTrainers()
        Bark.train(ColoredUnitTestTrainer())
    }

    @After
    fun teardown() {
        Bark.releaseAllTrainers()
    }

    @Test
    fun testSomething() {
        Bark.d("Starting test")
        // ...
        Bark.i("Test completed")
    }
}

---

Choosing a Test Trainer

UnitTestTrainer

Plain text output with optional Level and timestamps.

ColoredUnitTestTrainer

Extends the UnitTestTrainer with ANSI-colored output. Best a full aesthetic experience.

---

Log Level Filtering in Tests

Control how much noise appears in test output:

@Before
fun setup() {
    Bark.releaseAllTrainers()
    Bark.train(ColoredUnitTestTrainer(minLevel = Level.WARNING))
}

---

Multiple Trainers in Tests

@Before
fun setup() {
    Bark.releaseAllTrainers()
    Bark.train(ColoredUnitTestTrainer())    // Console output
    Bark.train(FileTrainer(                 // Also write to file
        minLevel = Level.ERROR,
        logFile = File("test-errors.log")
    ))
}

---

Robolectric

barK works with Robolectric out of the box. Test detection fires before any log call:

@RunWith(RobolectricTestRunner::class)
class MainActivityTest {

    @Before
    fun setup() {
        Bark.train(ColoredUnitTestTrainer())
    }

    @Test
    fun testActivityCreation() {
        val activity = Robolectric.buildActivity(MainActivity::class.java).create().get()
        Bark.d("Activity under test: $activity")
        assertNotNull(activity)
    }
}

Note

When using Robolectric, AndroidLogTrainer calls are silently dropped since Logcat is unavailable. Use ColoredUnitTestTrainer or UnitTestTrainer instead.