mcarton / rust-derivative

A set of alternative `derive` attributes for Rust
Apache License 2.0
422 stars 46 forks source link
rust

Derivative

Crates.io Crates.io Continuous integration

This crate provides a set of alternative customizable #[derive] attributes for Rust.

Documentation

Stability

This crate is stable and follows semver. It requires rustc 1.34 or later and changing the minimal rustc version will be considered a semver breaking change.

What it does

#[derive(Derivative)]
#[derivative(Debug)]
struct Foo {
    foo: u8,
    #[derivative(Debug="ignore")]
    bar: u8,
}

// Prints `Foo { foo: 42 }`
println!("{:?}", Foo { foo: 42, bar: 1 });

Check the documentation for more!

License

Licensed under either of

at your option.

Acknowledgements

This is inspired from how serde wonderfully handles attributes. This also takes some code and ideas from serde itself.

Some tests are directly adapted from rustc's tests.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.