asynchronous-codec 0.7.0

Utilities for encoding and decoding frames using `async/await`
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

use crate::{Decoder, Encoder};
use bytes::{BufMut, BytesMut};
use memchr::memchr;
use std::io::{Error, ErrorKind};

/// A simple `Codec` implementation that splits up data into lines.
///
/// ```rust
/// # futures::executor::block_on(async move {
/// use futures::stream::TryStreamExt; // for lines.try_next()
/// use asynchronous_codec::{FramedRead, LinesCodec};
///
/// let input = "hello\nworld\nthis\nis\ndog\n".as_bytes();
/// let mut lines = FramedRead::new(input, LinesCodec);
/// while let Some(line) = lines.try_next().await? {
///     println!("{}", line);
/// }
/// # Ok::<_, std::io::Error>(())
/// # }).unwrap();
/// ```
pub struct LinesCodec;

impl Encoder for LinesCodec {
    type Item<'a> = String;
    type Error = Error;

    fn encode(&mut self, item: Self::Item<'_>, dst: &mut BytesMut) -> Result<(), Self::Error> {
        dst.reserve(item.len());
        dst.put(item.as_bytes());
        Ok(())
    }
}

impl Decoder for LinesCodec {
    type Item = String;
    type Error = Error;

    fn decode(&mut self, src: &mut BytesMut) -> Result<Option<Self::Item>, Self::Error> {
        match memchr(b'\n', src) {
            Some(pos) => {
                let buf = src.split_to(pos + 1);
                String::from_utf8(buf.to_vec())
                    .map(Some)
                    .map_err(|e| Error::new(ErrorKind::InvalidData, e))
            }
            _ => Ok(None),
        }
    }
}