tycho 0.1.2

A minimal, self-describing and traversable binary data format designed around rust and the serde data model.
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

use std::task::{Context, Poll};

use tokio::io::{AsyncRead, AsyncSeek, AsyncSeekExt, ReadBuf, SeekFrom};

use crate::error::{parse_io, TychoResult, TychoStatus};
use crate::partial::{PartialElement, PartialReader};
use crate::partial::async_::element::read_partial_element_async;
use std::pin::Pin;

#[allow(type_alias_bounds)]
/// A partial reader type with `AsyncRead` and `AsyncSeek`
pub type PartialAsyncReader<R: AsyncSeek + AsyncRead + Unpin> = PartialReader<R>;

impl<R: AsyncSeek + AsyncRead + Unpin + Send> PartialReader<R> {
    /// Jump to a pointer location on an asynchronous reader.
    ///
    /// (requires  `async_tokio` feature)
    pub async fn jump_async(&mut self, to: &u64) -> TychoStatus {
        parse_io(self.reader.seek(SeekFrom::Current((*to as i64) - (self.pointer as i64))).await)?;
        self.pointer = *to;
        Ok(())
    }

    /// Get the next element of the reader in an asynchronous manner.
    ///
    /// (requires  `async_tokio` feature)
    pub async fn element_async(&mut self) -> TychoResult<PartialElement> {
        read_partial_element_async(self).await
    }
}

impl<R: AsyncRead + AsyncSeek + Unpin> AsyncRead for PartialReader<R> {
    fn poll_read(mut self: std::pin::Pin<&mut Self>, cx: &mut Context<'_>, buf: &mut ReadBuf<'_>) -> Poll<std::io::Result<()>> {
        match AsyncRead::poll_read(Pin::new(&mut self), cx, buf) {
            Poll::Ready(x) => match x {
                Ok(_) => {
                    self.pointer += buf.filled().len() as u64;
                    Poll::Ready(Ok(()))
                }
                Err(e) => Poll::Ready(Err(e))
            }
            Poll::Pending => Poll::Pending
        }
    }
}