squeue 0.10.3

SQueue is a sized queue.
Documentation 
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

// Copyright (C) 2024 Christian Mauduit <ufoot@ufoot.org>

use crate::queue::Queue;
use crate::sync_queue::SyncQueue;
use serde::de::Deserializer;
use serde::ser::Serializer;
use serde::{Deserialize, Serialize};

impl<'de, V> Deserialize<'de> for SyncQueue<V>
where
    V: 'de + Deserialize<'de> + Clone,
{
    /// Deserialize the queue.
    ///
    /// Queue and SyncQueue share the same representation
    /// so it is fine to (de)serialize from any of them.
    ///
    /// ```
    /// use squeue::SyncQueue;
    ///
    /// let export = "{\"capacity\":7,\"data\":[1,4,3]}";
    ///
    /// let queue: SyncQueue<usize> = serde_json::from_str(&export).unwrap();
    ///
    /// assert_eq!(3, queue.len());
    /// assert_eq!(7, queue.capacity());
    /// assert_eq!(Some(3), queue.pop());
    /// assert_eq!(Some(4), queue.pop());
    /// assert_eq!(Some(1), queue.pop());
    /// assert_eq!(None, queue.pop());
    /// ```
    fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
    where
        D: Deserializer<'de>,
    {
        let queue: Queue<V> = Queue::deserialize(deserializer)?;
        Ok(SyncQueue::from(queue))
    }
}

impl<V> Serialize for SyncQueue<V>
where
    V: Serialize + Clone,
{
    /// Serialize the sync queue.
    ///
    /// This is possibly long, and requires data to support Clone.
    /// Internally, extracts non-sync version and serializes it.
    ///
    /// ```
    /// use squeue::SyncQueue;
    /// use serde_json::json;
    ///
    /// let queue = SyncQueue::new(10);
    ///
    /// queue.push(7);
    /// queue.push(22);
    ///
    /// let export = json!(&queue).to_string();
    ///
    /// assert_eq!("{\"capacity\":10,\"data\":[22,7]}", export);
    /// ```
    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
    where
        S: Serializer,
    {
        let queue = Queue::<V>::from(self.clone()).serialize(serializer)?;
        Ok(queue)
    }
}