sklog - simple Kotlin logging
Kotlin (JVM) logging library for printing colorized text to the console, with an easy upgrade path to the popular kotlin-logging library
Rationale
Logging is a necessary part of most projects, but setting it up can be a chore.
Java has several popular logging frameworks, as well as the built-in java.util.logging, but all come with their own issues.
For Kotlin, the kotlin-logging library has become relatively popular, but it's not a standalone logger. Instead, it acts as a wrapper around SLF4J, which is itself a logging "facade" (i.e., frontend), meaning that it requires a separate backend/implementation to work.
As a result, even if all you want to do is print log output to the console (System.err), you'll need to pull in three separate dependencies: kotlin-logging, SLF4J, and SLF4J's Simple implementation. That can be a lot, especially for smaller projects with relatively simple logging needs.
It can also be difficult to figure out how to configure these libraries, for example if you want to change the log level so that you actually see debug messages.
This library exists to make it easy to start logging, without worrying about dependencies and complex configuration.
Features
- No dependencies, other than the Kotlin language and the Java standard library
- The entire library is one file, which you can copy directly into your project!
- Messages are printed to
System.err - Output includes timestamp and the name of the class where the logger was declared
- Possible to set custom logger names
- Output colorized based on log level
- But this can be disabled
- Log level can be customized
- No other customizations are available in this library
- But it's really easy to upgrade to a more full-featured solution, the kotlin-logging library! (see below)
Example & usage
This screenshot was generated by the following program:
import sklog.KotlinLogging
import sklog.LogLevel
private val logger = KotlinLogging.logger {}
fun main() {
// The default log level is DEBUG,
// but it can be set to TRACE globally or on a per-logger basis
logger.logLevel = LogLevel.TRACE
println("Welcome! This is a test run of sklog, the simple kotlin logging library.")
println("Each of the following lines is logger output.")
logger.trace { "Trace" }
logger.debug { "Debug" }
logger.info { "Info" }
logger.warning("Warning")
logger.error("Error")
}
Using this library
This library is made available via JitPack. Here's how you can add it to your project:
Gradle (build.gradle.kts)
repositories {
maven {
url = uri("https://jitpack.io")
}
}
dependencies {
implementation("com.github.nmalkin:sklog:0.0.1")
}
Gradle (build.gradle)
repositories {
maven {
url 'https://jitpack.io'
}
}
dependencies {
implementation 'com.github.nmalkin:sklog:0.0.1'
}
Maven
<repositories>
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
</repositories>
<dependency>
<groupId>com.github.nmalkin</groupId>
<artifactId>sklog</artifactId>
<version>0.0.1</version>
</dependency>
Upgrade path
If you start using this library and realize you need more features, upgrading to the kotlin-logging library should be very easy! This library's API was based on kotlin-logging and designed to be compatible. In particular:
- Loggers are declared the same way
private val logger = KotlinLogging.logger {}
- Messages can be logged as lambdas (so they don't get evaluated if the log level is disabled)
logger.debug { "Some $expensive message!" }
Because of this, upgrading to kotlin-logging might be as simple as swapping our your imports:
< import sklog.KotlinLogging
---
> import mu.KotlinLogging
6 Aug 26, 2022
13.5k Dec 30, 2022
3 Oct 24, 2021
457 Jan 7, 2023
49 Aug 22, 2022
4 Jan 19, 2022
13 Aug 29, 2022
51 Dec 20, 2022
418 Nov 25, 2022
2 Aug 29, 2022
675 Nov 14, 2022
373 Jan 1, 2023
40 Dec 14, 2022
5 Mar 6, 2022
1 Feb 8, 2022
1 Feb 8, 2022
12 Aug 23, 2022
9 Oct 21, 2022
187 Dec 18, 2022
675 Nov 14, 2022
1 Feb 8, 2022
12 Aug 23, 2022
187 Dec 18, 2022
395 Jan 4, 2023
849 Dec 23, 2022
1 Dec 13, 2021
7.9k Dec 31, 2022
1.1k Jan 5, 2023
121 Dec 26, 2022