facet-trait 0.2.4

Core traits for the facet ecosystem
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
66
67
68
69
70
71
72


<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://github.com/facet-rs/facet/raw/main/static/logo/facet-dark.webp">
<source media="(prefers-color-scheme: dark)" srcset="https://github.com/facet-rs/facet/raw/main/static/logo/facet-dark.png">
<source media="(prefers-color-scheme: light)" srcset="https://github.com/facet-rs/facet/raw/main/static/logo/facet-light.webp">
<img src="https://github.com/facet-rs/facet/raw/main/static/logo/facet-light.png" alt="Facet logo - a reflection library for Rust">
</picture>

# facet-trait

[![experimental](https://img.shields.io/badge/status-experimental-yellow)](https://github.com/fasterthanlime/facet)
[![free of syn](https://img.shields.io/badge/free%20of-syn-hotpink)](https://github.com/fasterthanlime/free-of-syn)
[![crates.io](https://img.shields.io/crates/v/facet-trait.svg)](https://crates.io/crates/facet-trait)
[![documentation](https://docs.rs/facet-trait/badge.svg)](https://docs.rs/facet-trait)
[![MIT/Apache-2.0 licensed](https://img.shields.io/crates/l/facet-trait.svg)](./LICENSE)

Thanks to all individual and corporate sponsors, without whom this work could not exist:

<p> <a href="https://ko-fi.com/fasterthanlime">
    <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://github.com/facet-rs/facet/raw/main/static/sponsors-v2/ko-fi-dark.svg">
    <img src="https://github.com/facet-rs/facet/raw/main/static/sponsors-v2/ko-fi-light.svg" height="40" alt="Ko-fi">
    </picture>
</a> <a href="https://github.com/sponsors/fasterthanlime">
    <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://github.com/facet-rs/facet/raw/main/static/sponsors-v2/github-dark.svg">
    <img src="https://github.com/facet-rs/facet/raw/main/static/sponsors-v2/github-light.svg" height="40" alt="GitHub Sponsors">
    </picture>
</a> <a href="https://patreon.com/fasterthanlime">
    <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://github.com/facet-rs/facet/raw/main/static/sponsors-v2/patreon-dark.svg">
    <img src="https://github.com/facet-rs/facet/raw/main/static/sponsors-v2/patreon-light.svg" height="40" alt="Patreon">
    </picture>
</a> <a href="https://zed.dev">
    <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://github.com/facet-rs/facet/raw/main/static/sponsors-v2/zed-dark.svg">
    <img src="https://github.com/facet-rs/facet/raw/main/static/sponsors-v2/zed-light.svg" height="40" alt="Zed">
    </picture>
</a> </p>
             

Defines the core `Facet` trait that powers runtime reflection in the facet ecosystem.

### The Facet Trait

The `Facet` trait is the foundation of facet's reflection system. Types that implement `Facet`:

* Provide their memory layout information
* Describe their structure (fields, variants, etc.)
* Enable safe runtime manipulation
* Can be safely type-erased and restored

### Built-in Implementations

This crate provides `Facet` implementations for many standard library types:

* Basic types (`bool`, integers, floats)
* Collections (`Vec`, `HashMap`, etc.)
* Smart pointers (`Box`, `Rc`, `Arc`)
* Other common types (`String`, `Option`, `Result`)

These implementations make it easy to use facet with existing Rust code.


## License

Licensed under either of:

- Apache License, Version 2.0 ([LICENSE-APACHE](https://github.com/facet-rs/facet/blob/main/LICENSE-APACHE) or <http://www.apache.org/licenses/LICENSE-2.0>)
- MIT license ([LICENSE-MIT](https://github.com/facet-rs/facet/blob/main/LICENSE-MIT) or <http://opensource.org/licenses/MIT>)

at your option.