✨ New NotBlankString type in org.kotools.types package

[LVMVRQUXL]

📝 Description

We want to introduce a NotBlankString experimental type, in the org.kotools.types package of the types Gradle subproject, for representing a string that has at least one character excluding whitespaces. This type should be serializable as String.

This type should have the following Application Programming Interface (API):

interface NotBlankString : Comparable<NotBlankString> {
    val length: PositiveInt
    
    override fun equals(other: Any?): Boolean
    override fun hashCode(): Int
    
    override fun compareTo(other: NotBlankString): Int
    
    operator fun plus(other: Any): NotBlankString
    
    override fun toString(): String
    
    companion object {
        fun fromString(value: Any): NotBlankString
        fun fromStringOrNull(value: Any): NotBlankString?
        
        fun random(): NotBlankString = TODO()
        fun random(length: PositiveInt): NotBlankString = TODO()
    }
}

🔗 Dependencies

This issue is blocked by the following ones:

• ✨ New PositiveInt type in org.kotools.types package #637

✅ Checklist

• ✨ Add the type with a private constructor and dump the Application Binary Interface (ABI).
• ✨ Add the fromStringOrNull(Any) function with tests, tested code samples for Kotlin and Java code, and dump the ABI.
• ✨ Add the fromString(Any) function with tests, tested code samples for Kotlin and Java code, and dump the ABI.
• ✨ Add the random() function with tests, tested code samples for Kotlin and Java code, and dump the ABI.
• ✨ Add the random(PositiveInt) function with tests, tested code samples for Kotlin and Java code, and dump the ABI.
• ✨ Add the length property with tests, tested code samples for Kotlin and Java code, and dump the ABI.
• ✨ Add the structural equality operations (equals(Any?) and hashCode() functions) with tests, tested code samples for Kotlin and Java code, and dump the ABI.
• ✨ Implement the Comparable interface with tests, tested code samples for Kotlin and Java code, and dump the ABI.
• ✨ Add the plus(Any) function with tests, tested code samples for Kotlin and Java code, and dump the ABI.
• ✨ Add the toString() function with tests, tested code samples for Kotlin and Java code, and dump the ABI.
• ✨ Make the type serializable as String with tests, tested code samples for Kotlin, and dump the ABI.
• 📝 Add an entry for this issue in the unreleased changelog.