async-i3ipc 0.7.0

Bindings for i3 and async-std allowing async applications to communicate with i3 over it's IPC interface. Contains futures implementations and convenience functions for working with i3.
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

use async_std::{io::ReadExt, os::unix::net::UnixStream};
use i3ipc_types::{decode_event, event, MAGIC};
use std::io;

pub struct EventStream {
    inner: UnixStream,
}

impl EventStream {
    pub fn new(inner: UnixStream) -> Self {
        Self { inner }
    }

    // doesn't actually use the Stream trait because we need to use `read_exact`
    //  and I don't feel like doing all the logic for that.
    // Internally uses read_exact, not cancel-safe
    pub async fn next(&mut self) -> io::Result<event::Event> {
        let mut init = [0_u8; 14];
        self.inner.read_exact(&mut init).await?;

        assert!(&init[0..6] == MAGIC.as_bytes(), "Magic str not received");
        let payload_len = u32::from_ne_bytes([init[6], init[7], init[8], init[9]]) as usize;
        let msg_type = u32::from_ne_bytes([init[10], init[11], init[12], init[13]]);

        let mut payload = vec![0_u8; payload_len];
        self.inner.read_exact(&mut payload).await?;

        decode_event(msg_type, payload)
    }
}