Issue #499 - improve Kotlin/JS logger

[scrat98]

Closes #499

[oshai]

The problem with JS IIRC was that there is nodejs and browser that works completely different in the sense of obtaining logger name (maybe there was another use case I don't remember right now).

So the question is how do we test it to make sure we improved both cases.

Also if you can provide more details on the change it will be helpful to review.

[oshai]

I am referring: #279 (comment)

[scrat98]

@oshai

So the question is how do we test it to make sure we improved both cases.

Every use case is covered by test for both JS and WASM. Please, have a look at the SimpleJsTest and SimpleWasmTest headers, there you'll find all use cases that were tested.

val topLevelNamedLogger = KotlinLogging.logger("topLevelNamedLogger")
val topLevelLambdaLogger = KotlinLogging.logger {}

class MyClass {
  val classNamedLogger = KotlinLogging.logger("MyClass")
  val classLambdaLogger = KotlinLogging.logger {}

  // check with non default "Companion" name also
  companion object MyCompanion {
    val companionNamedLogger = KotlinLogging.logger("MyClassCompanion")
    val companionLambdaLogger = KotlinLogging.logger {}
  }
}

You may run these tests with current (master) implementation and find out the tests failure.

Also if you can provide more details on the change it will be helpful to review.

Logger name for both JS and WASM is derived via stack trace analysis to cover all use cases. Currently this is the only way to properly obtain class name for all use cases. Analysis looks like:

1. Find logger invocation line (LOGGER_FUNCTION_NAME). For JS @JSName was added
2. Try to resolve it as a top level property (TOP_LEVEL_INIT_PROPERTIES_REGEX)
3. Try to resolve it as class level property (CLASS_LEVEL_INIT_PROPERTIES_REGEX). Also taking in the consideration Companion object (COMPANION_GET_INSTANCE_SUFFIX)
4. Fallback to the DEFAULT_LOGGER_NAME

Also you can find description here #499

[oshai]

can you change this to an explicit string param with logger name, so it will be clear what was the name?

[scrat98]

It's checking via checkLoggerName(logger: KLogger, expected: String)