- ✅ Type-safe DSL
- 🔗 Multi-platform support (JVM, JS, Native, Wasm)
- 🐥 Zero dependencies
For multiplatform projects:
kotlin {
sourceSets {
commonMain {
dependencies {
implementation("io.konform:konform:0.6.2")
}
}
}
}
For jvm-only projects add:
dependencies {
implementation("io.konform:konform-jvm:0.6.2")
}
Suppose you have a data class like this:
data class UserProfile(
val fullName: String,
val age: Int?
)
Using the Konform type-safe DSL you can quickly write up a validation
val validateUser = Validation<UserProfile> {
UserProfile::fullName {
minLength(2)
maxLength(100)
}
UserProfile::age ifPresent {
minimum(0)
maximum(150)
}
}
and apply it to your data
val invalidUser = UserProfile("A", -1)
val validationResult = validateUser(invalidUser)
since the validation fails the validationResult
will be of type Invalid
and you can get a list of validation errors by indexed access:
validationResult[UserProfile::fullName]
// yields listOf("must have at least 2 characters")
validationResult[UserProfile::age]
// yields listOf("must be at least '0'")
or you can get all validation errors with details as a list:
validationResult.errors
// yields listOf(
// ValidationError(dataPath=.fullName, message=must have at least 2 characters),
// ValidationError(dataPath=.age, message=must be at least '0'
// )
In case the validation went through successfully you get a result of type Valid
with the validated value in the value
field.
val validUser = UserProfile("Alice", 25)
val validationResult = validateUser(validUser)
// yields Valid(UserProfile("Alice", 25))
You can add custom hints to validations
val validateUser = Validation<UserProfile> {
UserProfile::age ifPresent {
minimum(0) hint "Registering before birth is not supported"
}
}
You can use {value}
to include the .toString()
-ed data in the hint
val validateUser = Validation<UserProfile> {
UserProfile::fullName {
minLength(2) hint "'{value}' is too short a name, must be at least 2 characters long."
}
}
You can add custom validations by using addConstraint
val validateUser = Validation<UserProfile> {
UserProfile::fullName {
addConstraint("Name cannot contain a tab") { !it.contains("\t") }
}
}
You can define validations for nested classes and use them for new validations
val ageCheck = Validation<UserProfile> {
UserProfile::age required {
minimum(18)
}
}
val validateUser = Validation<UserProfile> {
UserProfile::fullName {
minLength(2)
maxLength(100)
}
run(ageCheck)
}
It is also possible to validate nested data classes and properties that are collections (List, Map, etc...)
data class Person(val name: String, val email: String?, val age: Int)
data class Event(
val organizer: Person,
val attendees: List<Person>,
val ticketPrices: Map<String, Double?>
)
val validateEvent = Validation<Event> {
Event::organizer {
// even though the email is nullable you can force it to be set in the validation
Person::email required {
pattern(".+@bigcorp.com") hint "Organizers must have a BigCorp email address"
}
}
// validation on the attendees list
Event::attendees {
maxItems(100)
}
// validation on individual attendees
Event::attendees onEach {
Person::name {
minLength(2)
}
Person::age {
minimum(18) hint "Attendees must be 18 years or older"
}
// Email is optional but if it is set it must be valid
Person::email ifPresent {
pattern(".+@.+\..+") hint "Please provide a valid email address (optional)"
}
}
// validation on the ticketPrices Map as a whole
Event::ticketPrices {
minItems(1) hint "Provide at least one ticket price"
}
// validations for the individual entries
Event::ticketPrices onEach {
// Tickets may be free in which case they are null
Entry<String, Double?>::value ifPresent {
minimum(0.01)
}
}
}
Errors in the ValidationResult
can also be accessed using the index access method. In case of Iterables
and Arrays
you use the
numerical index and in case of Maps
you use the key as string.
// get the error messages for the first attendees age if any
result[Event::attendees, 0, Person::age]
// get the error messages for the free ticket if any
result[Event::ticketPrices, "free"]
- Valikator: https://github.com/valiktor/valiktor
- Kalidation: https://github.com/rcapraro/kalidation
- Kotest provides various matchers for use with Konform. They can be used in your tests to assert that a given object is validated successfully or fails validation with specific error messages. See documentation.
David Hoepelman (Current maintainer) Niklas Lochschmidt (Original author, co-maintainer)