struct_scalpel 0.1.1

memory layout analysis tool for structs, enums, unions, tuples, and references
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

# struct_scalpel
[![Github](https://img.shields.io/badge/github-DragonFighter603/struct_scalpel?style=flat-square&labelColor=555555&logo=github)](https://github.com/DragonFighter603/struct_scalpel)
[![crates.io](https://img.shields.io/crates/v/struct_scalpel?style=flat-square&color=fc8d62&logo=rust)](https://crates.io/crates/struct_scalpel)
[![License](https://img.shields.io/github/license/DragonFIghter603/struct_scalpel?style=flat-square)](https://github.com/DragonFighter603/struct_scalpel/blob/main/LICENSE)
[![Stars](https://img.shields.io/github/stars/DragonFighter603/struct_scalpel?style=flat-square)](https://github.com/DragonFighter603/struct_scalpel/stargazers)
![Lines of code](https://raster.shields.io/tokei/lines/github/DragonFighter603/struct_scalpel?style=flat-square)
<!-- 
[![docs.rs](https://img.shields.io/badge/docs.rs-struct_scalpel-66c2a5?style=flat-square&labelColor=555555&logo=docs.rs)](https://docs.rs/struct_scalpel)
-->
---
Memory layout analysis tool for rust structs, enums, unions, tuples, and references, prints to console using ansi escape codes.

Simply derive `Dissectible` and call `print_dissection_info` to get a well formatted overview.

```rs
use struct_scalpel::{Dissectible, print_dissection_info};

#[derive(Dissectible)]
struct Person {
    name: String,
    age: u32,
    is_student: bool,
    height: f64,
    favorite_numbers: Vec<u8>,
}

fn main() {
    print_dissection_info::<Person>();
}
```

![](img/person.png)

With `dissect_std` you can even disect some std items, with only a few type path deviations for private types.
- String
- Option<T>
- Result<T, E>
- Box<T, A: Allocator>
- Rc<T>
- cell
    - UnsafeCell<T>
    - Cell<T>
    - RefCell<T>
    - OnceCell<T>
- sync
    - OnceLock<T>

Disclaimer: This may not work in all cases, such as where some fields are unsized or dependant on a sys (os) implementation

This also works with generics and different layout strategies

![](img/struct_foo.png)
![](img/c_struct_foo.png)

![](img/2enum.png)

![](img/union.png)