1 unstable release

0.1.0 Mar 13, 2023

#1006 in Procedural macros

Download history 1/week @ 2024-07-01 16/week @ 2024-07-15 110/week @ 2024-07-22 565/week @ 2024-07-29 360/week @ 2024-08-05 333/week @ 2024-08-12 288/week @ 2024-08-19 441/week @ 2024-08-26 377/week @ 2024-09-02 235/week @ 2024-09-09

1,341 downloads per month

Apache-2.0 OR MIT

9KB
127 lines

Derive Clone including clone_from

This crate offers a derive macro called CloneFrom to derive Clone with a specialized clone_from implementation.

When deriving Clone, Rust omits a specialized clone_from implementation and defers to clone instead. This means that it can behave counter-intuitively, for example when it should reuse allocations, but does not. This crate aims to be a drop-in replacement for deriving Clone, but with a proper clone_from implementation.

Example

#[derive(CloneFrom)]
struct MyStruct<T> {
    name: String,
    inner: Vec<T>,
}

Considerations

Adding a clone_from implementation to all types in Rust seems to add a significant compile-time cost, which is why Rust does not provide this by default. Many types do not benefit from a specialized clone_from implementation, so it's important to add it when it brings a benefit.

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.

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

Dependencies

~1.5MB
~35K SLoC