feat(logging): add log level provider and manager

import android.content.Context

import kotlin.time.ExperimentalTime

import net.thunderbird.app.common.BuildConfig

import net.thunderbird.app.common.core.logging.DefaultLogLevelManager

import net.thunderbird.core.logging.DefaultLogger

import net.thunderbird.core.logging.LogLevel

import net.thunderbird.core.logging.LogLevelManager

import net.thunderbird.core.logging.LogLevelProvider

import net.thunderbird.core.logging.LogSink

import net.thunderbird.core.logging.Logger

import net.thunderbird.core.logging.composite.CompositeLogSink

import net.thunderbird.core.logging.file.FileLogSink

import org.koin.core.module.Module

import org.koin.core.qualifier.named

import org.koin.dsl.bind

import org.koin.dsl.module

val appCommonCoreModule: Module = module {

    single<LogLevelManager> {

        DefaultLogLevelManager()

    }.bind<LogLevelProvider>()

    single<LogLevel> {

        if (BuildConfig.DEBUG) LogLevel.VERBOSE else LogLevel.INFO

        get<LogLevelProvider>().current()

    }

    single<List<LogSink>> {

package net.thunderbird.app.common.core.logging

import kotlinx.coroutines.flow.MutableStateFlow

import kotlinx.coroutines.flow.update

import net.thunderbird.app.common.BuildConfig

import net.thunderbird.core.logging.LogLevel

import net.thunderbird.core.logging.LogLevelManager

class DefaultLogLevelManager : LogLevelManager {

    private val defaultLevel = if (BuildConfig.DEBUG) LogLevel.VERBOSE else LogLevel.INFO

    private val logLevel = MutableStateFlow(defaultLevel)

    override fun override(level: LogLevel) {

        logLevel.update { level }

    }

    override fun restoreDefault() {

        override(defaultLevel)

    }

    override fun current(): LogLevel = logLevel.value

}

package net.thunderbird.core.logging

/**

 * Manages the log level for the application.

 *

 * This interface provides a way to update the log level dynamically.

 * Implementations of this interface are responsible for persisting the log level

 * and notifying listeners of changes.

 */

interface LogLevelManager : LogLevelProvider {

    /**

     * Overrides the current log level.

     *

     * This function allows for a temporary change in the log level,

     * typically for debugging or specific operational needs.

     * The original log level can be restored by calling [restoreDefault] function

     *

     * @param level The new log level to set

     */

    fun override(level: LogLevel)

    /**

     * Restores the log level to its default value.

     *

     * The default log level is defined by the specific implementation of this interface.

     */

    fun restoreDefault()

}

package net.thunderbird.core.logging

/**

 * Provides the current [LogLevel].

 *

 * This can be used to dynamically change the log level during runtime.

 */

fun interface LogLevelProvider {

    /**

     * Gets the current log level.

     *

     * @return The current log level.

     */

    fun current(): LogLevel

}

package net.thunderbird.core.logging.testing

import net.thunderbird.core.logging.LogLevel

import net.thunderbird.core.logging.LogLevelManager

class TestLogLevelManager : LogLevelManager {

    var logLevel = LogLevel.VERBOSE

    override fun override(level: LogLevel) {

        logLevel = level

    }

    override fun restoreDefault() {

        logLevel = LogLevel.VERBOSE

    }

    override fun current(): LogLevel = logLevel

}