logger/dev.shivathapaa.logger.api/Log

Log

object Log(source)

Simple logging API for quick, tag-based logging.

All calls are routed through LoggerFactory, so sinks, formatters, and level filtering configured via LoggerFactory.install apply equally to both APIs.

For structured logging with attributes and context, use Logger from LoggerFactory instead.

Usage:

// Direct logging with default tag
Log.i("App started")
Log.e("Error occurred", throwable = exception)

// With custom tag
Log.i("User logged in", tag = "Auth")

// Using class-based tag
class MyViewModel {
    private val log = Log.withClassTag<MyViewModel>()

    fun doSomething() {
        log.d("Doing something")
    }
}

// Using custom tag wrapper
val log = Log.withTag("NetworkModule")
log.d("Connecting to server")

Functions

fun d(message: String, tag: String = defaultTag)

Logs a DEBUG message.

fun e(message: String, tag: String = defaultTag, throwable: Throwable? = null)

Logs an ERROR message.

fun fatal(message: String, tag: String = defaultTag, throwable: Throwable? = null)

Logs a FATAL message and throws a RuntimeException after all sinks have been flushed.

fun i(message: String, tag: String = defaultTag)

Logs an INFO message.

fun setDefaultTag(tag: String)

Sets the default tag used for all Log calls that do not specify an explicit tag. Call this once during application initialization.

fun v(message: String, tag: String = defaultTag)

Logs a VERBOSE message.

fun w(message: String, tag: String = defaultTag, throwable: Throwable? = null)

Logs a WARN message.

inline fun <T> withClassTag(): LogWrapper

Returns a LogWrapper whose tag is derived from the simple name of class T.

fun withTag(tag: String): LogWrapper

Returns a LogWrapper that uses tag on every call.