automapper 0.0.1

A simple convension based object-to-object mapper for Rust
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

# automapper
A convention based object-object mapper for Rust. This uses Json rustdoc generated by `cargo doc`.

## Usage

### Step 1: Generate `rustdoc.json` using `automapper-cli`.

```bash
# instal
cargo install --locked automapper-cli

# generate rustdoc.json in the root of a crate where you plan to use automapper
automapper-cli .
```

### Step 2: Use `automapper` in your crate.

Define some types and use `automapper` to map between them.

```rust
// some types
pub struct SourceStruct {
    pub a: i32,
    pub b: u32,
    pub s: String,
}

pub struct DestStruct {
    pub a: i32,
    pub b: u32,
    pub s: String,
}
```

Use `automapper` using auto implemented trait [AutoMapsTo] and [AutoMapsFrom]

```no_run
automapper::map!(SourceStruct, DestStruct);

use automapper::{AutoMapsFrom, AutoMapsTo};
let input = SourceStruct { .. };

let output = DestStruct::map_from(input); // using AutoMapsFrom trait
let output: DestStruct = input.map_into(); // using AutoMapsTo trait
let output = input.map_into(); // using AutoMapsTo trait (type annotation isn't necessary)
```

Or, Use `automapper` to generate mapping function

```no_run
automapper::impl_map_fn!{
   fn convert_to(SourceStruct -> DestStruct);
}

// this generates `convert_to` function like this
// fn convert_to(value: SourceStruct) -> DestStruct { .. }

let input = SourceStruct { .. };
let output = convert_to(input);
// output is DestStruct { .. }
```