cargo / serde_test / audit
cargo : serde_test @ 1.0.177
PE Patrick Elsen signed 2026-06-02 published 2026-06-02

README.md

85 lines · markdown

# serde\_test &emsp; [![Build Status]][actions] [![Latest Version]][crates.io][Build Status]: https://img.shields.io/github/actions/workflow/status/serde-rs/test/ci.yml?branch=master[actions]: https://github.com/serde-rs/test/actions?query=branch%3Amaster[Latest Version]: https://img.shields.io/crates/v/serde_test.svg[crates.io]: https://crates.io/crates/serde\_testThis crate provides a convenient concise way to write unit tests forimplementations of [`Serialize`] and [`Deserialize`].[`Serialize`]: serde::ser::Serialize[`Deserialize`]: serde::de::DeserializeThe `Serialize` impl for a value can be characterized by the sequence of[`Serializer`] calls that are made in the course of serializing the value, so`serde_test` provides a [`Token`] abstraction which corresponds roughly to`Serializer` method calls. There is an [`assert_ser_tokens`] function to testthat a value serializes to a particular sequence of method calls, an[`assert_de_tokens`] function to test that a value can be deserialized from aparticular sequence of method calls, and an [`assert_tokens`] function to testboth directions. There are also functions to test expected failure conditions.[`Serializer`]: serde::ser::SerializerHere is an example from the [`linked-hash-map`] crate.[`linked-hash-map`]: https://github.com/contain-rs/linked-hash-map```rustuse linked_hash_map::LinkedHashMap;use serde_test::{assert_tokens, Token};#[test]fn test_ser_de_empty() {    let map = LinkedHashMap::<char, u32>::new();    assert_tokens(        &map,        &[            Token::Map { len: Some(0) },            Token::MapEnd,        ],    );}#[test]fn test_ser_de() {    let mut map = LinkedHashMap::new();    map.insert('b', 20);    map.insert('a', 10);    map.insert('c', 30);    assert_tokens(        &map,        &[            Token::Map { len: Some(3) },            Token::Char('b'),            Token::I32(20),            Token::Char('a'),            Token::I32(10),            Token::Char('c'),            Token::I32(30),            Token::MapEnd,        ],    );}```<br>#### License<sup>Licensed under either of <a href="LICENSE-APACHE">Apache License, Version2.0</a> or <a href="LICENSE-MIT">MIT license</a> at your option.</sup><br><sub>Unless you explicitly state otherwise, any contribution intentionally submittedfor inclusion in this crate by you, as defined in the Apache-2.0 license, shallbe dual licensed as above, without any additional terms or conditions.</sub>