clone-fields 0.5.0

Fields-wise types cloning
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

# clone-fields

[![pipeline status](https://gitlab.com/mexus/fields-converter/badges/master/pipeline.svg)](https://gitlab.com/mexus/fields-converter/commits/master)
[![crates.io](https://img.shields.io/crates/v/clone-fields.svg)](https://crates.io/crates/clone-fields)
[![docs.rs](https://docs.rs/clone-fields/badge.svg)](https://docs.rs/clone-fields)

[[Release docs]](https://docs.rs/clone-fields/)

[[Master docs]](https://mexus.gitlab.io/clone-fields/clone_fields/)

Fields-wise types cloning. Nothing more, nothing less.

```rust
use clone_fields::{CloneFields, CloneInto, CloneFrom};

// PartialEq and Debug traits are only required for `assert` macros in the example.
#[derive(PartialEq, Debug, CloneFields)]
#[destinations("External")]
struct Original<'a, T: Clone> {
    field1: &'a i64,
    field2: T,
    nested: OriginalNested,
}

#[derive(PartialEq, Debug, CloneFields)]
#[destinations("ExternalNested", "ExternalNested2")]
struct OriginalNested {
    value: i32,
}

// S2 might be a *foreign* type, i.e. declared in a different crate.
struct External<'a, T: Clone> {
    field1: &'a i64,
    field2: T,
    nested: ExternalNested,
}

struct ExternalNested {
    value: i32,
}

// This struct only exists for the sake of using `destinations` attribute with more than one
// type :)
struct ExternalNested2 {
    value: i32,
}

fn main() {
    let obj: Original<_> = Original {
        field1: &0,
        field2: String::from("lol"),
        nested: OriginalNested { value: 15 }
    };
    let cloned: External<_> = obj.clone_into();
    assert_eq!(obj.field1, cloned.field1);
    assert_eq!(obj.field2, cloned.field2);
    assert_eq!(obj.nested.value, cloned.nested.value);
    let cloned2 = Original::clone_from(&cloned);
    assert_eq!(cloned.field1, cloned2.field1);
    assert_eq!(cloned.field2, cloned2.field2);
    assert_eq!(obj, cloned2);
}
```

License: MIT/Apache-2.0