Popularity
1.2
Growing
Activity
7.7
-
13
2
2

Programming language: Kotlin
Tags: Misc    
Latest version: v1.2.2

log4k alternatives and similar libraries

Based on the "Misc" category.
Alternatively, view log4k alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of log4k or a related project?

Add another 'Misc' Library

README

Log4K

Build Status Maven Central Kotlin Version GitHub license

badge-android badge-ios badge-js badge-jvm

Lightweight logging library for Kotlin/Multiplatform. Supports Android, iOS, JavaScript and plain JVM environments.

  • log4k: Base library, provides infrastructure and console logging
  • log4k-slf4j: Integration with SLF4J

Download

Artifacts are published to Maven Central:

repositories {
    mavenCentral()
}

dependencies {
    implementation("de.peilicke.sascha:log4k:1.2.2")
}

Usage

Logging messages is straightforward, the Log object provides the usual functions you'd expect:

// Log to your heart's content
Log.verbose("FYI")
Log.debug("Debugging ${foo.bar}")
Log.info("Nice to know", tag = "SomeClass")
Log.warn("Warning about $stuff ...")
Log.error("Oops!")
Log.assert("Something went wrong!", throwable)

or, if you prefer:

Log.verbose { "FYI" }
Log.debug { "Debugging ${foo.bar}" }
Log.info(tag = "SomeClass") { "Nice to know" }
Log.warn { "Warning about $stuff ..." }
Log.error { "Oops!" }
Log.assert(throwable = Exception("Ouch!")) { "Something went wrong!" }

The log output includes the function name and line and pretty-prints exceptions on all supported platforms:

I/Application.onCreate: Log4K rocks!

Logging objects

In case you want to log Any Kotlin class instance or object:

val map = mapOf("Hello" to "World")
map.logged()

The above example logs {Hello=World} with the tag SingletonMap with the log level Debug.

Logging expensive results

Sometimes, the log output involves a heavy computation that is not always necessary. For example, if the global log level is set to Info or above, the following text would not appear in any log output:

Log.debug("Some ${veryHeavyStuff()}")

However, the function veryHeavyStuff() will be executed regardless. To avoid this, use:

Log.debug { "Some ${veryHeavyStuff()}" }

Configuration (Android example)

To only output messages with log-level info and above, you can configure the console logger in your Application class:

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        Log.loggers.forEach {
            if (!BuildConfig.DEBUG) {
                it.minimumLogLevel = Log.Level.Info
            }
        }
    }
}

Custom logger (Android Crashlytics example)

The library provides a cross-platform ConsoleLogger by default. Custom loggers can easily be added. For instance, to send only ERROR and ASSERT messages to Crashlytics in production builds, you could do the following:

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        Log.loggers.clear() // Remove default loggers
        Log.loggers += when {
            BuildConfig.DEBUG -> ConsoleLogger()
            else -> CrashlyticsLogger()
        }
    }

    private class CrashlyticsLogger : Logger() {
        override fun print(level: Log.Level, tag: String, message: String?, throwable: Throwable?) {
            val priority = when (level) {
                Log.Level.Verbose -> VERBOSE
                Log.Level.Debug -> DEBUG
                Log.Level.Info -> INFO
                Log.Level.Warning -> WARN
                Log.Level.Error -> ERROR
                Log.Level.Assert -> ASSERT
            }
            if (priority >= ERROR) {
                FirebaseCrashlytics.getInstance().log("$priority $tag $message")
                throwable?.let { FirebaseCrashlytics.getInstance().recordException(it) }
            }
        }
    }
}

Users

License

Copyright 2019 Sascha Peilicke

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.


*Note that all licence references and agreements mentioned in the log4k README section above are relevant to that project's source code only.