1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
|
# serde\_test   [![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\_test
This crate provides a convenient concise way to write unit tests for
implementations of [`Serialize`] and [`Deserialize`].
[`Serialize`]: serde::ser::Serialize
[`Deserialize`]: serde::de::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.
[`Serializer`]: serde::ser::Serializer
Here is an example from the [`linked-hash-map`] crate.
[`linked-hash-map`]: https://github.com/contain-rs/linked-hash-map
```rust
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,
],
);
}
```
<br>
#### License
<sup>
Licensed under either of <a href="LICENSE-APACHE">Apache License, Version
2.0</a> or <a href="LICENSE-MIT">MIT license</a> at your option.
</sup>
<br>
<sub>
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in this crate by you, as defined in the Apache-2.0 license, shall
be dual licensed as above, without any additional terms or conditions.
</sub>
|
