MicroUtils/startup/launcher/src/commonMain/kotlin/StartLauncherPlugin.kt

142 lines
5.0 KiB
Kotlin
Raw Normal View History

2022-12-05 16:31:15 +00:00
package dev.inmo.micro_utils.startup.launcher
import dev.inmo.kslog.common.i
import dev.inmo.kslog.common.taggedLogger
import dev.inmo.kslog.common.w
import dev.inmo.micro_utils.coroutines.runCatchingSafely
2022-12-25 04:26:44 +00:00
import dev.inmo.micro_utils.startup.launcher.StartLauncherPlugin.setupDI
import dev.inmo.micro_utils.startup.launcher.StartLauncherPlugin.startPlugin
2022-12-06 07:06:21 +00:00
import dev.inmo.micro_utils.startup.plugin.StartPlugin
2022-12-05 16:31:15 +00:00
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.joinAll
import kotlinx.coroutines.launch
2022-12-06 07:06:21 +00:00
import kotlinx.serialization.SerialFormat
import kotlinx.serialization.StringFormat
2022-12-05 16:31:15 +00:00
import kotlinx.serialization.json.JsonObject
2022-12-25 04:26:44 +00:00
import kotlinx.serialization.json.jsonObject
2022-12-05 16:31:15 +00:00
import org.koin.core.Koin
2022-12-25 04:26:44 +00:00
import org.koin.core.KoinApplication
import org.koin.core.context.startKoin
2022-12-05 16:31:15 +00:00
import org.koin.core.module.Module
2022-12-06 07:06:21 +00:00
import org.koin.dsl.binds
2022-12-05 16:31:15 +00:00
import org.koin.dsl.module
2022-12-06 07:06:21 +00:00
/**
* Default startup plugin. See [setupDI] and [startPlugin] for more info
*/
object StartLauncherPlugin : StartPlugin {
2022-12-05 16:31:15 +00:00
internal val logger = taggedLogger(this)
2022-12-06 07:06:21 +00:00
2022-12-25 04:26:44 +00:00
fun Module.setupDI(config: Config, rawJsonObject: JsonObject? = null) {
val rawJsonObject = rawJsonObject ?: defaultJson.encodeToJsonElement(Config.serializer(), config).jsonObject
2022-12-05 16:31:15 +00:00
2022-12-25 04:26:44 +00:00
single { rawJsonObject }
single { config }
2022-12-05 16:31:15 +00:00
single { CoroutineScope(Dispatchers.Default) }
2022-12-06 07:06:21 +00:00
single { defaultJson } binds arrayOf(StringFormat::class, SerialFormat::class)
2022-12-05 16:31:15 +00:00
includes(
2022-12-25 04:26:44 +00:00
config.plugins.mapNotNull {
2022-12-05 16:31:15 +00:00
runCatching {
module {
with(it) {
2022-12-25 04:26:44 +00:00
setupDI(rawJsonObject)
2022-12-05 16:31:15 +00:00
}
}
}.onFailure { e ->
logger.w("Unable to load DI part of $it", e)
}.getOrNull()
}
)
}
2022-12-25 04:26:44 +00:00
/**
* Will deserialize [Config] from [config], register it in receiver [Module] (as well as [CoroutineScope] and
* [kotlinx.serialization.json.Json])
*
* Besides, in this method will be called [StartPlugin.setupDI] on each plugin from [Config.plugins]. In case when
* some plugin will not be loaded correctly it will be reported throw the [logger]
*/
override fun Module.setupDI(config: JsonObject) {
logger.i("Koin for current module has started setup")
setupDI(
defaultJson.decodeFromJsonElement(Config.serializer(), config),
config
)
logger.i("Koin for current module has been setup")
}
2022-12-06 07:06:21 +00:00
/**
* Takes [CoroutineScope] and [Config] from the [koin], and call starting of each plugin from [Config.plugins]
* ASYNCHRONOUSLY. Just like in [setupDI], in case of fail in some plugin it will be reported using [logger]
*/
2022-12-05 16:31:15 +00:00
override suspend fun startPlugin(koin: Koin) {
2022-12-25 04:26:44 +00:00
logger.i("Start starting of subplugins")
2022-12-05 16:31:15 +00:00
val scope = koin.get<CoroutineScope>()
koin.get<Config>().plugins.map { plugin ->
scope.launch {
runCatchingSafely {
logger.i("Start loading of $plugin")
with(plugin) {
startPlugin(koin)
}
}.onFailure { e ->
2022-12-25 04:29:16 +00:00
logger.w("Unable to start plugin $plugin", e)
2022-12-05 16:31:15 +00:00
}.onSuccess {
logger.i("Complete loading of $plugin")
}
}
}.joinAll()
2022-12-25 04:26:44 +00:00
logger.i("Complete subplugins start")
}
/**
* Will create [KoinApplication], init, load modules using [StartLauncherPlugin] and start plugins using the same base
* plugin
*
* @param rawConfig It is expected that this [JsonObject] will contain serialized [Config] ([StartLauncherPlugin] will
* deserialize it in its [StartLauncherPlugin.setupDI]
*/
suspend fun start(rawConfig: JsonObject) {
logger.i("Start initialization")
val koinApp = KoinApplication.init()
koinApp.modules(
module {
setupDI(rawConfig)
}
)
logger.i("Modules loaded")
startKoin(koinApp)
logger.i("Koin started")
startPlugin(koinApp.koin)
logger.i("App has been setup")
}
/**
* Will create [KoinApplication], init, load modules using [StartLauncherPlugin] and start plugins using the same base
* plugin
*
* @param config In difference with other [start] method here config is already deserialized and this config will
* be converted to [JsonObject] as raw config. That means that all plugins from [config] will receive
* serialized version of [config] in [StartPlugin.setupDI] method
*/
suspend fun start(config: Config) {
logger.i("Start initialization")
val koinApp = KoinApplication.init()
logger.i("Koin app created")
koinApp.modules(
module {
setupDI(config)
}
)
startKoin(koinApp)
logger.i("Koin started")
startPlugin(koinApp.koin)
2022-12-05 16:31:15 +00:00
}
}