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
88
89
90
91
92
93
94
95
96
97
98
99
|
@file:Suppress("NOTHING_TO_INLINE")
package ca.allanwang.kau.logging
import android.os.Looper
import android.util.Log
/**
* Created by Allan Wang on 2017-05-28.
*
* Base logger class with a predefined tag
* This may be extended by an object to effectively replace [Log]
* Only direct lazy logging is supported, as for best results,
* applications should extend this and use const/final flags to decide whether logging occurs
* That way, it will be stripped away by proguard
*
* Generally speaking, verbose log may contain private information,
* as it should be stripped away from production build
*
* Debug and info logs may contain sensitive info, and may be differentiated by creating a method such as
* inline fun _d(message: () -> Any?) {
* if (BuildConfig.DEBUG) d(message)
* }
*/
open class KauLogger(val tag: String) {
/**
* Global toggle to enable the whole logger
*/
open var enabled = true
inline fun v(message: () -> Any?) = log(Log.VERBOSE, message)
inline fun i(message: () -> Any?) = log(Log.INFO, message)
inline fun d(message: () -> Any?) = log(Log.DEBUG, message)
inline fun e(t: Throwable? = null, message: () -> Any?) = log(Log.ERROR, message, t)
inline fun eThrow(message: Any) = with(message.toString()) {
log(Log.ERROR, { this }, Throwable(this))
}
inline fun log(priority: Int, message: () -> Any?, t: Throwable? = null) {
if (enabled)
logImpl(priority, message()?.toString() ?: "null", t)
}
open fun logImpl(priority: Int, message: String, t: Throwable?) {
if (t != null)
Log.e(tag, message, t)
else
Log.println(priority, tag, message)
}
/**
* Log the looper
*/
inline fun checkThread(id: Int) {
d {
val name = Thread.currentThread().name
val status = if (Looper.myLooper() == Looper.getMainLooper()) "is" else "is not"
"$id $status in the main thread - thread name: $name"
}
}
fun extend(tag: String) = KauLoggerExtension(tag, this)
}
/**
* Tag extender for [KauLogger]
* Will prepend [tag] to any expected log output by [logger]
* Note that if the parent logger is disabled, the extension logger will not output anything either
*/
class KauLoggerExtension(val tag: String, val logger: KauLogger) {
inline fun v(message: () -> Any?) = log(Log.VERBOSE, message)
inline fun i(message: () -> Any?) = log(Log.INFO, message)
inline fun d(message: () -> Any?) = log(Log.DEBUG, message)
inline fun e(t: Throwable? = null, message: () -> Any?) = log(Log.ERROR, message, t)
inline fun eThrow(message: Any) = with(message.toString()) {
log(Log.ERROR, { this }, Throwable(this))
}
inline fun log(priority: Int, message: () -> Any?, t: Throwable? = null) =
logger.log(priority, { "$tag: ${message()?.toString() ?: "null"}" }, t)
inline fun checkThread(id: Int) {
d {
val name = Thread.currentThread().name
val status = if (Looper.myLooper() == Looper.getMainLooper()) "is" else "is not"
"$id $status in the main thread - thread name: $name"
}
}
}
|