rustis 0.10.1

Redis async driver for Rust
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
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116

use smallvec::SmallVec;

use crate::resp::ToArgs;
use std::{fmt};

/// Collection of arguments of [`Command`](crate::resp::Command).
#[derive(Clone, Default)]
pub struct CommandArgs {
    args: SmallVec<[Vec<u8>;10]>,
}

impl CommandArgs {
    /// Builder function to add an argument to an existing command collection.
    #[inline]
    pub fn arg<A>(&mut self, args: A) -> &mut Self
    where
        A: ToArgs,
    {
        args.write_args(self);
        self
    }

    /// Builder function to add an argument by ref to an existing command collection.
    #[inline]
    pub fn arg_ref<A>(&mut self, args: &A) -> &mut Self
    where
        A: ToArgs,
    {
        args.write_args(self);
        self
    }

    /// Builder function to add an argument to an existing command collection,
    /// only if a condition is `true`.
    #[inline]
    pub fn arg_if<A>(&mut self, condition: bool, args: A) -> &mut Self
    where
        A: ToArgs,
    {
        if condition {
            self.arg(args)
        } else {
            self
        }
    }

    /// helper to build a CommandArgs in one line.
    #[inline]
    pub fn build(&mut self) -> Self {
        let mut args = CommandArgs::default();
        std::mem::swap(&mut args.args, &mut self.args);
        args
    }

    /// Number of arguments of the collection
    #[must_use]
    #[inline]
    pub fn len(&self) -> usize {
        self.args.len()
    }

    /// Check if the collection is empty
    #[must_use]
    #[inline]
    pub fn is_empty(&self) -> bool {
        self.len() == 0
    }

    #[inline]
    pub(crate) fn write_arg(&mut self, buf: &[u8]) {
        self.args.push(buf.to_vec());
    }
}

impl<'a> IntoIterator for &'a CommandArgs {
    type Item = &'a [u8];
    type IntoIter = CommandArgsIterator<'a>;

    #[inline]
    fn into_iter(self) -> Self::IntoIter {
        CommandArgsIterator {
            iter: self.args.iter()
        }
    }
}

/// [`CommandArgs`] iterator
pub struct CommandArgsIterator<'a> {
    iter: std::slice::Iter<'a, Vec<u8>>
}

impl<'a> Iterator for CommandArgsIterator<'a> {
    type Item = &'a [u8];

    #[inline]
    fn next(&mut self) -> Option<Self::Item> {
        self.iter.next().map(|v| v.as_slice())
    }
}

impl std::ops::Deref for CommandArgs {
    type Target = [Vec<u8>];

    #[inline]
    fn deref(&self) -> &Self::Target {
        &self.args
    }
}

impl fmt::Debug for CommandArgs {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        f.debug_struct("CommandArgs")
            .field("args", &self.args.iter().map(|a| String::from_utf8_lossy(a.as_slice())).collect::<Vec<_>>())
            .finish()
    }
}