7 releases (4 stable)

1.3.0 Apr 30, 2024
1.1.2 Jul 21, 2023
1.1.1 Sep 27, 2022
1.1.0 Apr 19, 2022
0.8.2 Nov 10, 2015

#7 in Encoding

Download history 508971/week @ 2024-12-10 411245/week @ 2024-12-17 149080/week @ 2024-12-24 264759/week @ 2024-12-31 536747/week @ 2025-01-07 512894/week @ 2025-01-14 520081/week @ 2025-01-21 569239/week @ 2025-01-28 621460/week @ 2025-02-04 608690/week @ 2025-02-11 587148/week @ 2025-02-18 569973/week @ 2025-02-25 974189/week @ 2025-03-04 878386/week @ 2025-03-11 1299174/week @ 2025-03-18 956969/week @ 2025-03-25

4,202,542 downloads per month
Used in 1,838 crates (731 directly)

MIT license

195KB
4K SLoC

MessagePack + Serde

This crate connects Rust MessagePack library with serde providing an ability to easily serialize and deserialize both Rust built-in types, the standard library and custom data structures.

Motivating example

let buf = rmp_serde::to_vec(&(42, "the Answer")).unwrap();

assert_eq!(
    vec![0x92, 0x2a, 0xaa, 0x74, 0x68, 0x65, 0x20, 0x41, 0x6e, 0x73, 0x77, 0x65, 0x72],
    buf
);

assert_eq!((42, "the Answer"), rmp_serde::from_slice(&buf).unwrap());

Type-based Serialization and Deserialization

Serde provides a mechanism for low boilerplate serialization & deserialization of values to and from MessagePack via the serialization API.

To be able to serialize a piece of data, it must implement the serde::Serialize trait. To be able to deserialize a piece of data, it must implement the serde::Deserialize trait. Serde provides an annotation to automatically generate the code for these traits: #[derive(Serialize, Deserialize)].

Examples

use std::collections::HashMap;
use serde::{Deserialize, Serialize};
use rmp_serde::{Deserializer, Serializer};

#[derive(Debug, PartialEq, Deserialize, Serialize)]
struct Human {
    age: u32,
    name: String,
}

fn main() {
    let mut buf = Vec::new();
    let val = Human {
        age: 42,
        name: "John".into(),
    };

    val.serialize(&mut Serializer::new(&mut buf)).unwrap();
}

Efficient storage of &[u8] types

MessagePack can efficiently store binary data. However, Serde's standard derived implementations do not use binary representations by default. Serde prefers to represent types like &[u8; N] or Vec<u8> as arrays of objects of arbitrary/unknown type, and not as slices of bytes. This creates about a 50% overhead in storage size.

Wrap your data in serde_bytes to store blobs quickly and efficiently. Alternatively, configure an override in rmp_serde to force use of byte slices.

Dependencies

~280–600KB
~12K SLoC