Purpose

This project provides ad-hoc enum types, and traits for user-defined enum exchange.

An enum can be exchanged into another enum if all variants in the formmer are in the latter.

Type and API Naming

Ad-hoc enums composed of x variants are named as Enum1, Enum2, ... etc.

Variants are named as _0, _1, ... etc.

User-defined enums are normal Rust enums using any readable enum names or variant names, with Exchange derived using #[derive(Exchang)].

An enum can be constructed from_variant(), while a variant can be converted into_enum().

An ad-hoc enum can be converted from another one using from_enumx(), while one can be coverted into another one using into_enumx().

A user-defined Exchange enum can be converted From/Into its associated Exchange::EnumX type, which is an ad-hoc enum.

A user-defined Exchange enum can be exchange_from() another user-defined Exchange enum, while one can be exchange_into() another.

Examples

See test code.

Limitation

Current version supports up to 16 variants by default, and extended to 32 variants with enum32 feature. In otherwords, Enum1..=Enum16 is available but Enum17 and the succeeding enums are not, by default. With enum32 feature, Enum32 is available but Enum33 and the succeeding enums are not. But notice that it may cost several minutes to compile this crate with enum32 feature.

License

Licensed under MIT.

Acknowledgement