Go to file
2023-07-23 15:23:37 +05:00
.github Add CI job using minimal-versions 2023-07-05 10:01:33 -07:00
precompiled Leak all memory allocated during macro expansion 2023-07-22 08:32:18 -07:00
serde Release 1.0.174 2023-07-20 22:20:37 -07:00
serde_derive Slightly reduced number of allocations 2023-07-23 15:23:37 +05:00
serde_derive_internals Opt in to generate-link-to-definition when building on docs.rs 2023-07-20 22:19:03 -07:00
serde_test Release 1.0.174 2023-07-20 22:20:37 -07:00
test_suite Add tests for aliases 2023-07-23 15:23:36 +05:00
.gitignore Format in rfc style 2017-04-18 14:23:21 -07:00
Cargo.toml Workaround for "no bin target named serde_derive_tests_no_std" 2017-07-21 00:05:30 -07:00
CONTRIBUTING.md Fix outdated test instructions in CONTRIBUTING.md 2021-06-12 13:38:40 -07:00
crates-io.md More formatting of doc tests and example code 2023-07-06 15:56:47 -07:00
LICENSE-APACHE Remove appendix from LICENSE-APACHE 2022-12-30 22:32:44 +03:00
LICENSE-MIT Copyright/license headers 2018-11-24 15:53:09 -08:00
README.md More formatting of doc tests and example code 2023-07-06 15:56:47 -07:00

Serde Build Status Latest Version serde: rustc 1.19+ serde_derive: rustc 1.56+

Serde is a framework for serializing and deserializing Rust data structures efficiently and generically.


You may be looking for:

Serde in action

Click to show Cargo.toml. Run this code in the playground.
[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"

use serde::{Deserialize, Serialize};

#[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 is one of the most widely used Rust libraries so any place that Rustaceans congregate will be able to help you out. For chat, consider trying the #rust-questions or #rust-beginners channels of the unofficial community Discord (invite: https://discord.gg/rust-lang-community), the #rust-usage or #beginners channels of the official Rust Project Discord (invite: https://discord.gg/rust-lang), or the #general stream in Zulip. For asynchronous, consider the [rust] tag on StackOverflow, the /r/rust subreddit which has a pinned weekly easy questions post, or the Rust Discourse forum. It's acceptable to file a support issue in this repo but they tend not to get as many eyes as any of the above and may get closed without a response after some time.


License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.
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.