log-timber/no.nordicsemi.kotlin.log.timber

Package-level declarations

Contains the Log.Sink.Timber(...) extension function.

What it does

Bridges no.nordicsemi.kotlin.log.Log events to Timber.
Keeps lazy message evaluation from :log.
Supports category and source-aware tags.
Lets you customize the log-level filter.

Tag format

The Timber tag is built as:

${category.name},
${category.name} (${source}) when source is available.

Usage

import no.nordicsemi.kotlin.log.Log
import no.nordicsemi.kotlin.log.timber.Timber
import timber.log.Timber

enum class AppCategory : Log.Category {
    NETWORK,
    STORAGE,
}

fun configureLogging(): Log.Sink<AppCategory> {
    Timber.plant(Timber.DebugTree())

    // INFO and above by default; override with your own filter.
    return Log.Sink.Timber { _, level ->
        level >= Log.Level.DEBUG
    }
}

Functions

Timber

fun <C : Log.Category> Log.Sink.Implementation.Timber(filter: (C, Log.Level) -> Boolean = { _, level -> level >= Log.Level.INFO }): Log.Sink<C>

Timber log sink.