Kotlin Kydra Log - Kotlin Multiplatform Library that allows to write logs in common module. The way how logs will written defines for each platform independently.

Fully supported platforms:

• Android and AndroidNative(Arm32, Arm64, X64, X86) using LogCat;
• JavaScript using JS Console;
• Apple based: iOS, MacOS, Watch and TV using OSLog.

Also, not well by using println with timestamp:

• Java;
• Linux based: X64, Arm64;
• Windows X64;

Add common library as dependency in common build.gradle:

repositories {
    mavenCentral()
}
dependencies {
    ...
    implementation 'ru.pocketbyte.kydra:kydra-log:2.2.0'
}

Then you able to use KydraLog in common code:

KydraLog.info { "Info log message" }
KydraLog.debug { "Debug log message" }
KydraLog.warn { "Warning log message" }
KydraLog.error { "Error log message" }

If you would to log formatted string you should use kotlin String Templates:

val count = 1
KydraLog.info { "Count is $count" }

Any logging via not initialized KydraLog will call initialisation with default Logger. But if you want to initialize KydraLog with custom filtering you could use function initDefault(level: LogLevel?, tags: Set<String?>?). For example, on Android platform can be used different LogLevel filtering depending on build type:

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        if (!BuildConfig.DEBUG) {
            // No need to write debug logs in production build
            KydraLog.initDefault(LogLevel.INFO)
        }
    }
}

IMPORTANT NOTE: Initialization can be called only once. Re-initialization will throw IllegalStateException. Any logging via not initialized KydraLog will call initialisation with default Logger.

If you want to implement your own custom logger you should extend abstract class ru.pocketbyte.kydra.log.Logger:

class MyLogger: Logger() {

    override fun doLog(level: LogLevel, tag: String?, message: Any) {
        // Custom logging of message
        ...
    }
}

Also you can use abstract class ru.pocketbyte.kydra.log.AbsLogger. This class splits log function into 2 functions with string and exception as a message parameter.

Then you should init KydraLog with your logger:

KydraLog.init(MyLogger())

To apply filter on your custom logger you could use operator filtered:

// Will loged only error logs with tags "API_CORE" and "API_SOCKET"
KydraLog.init(MyLogger().filtered(LogLevel.ERROR, setOf("API_CORE", "API_SOCKET")))

To utilize several loggers at the same time you could use LoggersSet:

KydraLog.init(
    LoggersSet(
        AndroidLogger(),
        MyLogger().filtered(LogLevel.ERROR, setOf("API_CORE", "API_SOCKET"))
    ).filtered(if(BuildConfig.DEBUG) LogLevel.DEBUG  else LogLevel.INFO)
)

Note: In example above, second filter applies to whole set instead of applying to AndroidLogger only.

You are not forced to use KydraLog object. It was designed to provide Plug & Play functionality. If you wish, you can instantiate Logger as variable and use it for logging. Or you can use Dependency Injection to provide Logger instance. To get default console logger instance you could use DefaultLoggerFactory.create().

To be able to switch on/off logger at any time you could use LoggerToggle wrapper.

val loggerToggle = LoggerToggle(myLogger)

loggerToggle.info { "This log will be shown." }
loggerToggle.enabled = false
loggerToggle.info { "This log will NOT be shown." }

To override log tag or provide default tag you could use withTag or withTagTransform extensions.

// fooLogger uses "Foo" tag as default
val fooLogger = myLogger.withTag("Foo")
fooLogger.info { "Hello Foo" }        // Log will be printed with tag "Foo"
fooLogger.info("Bar") { "Hello Foo" } // Log will be printed with tag "Bar"


// barLogger always uses "Bar" tag
val barLogger = myLogger.withTagTransform { "Bar" }
barLogger.info { "Hello Bar" }        // Log will be printed with tag "Bar"
barLogger.info("Foo") { "Hello Bar" } // Log will be printed with tag "Bar"

Copyright © 2022 Denis Shurygin. All rights reserved.
Contacts: <mail@pocketbyte.ru>

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.