Testing library for serde Serialize and Deserialize implementations.
This library provides a Serializer and Deserializer to be used in writing unit tests to assert the behavior of manual Serialize and Deserialize implementations, respectively. The implementation behavior can be verified using a sequence of Tokens representing a generic serialized state.
The examples below use the claims crate for convenient assertions.
The Serializer returns a sequence of Tokens representing the serialization of a value. The returned Tokens can be checked to be equal to an expected value.
use claims::assert_ok_eq;
use serde::Serialize;
use serde_assert::{
Serializer,
Token,
};
let serializer = Serializer::builder().build();
assert_ok_eq!(true.serialize(&serializer), [Token::Bool(true)]);A Deserializer is constructed by providing a sequence of Tokens to be deserialized into a value.
use claims::assert_ok_eq;
use serde::Deserialize;
use serde_assert::{
Deserializer,
Token,
};
let mut deserializer = Deserializer::builder([Token::Bool(true)]).build();
assert_ok_eq!(bool::deserialize(&mut deserializer), true);Comparison with serde_test
This crate provides more flexibility than serde_test at the expense of more verbosity. While serde_test provides a small API of simple assertion functions, this crate will require you to call serialize() and deserialize() and assert yourself that the results are as expected.
While some users may find that the smaller API of serde_test is sufficient for their use-case, others will find that the flexibility of this crate makes testing more complicated Serailize and Deserialize implementations easier. Among other things, this crate's API provides these advantages:
- Direct access to the
SerializerandDeserializer, allowing use of all parts of theserdeSerializerandDeserializerAPIs, such as deserializing types that implementDeserializeSeed. - Customization of
Serializers andDeserializers, allowing configuration of things like human-readability, whether theDeserializershould interpret sequences ofTokens as self-describing, and zero-copy deserialization. - Sophisticated comparison of serialized
Tokensequences, including allowing testing of types whose serialized form can include items in arbitrary order, such as when serializing aHashSet.
This crate is guaranteed to compile on stable rustc 1.56.0 and up.
This project is licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent