#enums #variant #cast #encapsulation #macro-derive

enumcapsulate

Safe casting for newtype enums and their variants

6 releases (breaking)

0.5.0 Dec 1, 2024
0.4.0 Nov 18, 2024
0.3.0 May 24, 2024
0.2.2 May 23, 2024
0.1.0 Jan 22, 2024

#683 in Rust patterns

Download history 3/week @ 2024-09-22 18/week @ 2024-10-06 5/week @ 2024-10-13 170/week @ 2024-11-17 21/week @ 2024-11-24 178/week @ 2024-12-01

369 downloads per month

MPL-2.0 license

27KB
73 lines

enumcapsulate

Crates.io Crates.io Crates.io docs.rs

Safe casting for newtype enums and their variants.


Traits

The enumcapsulate crate exports the following traits:

Traits Functionality
Encapsulate Umbrella derive macro for AsVariant, AsVariantMut, AsVariantRef, From, FromVariant, IntoVariant, TryInto, and VariantDowncast.
FromVariant Creates an instance of Self from the unambiguous field type of one of its variants.
IntoVariant Returns the current variant's field, consuming self.
AsVariant Provides owned access to the current variant's field.
AsVariantMut Provides mutable borrowed access to the current variant's field.
AsVariantRef Provides borrowed access to the current variant's field.
VariantDowncast Convenience umbrella trait utilizing AsVariant, AsVariantRef, AsVariantMut, and IntoVariant.
VariantDiscriminant Used to obtain an enum variant's discriminant.

Derive macros

The enumcapsulate crate exports the following corresponding derive macros, if the "derive" feature is enabled (which is the default):

  • Encapsulate
  • From
  • TryInto
  • FromVariant
  • IntoVariant
  • AsVariant
  • AsVariantMut
  • AsVariantRef
  • VariantDowncast
  • VariantDiscriminant

Documentation

Please refer to the documentation on docs.rs.

Contributing

Please read CONTRIBUTING.md for details on our code of conduct,
and the process for submitting pull requests to us.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

License

This project is licensed under the MPL-2.0 – see the LICENSE.md file for details.

Dependencies

~100KB