ninep 0.5.0

A bare bones 9p 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
66
67
68
69
70
71

//! A synchronous implementation of 9p Servers and Clients
use crate::{
    Result,
    sansio::protocol::{NineP, SharedBuf},
};
use simple_coro::CoroState;
use std::{
    io::{self, Read, Write},
    net::TcpStream,
    os::unix::net::UnixStream,
};

pub mod client;
pub mod server;

/// Synchronous IO support for reading and writing 9p messages
pub trait SyncNineP: NineP {
    /// Encode self as bytes for the 9p protocol and write to the given [SyncStream].
    fn write_to<W: Write>(&self, w: &mut W) -> io::Result<()> {
        let mut buf = vec![0; self.n_bytes()];
        self.write_bytes(&mut buf)
            .map_err(|e| io::Error::other(e.to_string()))?;

        w.write_all(&buf)
    }

    /// Decode self from 9p protocol bytes coming from the given [SyncStream].
    fn read_from<R: Read>(buf: &SharedBuf, r: &mut R) -> io::Result<Self> {
        let mut coro = Self::read_9p_coro(buf);
        loop {
            coro = match coro.resume() {
                CoroState::Pending(c, n) => {
                    // SAFETY: coro is currently suspended and unable to take a reference to buf
                    let mut_buf = unsafe { buf.as_inner_mut() };
                    mut_buf.resize(n, 0);
                    r.read_exact(mut_buf)?;
                    c.send(())
                }

                CoroState::Complete(res) => return res,
            };
        }
    }
}

impl<T> SyncNineP for T where T: NineP {}

/// A Stream that makes use of the standard library [Read] and [Write] traits to perform IO
pub trait SyncStream: Read + Write + Send + Sized + 'static {}

impl SyncStream for UnixStream {}
impl SyncStream for TcpStream {}

/// A Stream that makes use of the standard library [Read] and [Write] traits to perform IO
/// and additionally supports cloning the stream.
pub trait SyncServerStream: SyncStream {
    /// Clone this stream, accounting for operating system errors
    fn try_clone(&self) -> Result<Self>;
}

impl SyncServerStream for UnixStream {
    fn try_clone(&self) -> Result<Self> {
        self.try_clone().map_err(|e| e.to_string())
    }
}

impl SyncServerStream for TcpStream {
    fn try_clone(&self) -> Result<Self> {
        self.try_clone().map_err(|e| e.to_string())
    }
}