commit | 998ac86b4cc6245b1a33ec93c96143fbc4da9fe3 | [log] [tgz] |
---|---|---|
author | Android Build Coastguard Worker <android-build-coastguard-worker@google.com> | Sun May 26 07:10:49 2024 +0000 |
committer | Android Build Coastguard Worker <android-build-coastguard-worker@google.com> | Sun May 26 07:10:49 2024 +0000 |
tree | 14b382e40033abb0437ddc432233761e8dbf2567 | |
parent | eafa440d7ede4b767fb52403b2d557601df45e63 [diff] | |
parent | 9f5bf90e15c7ccc7fa0af72636dde0d06048d904 [diff] |
Snap for 11878398 from 9f5bf90e15c7ccc7fa0af72636dde0d06048d904 to busytown-mac-infra-release Change-Id: I393f109ae29203775bdc2eebd75a7716190ee2d5
This crate provides a convenient concise way to write unit tests for implementations of Serialize
and Deserialize
.
The 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 test that a value serializes to a particular sequence of method calls, an [assert_de_tokens
] function to test that a value can be deserialized from a particular sequence of method calls, and an [assert_tokens
] function to test both directions. There are also functions to test expected failure conditions.
Here is an example from the linked-hash-map
crate.
use 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, ], ); }