3 unstable releases
0.3.0 | Nov 15, 2023 |
---|---|
0.2.1 | Mar 3, 2021 |
0.2.0 | May 13, 2019 |
#1274 in Procedural macros
2,062 downloads per month
Used in 18 crates
14KB
214 lines
Frunk Enum Support
Usage
These crates augment the frunk crate to
allow transmogrification of enum
s as well as struct
s. For more information
on transmogrification and the LabelledGeneric
trait it's based around, see
https://docs.rs/frunk/latest/frunk/#transmogrifying and
https://docs.rs/frunk/latest/frunk/labelled/trait.LabelledGeneric.html.
To take advantage of this feature for your own enum you need to:
-
Add the
frunk-enum-derive
as a[dev-dependency]
to yourCargo.toml
-
Mark the enum with the custom derive:
#[derive(LabelledGenericEnum)] enum Foo { Bar(String), Baz { name: String, id: Identity }, }
-
Add the
frunk-enum-core
andfrunk-core
crates as[dependency]
entries to yourCargo.toml
-
Then (assuming there's a
NewFoo
enum with the same structure asFoo
) you can write:let foo = Foo::Baz { name: "Andy".into(), id: Identity }; let new_foo: NewFoo = foo.transmogrify();
This works by deriving an implementation of LabelledGeneric
for Foo
which
allows conversion to and from an instance of a generic sum-type. The core
crate provides tools for converting between these generic sum-types where the
bodies of the variants are recursively transmogrifiable. This allows for
arbitrarily deep conversion between types, especially useful where the two
types in question are autogenerated from some common input file, but are deemed
to be different types by the rust compiler (e.g. because they're in separate
crates).
Contributing
Thank you for your interest in frunk-enum, all contributions are welcome whether they be reports of issues, feature requests or code contributions.
Issue Contribution
When opening issues please provide a description of the issue, the version of frunk and frunk-enum plus example code which exhibits the issue.
Code Contribution
If you wish to contribute code to frunk-enum, you are welcome to do so using a github pull request, however you will need to sign each commit, to indicate that you are abiding to the terms of the DCO.
lib.rs
:
This crate adds the LabelledGenericEnum
derive which integrates enums with the frunk
transmogrification function.
Dependencies
~0.9–1.3MB
~28K SLoC