| tag | 79c5d1db68c6df3ed2205d11e4543af9448d6158 | |
|---|---|---|
| tagger | The Android Open Source Project <initial-contribution@android.com> | Wed Nov 06 13:23:39 2024 -0800 |
| object | 2864ea7276b823de75de9cdf328f7a90f9091c30 |
Android 15.0.0 release 4
| commit | 2864ea7276b823de75de9cdf328f7a90f9091c30 | [log] [tgz] |
|---|---|---|
| author | Android Build Coastguard Worker <android-build-coastguard-worker@google.com> | Thu May 23 23:15:18 2024 +0000 |
| committer | Android Build Coastguard Worker <android-build-coastguard-worker@google.com> | Thu May 23 23:15:18 2024 +0000 |
| tree | 1b87eab8e550908f8fbb026aec4ed4d596f307e8 | |
| parent | 7cb9c4381e94ee7ee420e1691352206f76677fea [diff] | |
| parent | 7d76492f9a17eaf8eae46c3cf99ce8c205f9b24e [diff] |
Snap for 11881322 from 7d76492f9a17eaf8eae46c3cf99ce8c205f9b24e to 24Q3-release Change-Id: Id16cdeec9b10bd5ce5d5490952659d8a9dbf27cb
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.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.
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 has implemented the following macros:
| 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 |
| EnumVariantNames | Adds an associated VARIANTS constant which is an array of discriminant names |
| 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. |
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.
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.
