yacla-core/net.ririfa.yacla/Yacla

Yacla

Yacla - Yet Another Config Loading API

Entry point to create and configure loaders that map configuration files into Kotlin or Java objects, with support for validation, logging, and auto-update.

Fields are mapped by annotation and Kotlin default values — no schema required.

Functions

fillByDefault

@JvmStatic

inline fun <T : Any> fillByDefault(): T

Creates a new config instance using only Kotlin primary constructor default values.

@JvmStatic

fun <T : Any> fillByDefault(clazz: Class<T>): T

Java-friendly overload of fillByDefault.

loader

@JvmStatic

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

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

@JvmStatic

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

Creates a configuration loader for the specified class.

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.

@JvmStatic

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

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

withDefaults

@JvmStatic

fun <R> withDefaults(settings: LoaderSettings, block: Function<JLoaderScope, R>): R

Creates a functional scope for defining multiple loaders with common defaults, for use in Java.

@JvmStatic

fun <R> withDefaults(settings: LoaderSettings, block: LoaderScope.() -> R): R

Creates a DSL scope that applies the provided default settings to all loaders defined inside.