mirror of
https://github.com/cloud-hypervisor/cloud-hypervisor.git
synced 2024-10-02 19:45:46 +00:00
d5f5648b37
We use cargo vendor to generate a .cargo/config file and the vendor directory. Vendoring allows us to lock our dependencies and to modify them easily from the top level Cargo.toml. We vendor all dependencies, including the crates.io ones, which allows for network isolated builds. Signed-off-by: Samuel Ortiz <sameo@linux.intel.com>
100 lines
3.1 KiB
Markdown
100 lines
3.1 KiB
Markdown
# Serde   [![Build Status]][travis] [![Latest Version]][crates.io] [![Rustc Version 1.13+]][rustc]
|
|
|
|
[Build Status]: https://api.travis-ci.org/serde-rs/serde.svg?branch=master
|
|
[travis]: https://travis-ci.org/serde-rs/serde
|
|
[Latest Version]: https://img.shields.io/crates/v/serde.svg
|
|
[crates.io]: https://crates.io/crates/serde
|
|
[Rustc Version 1.13+]: https://img.shields.io/badge/rustc-1.13+-lightgray.svg
|
|
[rustc]: https://blog.rust-lang.org/2016/11/10/Rust-1.13.html
|
|
|
|
**Serde is a framework for *ser*ializing and *de*serializing Rust data structures efficiently and generically.**
|
|
|
|
---
|
|
|
|
You may be looking for:
|
|
|
|
- [An overview of Serde](https://serde.rs/)
|
|
- [Data formats supported by Serde](https://serde.rs/#data-formats)
|
|
- [Setting up `#[derive(Serialize, Deserialize)]`](https://serde.rs/derive.html)
|
|
- [Examples](https://serde.rs/examples.html)
|
|
- [API documentation](https://docs.serde.rs/serde/)
|
|
- [Release notes](https://github.com/serde-rs/serde/releases)
|
|
|
|
## Serde in action
|
|
|
|
<details>
|
|
<summary>
|
|
Click to show Cargo.toml.
|
|
<a href="https://play.rust-lang.org/?edition=2018&gist=72755f28f99afc95e01d63174b28c1f5" target="_blank">Run this code in the playground.</a>
|
|
</summary>
|
|
|
|
```toml
|
|
[dependencies]
|
|
|
|
# The core APIs, including the Serialize and Deserialize traits. Always
|
|
# required when using Serde. The "derive" feature is only required when
|
|
# using #[derive(Serialize, Deserialize)] to make Serde work with structs
|
|
# and enums defined in your crate.
|
|
serde = { version = "1.0", features = ["derive"] }
|
|
|
|
# Each data format lives in its own crate; the sample code below uses JSON
|
|
# but you may be using a different one.
|
|
serde_json = "1.0"
|
|
```
|
|
|
|
</details>
|
|
<p></p>
|
|
|
|
```rust
|
|
use serde::{Serialize, Deserialize};
|
|
|
|
#[derive(Serialize, Deserialize, Debug)]
|
|
struct Point {
|
|
x: i32,
|
|
y: i32,
|
|
}
|
|
|
|
fn main() {
|
|
let point = Point { x: 1, y: 2 };
|
|
|
|
// Convert the Point to a JSON string.
|
|
let serialized = serde_json::to_string(&point).unwrap();
|
|
|
|
// Prints serialized = {"x":1,"y":2}
|
|
println!("serialized = {}", serialized);
|
|
|
|
// Convert the JSON string back to a Point.
|
|
let deserialized: Point = serde_json::from_str(&serialized).unwrap();
|
|
|
|
// Prints deserialized = Point { x: 1, y: 2 }
|
|
println!("deserialized = {:?}", deserialized);
|
|
}
|
|
```
|
|
|
|
## Getting help
|
|
|
|
Serde developers live in the #serde channel on [`irc.mozilla.org`][irc]. The
|
|
\#rust channel is also a good resource with generally faster response time but
|
|
less specific knowledge about Serde. If IRC is not your thing or you don't get a
|
|
good response, we are happy to respond to [GitHub issues][issues] as well.
|
|
|
|
[irc]: https://wiki.mozilla.org/IRC
|
|
[issues]: https://github.com/serde-rs/serde/issues/new/choose
|
|
|
|
<br>
|
|
|
|
#### License
|
|
|
|
<sup>
|
|
Licensed under either of <a href="LICENSE-APACHE">Apache License, Version
|
|
2.0</a> or <a href="LICENSE-MIT">MIT license</a> at your option.
|
|
</sup>
|
|
|
|
<br>
|
|
|
|
<sub>
|
|
Unless you explicitly state otherwise, any contribution intentionally submitted
|
|
for inclusion in Serde by you, as defined in the Apache-2.0 license, shall be
|
|
dual licensed as above, without any additional terms or conditions.
|
|
</sub>
|