Crate strum

Strum

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

The full version of the README can be found on GitHub.

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.26"
strum_macros = "0.26"

# You can also access strum_macros exports directly through strum using the "derive" feature
strum = { version = "0.26", features = ["derive"] }

Modules

• additional_attributes
  Documentation for Additional Attributes

Enums

• ParseError
  The ParseError enum is a collection of all the possible reasons an enum can fail to parse from a string.

Traits

• AsStaticRefDeprecated
  A cheap reference-to-reference conversion. Used to convert a value to a reference value with 'static lifetime within generic code.
• EnumCount
  A trait for capturing the number of variants in Enum. This trait can be autoderived by strum_macros.
• EnumMessage
  Associates additional pieces of information with an Enum. This can be autoimplemented by deriving EnumMessage and annotating your variants with #[strum(message="...")].
• EnumProperty
  EnumProperty is a trait that makes it possible to store additional information with enum variants. This trait is designed to be used with the macro of the same name in the strum_macros crate. Currently, the only string literals are supported in attributes, the other methods will be implemented as additional attribute types become stabilized.
• IntoEnumIterator
  This trait designates that an Enum can be iterated over. It can be auto generated using strum_macros on your behalf.
• VariantArray
  A trait for retrieving a static array containing all the variants in an Enum. This trait can be autoderived by strum_macros. For derived usage, all the variants in the enumerator need to be unit-types, which means you can’t autoderive enums with inner data in one or more variants. Consider using it alongside EnumDiscriminants if you require inner data but still want to have an static array of variants.
• VariantIterator
• VariantMetadata
• VariantNames
  A trait for retrieving the names of each variant in Enum. This trait can be autoderived by strum_macros.

Derive Macros

• AsRefStrderive
  Converts enum variants to &'static str.
• Displayderive
  Converts enum variants to strings.
• EnumCountderive
  Add a constant usize equal to the number of variants.
• EnumDiscriminantsderive
  Generate a new type with only the discriminant names.
• EnumIs
  Generated is_*() methods for each variant. E.g. Color.is_red().
• EnumIterderive
  Creates a new type that iterates of the variants of an enum.
• EnumMessagederive
  Add a verbose message to an enum variant.
• EnumPropertyderive
  Add custom properties to enum variants.
• EnumStringderive
  Converts strings to enum variants based on their name.
• EnumTable
  Creates a new type that maps all the variants of an enum to another generic value.
• EnumTryAs
  Generated try_as_*() methods for all tuple-style variants. E.g. Message.try_as_write().
• FromReprderive
  Add a function to enum that allows accessing variants by its discriminant
• IntoStaticStrderive
  Implements From<MyEnum> for &'static str on an enum.
• VariantArrayderive
  Adds a static array with all of the Enum’s variants.
• VariantNamesderive
  Implements Strum::VariantNames which adds an associated constant VARIANTS which is an array of discriminant names.