Bug: 319324325

Clone this repo:
  1. 2b62775 Migrate 25 crates to monorepo. am: 9eb689a027 by James Farrell · 3 months ago main
  2. 9eb689a Migrate 25 crates to monorepo. by James Farrell · 3 months ago
  3. b801fef Update Android.bp by running cargo_embargo am: 7a8bb42174 by James Farrell · 4 months ago
  4. 7a8bb42 Update Android.bp by running cargo_embargo by James Farrell · 4 months ago
  5. 5de1301 Update module with host_cross_supported am: 4a67146bd0 by Ivan Lozano · 5 months ago

Strum

Build Status Build status Latest Version Rust Documentation Crates.io Crates.io

Strum is a set of macros and traits for working with enums and strings easier in Rust.

Compatibility

Strum is currently compatible with versions of rustc >= 1.56.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.

Including Strum in Your Project

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.25"
strum_macros = "0.25"

# You can also use the "derive" feature, and import the macros directly from "strum"
# strum = { version = "0.25", features = ["derive"] }

Strum Macros

Strum has implemented the following macros:

MacroDescription
EnumStringConverts strings to enum variants based on their name.
DisplayConverts enum variants to strings
FromReprConvert from an integer to an enum.
AsRefStrImplement AsRef<str> for MyEnum
IntoStaticStrImplements From<MyEnum> for &'static str on an enum
EnumVariantNamesAdds an associated VARIANTS constant which is an array of discriminant names
EnumIterCreates a new type that iterates of the variants of an enum.
EnumPropertyAdd custom properties to enum variants.
EnumMessageAdd a verbose message to an enum variant.
EnumDiscriminantsGenerate a new type with only the discriminant names.
EnumCountAdd a constant usize equal to the number of variants.

Contributing

Thanks for your interest in contributing. 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.

Debugging

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.

Name

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.