Educe
This crate provides procedural macros to help you implement Rust-build-in traits quickly.
Debug
Use #[derive(Educe)]
and #[educe(Debug)]
to implement the Debug
trait for a struct, an enum, or a union. It supports to change the name of your types, variants and fields. You can also ignore some fields, or set a trait and/or a method to replace the Debug
trait used as default. Also, you can even format a struct to a tuple, and vice versa.
Basic Usage
extern crate educe;
Union
A union will be formatted to a u8
slice, because we don't know it's field at runtime.
extern crate educe;
Change the Name of a Type, a Variant or a Field
The name
attribute can help you rename a type, a variant or a field.
extern crate educe;
Ignore Fields
The ignore
attribute can ignore specific fields.
extern crate educe;
Fake Structs and Tuples
With the named_field
attribute, structs can be formatted as tuples and tuples can be formatted as structs.
extern crate educe;
Use Another Method or Trait to Do the Format Thing
The format
attribute has two parameters: trait
and method
. They can be used to replace the Debug
trait on fields. If you only set the trait
parameter, the method
will be set to fmt
automatically by default.
extern crate educe;
use ;
;
;
Generaic Parameters Bound to the Debug
Trait or Others
The #[educe(Debug(bound))]
attribute can be used to add the Debug
trait bound to all generaic parameters for the Debug
implementation.
extern crate educe;
Or you can set the where predicates by yourself.
extern crate educe;
use ;
;
;
TODO
There is a lot of work to be done. Unimplemented traits are listed below:
Default
Clone
Copy
Hash
PartialEq
Eq
PartialOrd
Ord
From
Into
FromStr
TryFrom
Deref
DerefMut
Crates.io
https://crates.io/crates/educe