| commit | b3e45fa3b8ac5c1575f1c66fc7dddddb3519fa7d | [log] [tgz] |
|---|---|---|
| author | James Farrell <jamesfarrell@google.com> | Mon Sep 30 22:59:18 2024 +0000 |
| committer | James Farrell <jamesfarrell@google.com> | Mon Sep 30 22:59:18 2024 +0000 |
| tree | fb4111e7f8180e9f5b84557cc6fb56fa19ba4a2d | |
| parent | 85bae9eb1bee718d24ff3db354398a0d0c30d934 [diff] |
Migrate 25 crates to monorepo quickcheck regex-automata ryu same-file serde serde_json serde_spanned serde_test sharded-slab shlex siphasher tinyvec tinyvec_macros tokio-io-timeout toml toml_datetime toml_edit uniffi uniffi_checksum_derive uniffi_meta virtio-bindings virtio-queue virtio-vsock vsock vsprintf zerocopy-derive Bug: http://b/339424309 Test: treehugger Change-Id: Ic5576d25e7edffe51bf68fe23d29879303486de7
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, ], ); }