yacla-core/net.ririfa.yacla/Yacla/loader

loader

inline fun <T : Any> loader(): ConfigLoaderBuilder<T>

Creates a configuration loader for the specified type using Kotlin's reified generics.

Example (Kotlin - Method Chain):

val loader: ConfigLoader<AppConfig> = Yacla.loader<AppConfig>()
    .fromResource("/defaults/config.yml")
    .toFile(Paths.get("config.yml"))
    .parser(YamlParser())
    .autoUpdateIfOutdated(true)
    .withLogger(SLF4JYaclaLogger)
    .load()

val config: AppConfig = loader.config

Return

a ConfigLoaderBuilder for type T.

inline fun <T : Any> loader(noinline builder: ConfigLoaderBuilder<T>.() -> Unit): ConfigLoaderBuilder<T>

Creates and configures a loader in a Kotlin DSL block.

@JvmStatic

fun <T : Any> loader(clazz: Class<T>): ConfigLoaderBuilder<T>

Creates a configuration loader for the specified class.

Example (Java):

ConfigLoader<AppConfig> loader = Yacla.loader(AppConfig.class)
    .fromResource("/defaults/config.yml")
    .toFile(Paths.get("config.yml"))
    .parser(new YamlParser())
    .autoUpdateIfOutdated(true)
    .load();

AppConfig config = loader.getConfig();

Return

a ConfigLoaderBuilder for type T.

Parameters

clazz

the target class of the configuration data.

@JvmStatic

fun <T : Any> loader(clazz: Class<T>, builder: ConfigLoaderBuilder<T>.() -> Unit): ConfigLoaderBuilder<T>

Creates and configures a loader in a DSL-style block.

Example (Kotlin DSL):

val loader = Yacla.loader<AppConfig> {
    fromResource("/defaults/config.yml")
    toFile(Paths.get("config.yml"))
    parser(YamlParser())
    autoUpdateIfOutdated(true)
}.load()

val config: AppConfig = loader.config

Return

the configured ConfigLoaderBuilder.

Parameters

clazz

the target class of the configuration data.

builder

lambda to customize the ConfigLoaderBuilder.

inline fun <T : Any> LoaderScope.loader(noinline block: ConfigLoaderBuilder<T>.() -> Unit): ConfigLoader<T>

Creates a config loader for the specified class within a LoaderScope, applying shared defaults.

This extension is meant for use within Yacla.withDefaults DSL blocks.

Example:

val loader = loader<MyConfig> {
    fromResource("/defaults/my.yml")
    toFile(Paths.get("config/my.yml"))
}

Return

the loaded ConfigLoader for the specified type T

Parameters

block

configuration lambda for customizing the ConfigLoaderBuilder