Augments enums with string conversions, parsing from integers, iteration, variant metadata and messages, discriminants, variant arrays/names, and compile-time generated utilities with optional debug dumps.
This is a Kotlin Multiplatform line-by-line transliteration port of Peternator7/strum.
Original Project: This port is based on Peternator7/strum. All design credit and project intent belong to the upstream authors; this repository is a faithful port to Kotlin Multiplatform with no behavioural changes intended.
This is an in-progress port. The goal is feature parity with the upstream Rust crate while providing a native Kotlin Multiplatform API. Every Kotlin file carries a // port-lint: source <path> header naming its upstream Rust counterpart so the AST-distance tool can track provenance.
Peternator7/strumThe text below is reproduced and lightly edited from
https://github.com/Peternator7/strum. It is the upstream project's own description and remains under the upstream authors' authorship; links have been rewritten to absolute upstream URLs so they continue to resolve from this repository.
Strum is a set of macros and traits for working with enums and strings easier in Rust.
Strum is currently compatible with versions of rustc >= 1.71.1. Pull Requests that improve compatibility with older versions are welcome. The project goal is to support a rust version for at least 2 years after release and even longer is preferred since this project changes slowly.
Import strum and strum_macros into your project by adding the following lines to your Cargo.toml. Strum_macros contains the macros needed to derive all the traits in Strum.
[dependencies]
strum = "0.28"
strum_macros = "0.28"
# You can also use the "derive" feature, and import the macros directly from "strum"
# strum = { version = "0.28", features = ["derive"] }
Strum has implemented the following macros:
Thanks for your interest in contributing. Bug fixes are always welcome. If you are interested in implementing or adding a macro, please open an issue first to discuss the feature. I have limited bandwidth to review new features.
The project is divided into 3 parts, the traits are in the
/strum folder. The procedural macros are in the /strum_macros folder, and the integration tests are
in /strum_tests. If you are adding additional features to strum or strum_macros, you should make sure
to run the tests and add new integration tests to make sure the features work as expected.
To see the generated code, set the STRUM_DEBUG environment variable before compiling your code.
STRUM_DEBUG=1 will dump all of the generated code for every type. STRUM_DEBUG=YourType will
only dump the code generated on a type named YourType.
Strum is short for STRing enUM because it's a library for augmenting enums with additional information through strings.
Strumming is also a very whimsical motion, much like writing Rust code.
dependencies {
implementation("io.github.kotlinmania:strum-macros-kotlin:0.2.0")
}
./gradlew build
./gradlew test
See AGENTS.md and CLAUDE.md for translator discipline, port-lint header convention, and Rust → Kotlin idiom mapping.
This Kotlin port is distributed under the same MIT license as the upstream Peternator7/strum. See LICENSE (and any sibling LICENSE-* / NOTICE files mirrored from upstream) for the full text.
Original work copyrighted by the strum authors.
Kotlin port: Copyright (c) 2026 Sydney Renee and The Solace Project.
Thanks to the Peternator7/strum maintainers and contributors for the original Rust implementation. This port reproduces their work in Kotlin Multiplatform; bug reports about upstream design or behavior should go to the upstream repository.
| Macro | Description |
|---|
| EnumString | Converts strings to enum variants based on their name. |
| Display | Converts enum variants to strings |
| FromRepr | Convert from an integer to an enum. |
| AsRefStr | Implement AsRef<str> for MyEnum |
| IntoStaticStr | Implements From<MyEnum> for &'static str on an enum |
| EnumIter | Creates a new type that iterates of the variants of an enum. |
| EnumProperty | Add custom properties to enum variants. |
| EnumMessage | Add a verbose message to an enum variant. |
| EnumDiscriminants | Generate a new type with only the discriminant names. |
| EnumCount | Add a constant usize equal to the number of variants. |
| VariantArray | Adds an associated VARIANTS constant which is an array of all enum discriminants |
| VariantNames | Adds an associated VARIANTS constant which is an array of discriminant names |
Surfaced from shared tags and platforms — no rankings paid for.