Debian Codegraph @

.cargo/vendor/serde/README.md

raw
1 # Serde   [![Build Status]][actions] [![Latest Version]][crates.io] [![serde msrv]][Rust 1.31] [![serde_derive msrv]][Rust 1.56]
2
3 [Build Status]: https://img.shields.io/github/actions/workflow/status/serde-rs/serde/ci.yml?branch=master
4 [actions]: https://github.com/serde-rs/serde/actions?query=branch%3Amaster
5 [Latest Version]: https://img.shields.io/crates/v/serde.svg
6 [crates.io]: https://crates.io/crates/serde
7 [serde msrv]: https://img.shields.io/crates/msrv/serde.svg?label=serde%20msrv&color=lightgray
8 [serde_derive msrv]: https://img.shields.io/crates/msrv/serde_derive.svg?label=serde_derive%20msrv&color=lightgray
9 [Rust 1.31]: https://blog.rust-lang.org/2018/12/06/Rust-1.31-and-rust-2018.html
10 [Rust 1.56]: https://blog.rust-lang.org/2021/10/21/Rust-1.56.0.html
11
12 **Serde is a framework for *ser*ializing and *de*serializing Rust data structures efficiently and generically.**
13
14 ---
15
16 You may be looking for:
17
18 - [An overview of Serde](https://serde.rs/)
19 - [Data formats supported by Serde](https://serde.rs/#data-formats)
20 - [Setting up `#[derive(Serialize, Deserialize)]`](https://serde.rs/derive.html)
21 - [Examples](https://serde.rs/examples.html)
22 - [API documentation](https://docs.rs/serde)
23 - [Release notes](https://github.com/serde-rs/serde/releases)
24
25 ## Serde in action
26
27 <details>
28 <summary>
29 Click to show Cargo.toml.
30 <a href="https://play.rust-lang.org/?edition=2018&gist=72755f28f99afc95e01d63174b28c1f5" target="_blank">Run this code in the playground.</a>
31 </summary>
32
33 ```toml
34 [dependencies]
35
36 # The core APIs, including the Serialize and Deserialize traits. Always
37 # required when using Serde. The "derive" feature is only required when
38 # using #[derive(Serialize, Deserialize)] to make Serde work with structs
39 # and enums defined in your crate.
40 serde = { version = "1.0", features = ["derive"] }
41
42 # Each data format lives in its own crate; the sample code below uses JSON
43 # but you may be using a different one.
44 serde_json = "1.0"
45 ```
46
47 </details>
48 <p></p>
49
50 ```rust
51 use serde::{Deserialize, Serialize};
52
53 #[derive(Serialize, Deserialize, Debug)]
54 struct Point {
55 x: i32,
56 y: i32,
57 }
58
59 fn main() {
60 let point = Point { x: 1, y: 2 };
61
62 // Convert the Point to a JSON string.
63 let serialized = serde_json::to_string(&point).unwrap();
64
65 // Prints serialized = {"x":1,"y":2}
66 println!("serialized = {}", serialized);
67
68 // Convert the JSON string back to a Point.
69 let deserialized: Point = serde_json::from_str(&serialized).unwrap();
70
71 // Prints deserialized = Point { x: 1, y: 2 }
72 println!("deserialized = {:?}", deserialized);
73 }
74 ```
75
76 ## Getting help
77
78 Serde is one of the most widely used Rust libraries so any place that Rustaceans
79 congregate will be able to help you out. For chat, consider trying the
80 [#rust-questions] or [#rust-beginners] channels of the unofficial community
81 Discord (invite: <https://discord.gg/rust-lang-community>), the [#rust-usage] or
82 [#beginners] channels of the official Rust Project Discord (invite:
83 <https://discord.gg/rust-lang>), or the [#general][zulip] stream in Zulip. For
84 asynchronous, consider the [\[rust\] tag on StackOverflow][stackoverflow], the
85 [/r/rust] subreddit which has a pinned weekly easy questions post, or the Rust
86 [Discourse forum][discourse]. It's acceptable to file a support issue in this
87 repo but they tend not to get as many eyes as any of the above and may get
88 closed without a response after some time.
89
90 [#rust-questions]: https://discord.com/channels/273534239310479360/274215136414400513
91 [#rust-beginners]: https://discord.com/channels/273534239310479360/273541522815713281
92 [#rust-usage]: https://discord.com/channels/442252698964721669/443150878111694848
93 [#beginners]: https://discord.com/channels/442252698964721669/448238009733742612
94 [zulip]: https://rust-lang.zulipchat.com/#narrow/stream/122651-general
95 [stackoverflow]: https://stackoverflow.com/questions/tagged/rust
96 [/r/rust]: https://www.reddit.com/r/rust
97 [discourse]: https://users.rust-lang.org
98
99 <br>
100
101 #### License
102
103 <sup>
104 Licensed under either of <a href="LICENSE-APACHE">Apache License, Version
105 2.0</a> or <a href="LICENSE-MIT">MIT license</a> at your option.
106 </sup>
107
108 <br>
109
110 <sub>
111 Unless you explicitly state otherwise, any contribution intentionally submitted
112 for inclusion in Serde by you, as defined in the Apache-2.0 license, shall be
113 dual licensed as above, without any additional terms or conditions.
114 </sub>