tokio-websockets 0.4.1

High performance, strict, tokio-util based websockets implementation
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

//! Random numbers generation utilities required in websocket clients.

#[cfg(not(any(feature = "fastrand", feature = "getrandom", feature = "rand")))]
compile_error!("Using the `client` feature requires enabling a random number generator implementation via one of the following features: `fastrand`, `getrandom` or `rand`.");

#[cfg(all(
    feature = "fastrand",
    not(feature = "getrandom"),
    not(feature = "rand")
))]
mod imp {
    //! Random numbers generation utilities using [`fastrand`].

    /// Generate a random 16-byte websocket key.
    pub fn get_key() -> [u8; 16] {
        fastrand::u128(..).to_ne_bytes()
    }

    /// Generate a random 4-byte websocket mask.
    pub fn get_mask() -> [u8; 4] {
        fastrand::u32(..).to_ne_bytes()
    }
}

#[cfg(all(feature = "getrandom", not(feature = "rand")))]
mod imp {
    //! Random numbers generation utilities using [`getrandom`].

    /// Generate a random 16-byte websocket key.
    pub fn get_key() -> [u8; 16] {
        let mut bytes = [0; 16];
        getrandom::getrandom(&mut bytes).expect("Failed to get random bytes, consider using `rand` or `fastrand` instead of `getrandom` if this persists");
        bytes
    }

    /// Generate a random 4-byte websocket mask.
    pub fn get_mask() -> [u8; 4] {
        let mut bytes = [0; 4];
        getrandom::getrandom(&mut bytes).expect("Failed to get random bytes, consider using `rand` or `fastrand` instead of `getrandom` if this persists");
        bytes
    }
}

#[cfg(feature = "rand")]
mod imp {
    //! Random numbers generation utilities using [`rand`].

    use rand::RngCore;

    /// Generate a random 16-byte websocket key.
    pub fn get_key() -> [u8; 16] {
        let mut bytes = [0; 16];
        rand::thread_rng().fill_bytes(&mut bytes);
        bytes
    }

    /// Generate a random 4-byte websocket mask.
    pub fn get_mask() -> [u8; 4] {
        let mut bytes = [0; 4];
        rand::thread_rng().fill_bytes(&mut bytes);
        bytes
    }
}

pub use imp::{get_key, get_mask};