serde README

The project's README from github.com/serde-rs/serde. As one markdown file: README.md.

Serde   Build Status Latest Version serde msrv serde_derive msrv

*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.

serde (serde-rs/serde)

Searching Database…

10.9K ·GitHub
Что это такое?Serde — это фреймворк для Rust, который эффективно и универсально сериализует и десериализует структуры данных.
Serde сам по себе парсер JSON или YAML, или это что-то более общее?Serde не привязан к формату: основной крейт задаёт механизм сериализации и макросы #[derive(Serialize, Deserialize)], а отдельные крейты, такие как serde_json или serde_yaml, отвечают за сами форматы данных.
Как подключить его к проекту на Rust?Добавьте serde (обычно с функцией derive) и крейт для нужного формата данных в Cargo.toml, а затем пометьте свои структуры атрибутом #[derive(Serialize, Deserialize)].
Какая версия Rust нужна?Serde рассчитан на довольно старую минимальную поддерживаемую версию Rust, но макросы serde_derive требуют компилятор немного новее, чем основной крейт serde.
Какие форматы данных можно использовать с Serde?Сам Serde не реализует ни одного формата: его нужно сочетать с отдельным крейтом, например serde_json или serde_yaml, чтобы кодировать и декодировать JSON, YAML и другие форматы.
Почему макрос derive вынесен в отдельный крейт?Макросы #[derive(Serialize, Deserialize)] находятся в serde_derive, чтобы автоматически генерировать реализации трейтов и не писать код сериализации вручную для каждой структуры.
Можно ли использовать Serde без стандартной библиотеки?Да, у проекта есть метка поддержки no-std, поэтому его можно использовать во встраиваемых или no_std-окружениях Rust.
What are similar projects?flatbuffers, fastjson, cJSON, libfyaml, Mantle, protobuf.js, rataflow, go
Creator
serde-rs
Size
8.6 MB
Stars
10.9K
Age
12y
Commits · 90 Days