enum-kit

Enhanced enum utilities: safe parsing, display names, and value mapping.

Installation

Gradle (Kotlin DSL)

implementation("com.philiprehberger:enum-kit:0.2.0")

Maven

<dependency>
    <groupId>com.philiprehberger</groupId>
    <artifactId>enum-kit</artifactId>
    <version>0.2.0</version>
</dependency>

Usage

Safe Parsing

import com.philiprehberger.enumkit.*

enum class Color { RED, GREEN, BLUE }

valueOfOrNull<Color>("RED")                    // Color.RED
valueOfOrNull<Color>("invalid")                // null
valueOfOrNull<Color>("red", ignoreCase = true) // Color.RED

Display Names

enum class Status(override val displayName: String) : DisplayEnum {
    PENDING("Pending"), IN_PROGRESS("In Progress");
}

fromDisplayName<Status>("In Progress") // Status.IN_PROGRESS

Value Mapping

enum class Priority(override val value: Int) : ValueEnum<Int> {
    LOW(0), NORMAL(1), HIGH(2);
}

fromValue<Priority, Int>(2) // Priority.HIGH

Membership Checking

enumContains<Color>("RED")                    // true
enumContains<Color>("YELLOW")                 // false
enumContains<Color>("red", ignoreCase = true) // true

Navigation

Color.RED.next()      // Color.GREEN
Color.BLUE.next()     // Color.RED (wraps)
enumNames<Color>()    // ["RED", "GREEN", "BLUE"]

API

Function / Class	Description
valueOfOrNull<T>(name, ignoreCase)	Safe enum parsing, returns null instead of throwing
enumContains<T>(name, ignoreCase)	Check if a name matches any enum constant
enumNames<T>()	List all enum constant names
enumRandom<T>()	Random enum constant
T.next() / T.previous()	Navigate enum constants (wraps around)
DisplayEnum	Interface for human-readable display names
fromDisplayName<T>(name)	Look up by display name
ValueEnum<V>	Interface for custom backing values
fromValue<T, V>(value)	Look up by backing value
enumSetOf(vararg)	Create a Set of enum constants

Development

./gradlew test       # Run tests
./gradlew build      # Build JAR

Support

If you find this project useful:

⭐ Star the repo

🐛 Report issues

💡 Suggest features

❤️ Sponsor development

🌐 All Open Source Projects

💻 GitHub Profile

🔗 LinkedIn Profile

License

MIT