blob: 524929306a5a817f8c3579e62ad7b398fc74de34 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
|
/*
* Copyright 2014-2023 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license.
*/
package org.jetbrains.dokka.utilities
import java.util.concurrent.atomic.AtomicInteger
interface DokkaLogger {
var warningsCount: Int
var errorsCount: Int
fun debug(message: String)
fun info(message: String)
fun progress(message: String)
fun warn(message: String)
fun error(message: String)
}
fun DokkaLogger.report() {
if (warningsCount > 0 || errorsCount > 0) {
info(
"Generation completed with $warningsCount warning" +
(if (warningsCount == 1) "" else "s") +
" and $errorsCount error" +
if (errorsCount == 1) "" else "s"
)
} else {
info("Generation completed successfully")
}
}
enum class LoggingLevel(val index: Int) {
DEBUG(0), PROGRESS(1), INFO(2), WARN(3), ERROR(4);
}
/**
* Used to decouple the transport layer from logger and make it convenient for testing
*/
fun interface MessageEmitter : (String) -> Unit {
companion object {
val consoleEmitter: MessageEmitter = MessageEmitter { message -> println(message) }
}
}
class DokkaConsoleLogger(
private val minLevel: LoggingLevel = LoggingLevel.PROGRESS,
private val emitter: MessageEmitter = MessageEmitter.consoleEmitter
) : DokkaLogger {
private val warningsCounter = AtomicInteger()
private val errorsCounter = AtomicInteger()
override var warningsCount: Int
get() = warningsCounter.get()
set(value) = warningsCounter.set(value)
override var errorsCount: Int
get() = errorsCounter.get()
set(value) = errorsCounter.set(value)
override fun debug(message: String) {
if (shouldBeDisplayed(LoggingLevel.DEBUG)) emitter(message)
}
override fun progress(message: String) {
if (shouldBeDisplayed(LoggingLevel.PROGRESS)) emitter("PROGRESS: $message")
}
override fun info(message: String) {
if (shouldBeDisplayed(LoggingLevel.INFO)) emitter(message)
}
override fun warn(message: String) {
if (shouldBeDisplayed(LoggingLevel.WARN)) {
emitter("WARN: $message")
}
warningsCounter.incrementAndGet()
}
override fun error(message: String) {
if (shouldBeDisplayed(LoggingLevel.ERROR)) {
emitter("ERROR: $message")
}
errorsCounter.incrementAndGet()
}
private fun shouldBeDisplayed(messageLevel: LoggingLevel): Boolean = messageLevel.index >= minLevel.index
}
|