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
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
//! Wrapper types for parser sources.

use std::io;

use crate::pull_parser::{reader::PositionCacheReader, ParserSource};

/// Source with plain reader backend.
///
/// This may be inefficient, but works with any reader types.
/// It is recommended to use [`SeekableSource`] if the reader implements
/// [`std::io::Seek`].
///
/// This internally uses `PositionCacheReader`, so users don't need to wrap
/// readers by `PositionCacheReader` manually.
///
/// [`std::io::Seek`]: https://doc.rust-lang.org/stable/std/io/trait.Seek.html
/// [`PositionCacheReader`]: struct.PositionCacheReader.html
/// [`SeekableSource`]: struct.SeekableSource.html
#[derive(Debug, Clone, Copy)]
pub struct PlainSource<R> {
    /// Inner reader.
    inner: PositionCacheReader<R>,
}

impl<R: io::Read> PlainSource<R> {
    /// Creates a new `PlainSource`.
    pub fn new(inner: R) -> Self {
        Self {
            inner: PositionCacheReader::new(inner),
        }
    }

    /// Creates a new `PlainSource` with the given offset.
    ///
    /// # Examples
    ///
    /// ```
    /// # use fbxcel::pull_parser::reader::PlainSource;
    /// use fbxcel::pull_parser::ParserSource;
    ///
    /// let msg = "Hello, world!";
    /// let len = msg.len() as u64;
    /// let mut reader = std::io::Cursor::new(msg);
    /// let mut reader = PlainSource::with_offset(&mut reader, 42);
    ///
    /// assert_eq!(reader.position(), 42, "Start position is 42");
    /// std::io::copy(&mut reader, &mut std::io::sink())
    ///     .expect("Should never fail");
    /// assert_eq!(reader.position(), len + 42);
    /// ```
    pub fn with_offset(inner: R, offset: usize) -> Self {
        Self {
            inner: PositionCacheReader::with_offset(inner, offset),
        }
    }
}

impl<R: io::Read> io::Read for PlainSource<R> {
    fn read(&mut self, buf: &mut [u8]) -> io::Result<usize> {
        self.inner.read(buf)
    }
}

impl<R: io::BufRead> io::BufRead for PlainSource<R> {
    fn fill_buf(&mut self) -> io::Result<&[u8]> {
        self.inner.fill_buf()
    }

    fn consume(&mut self, amt: usize) {
        self.inner.consume(amt)
    }
}

impl<R: io::Read> ParserSource for PlainSource<R> {
    fn position(&self) -> u64 {
        self.inner.position() as u64
    }

    fn skip_distance(&mut self, distance: u64) -> io::Result<()> {
        // NOTE: `self.inner.take(distance)` is E0507.
        io::copy(
            &mut io::Read::take(&mut self.inner, distance),
            &mut io::sink(),
        )?;
        Ok(())
    }
}

/// Source with seekable reader backend.
///
/// This may be more efficient than [`PlainSource`], but works only with reader
/// types implementing `std::io::Seek`.
///
/// This internally uses [`PositionCacheReader`], so users don't need to wrap
/// readers by [`PositionCacheReader`] manually.
///
/// [`PlainSource`]: struct.PlainSource.html
/// [`PositionCacheReader`]: struct.PositionCacheReader.html
#[derive(Debug, Clone, Copy)]
pub struct SeekableSource<R> {
    /// Inner reader.
    inner: PositionCacheReader<R>,
}

impl<R: io::Read + io::Seek> SeekableSource<R> {
    /// Creates a new `SeekableSource`.
    pub fn new(inner: R) -> Self {
        Self {
            inner: PositionCacheReader::new(inner),
        }
    }

    /// Creates a new `SeekableSource` with the given offset.
    ///
    /// # Examples
    ///
    /// ```
    /// # use fbxcel::pull_parser::reader::SeekableSource;
    /// use fbxcel::pull_parser::ParserSource;
    ///
    /// let msg = "Hello, world!";
    /// let len = msg.len() as u64;
    /// let mut reader = std::io::Cursor::new(msg);
    /// let mut reader = SeekableSource::with_offset(&mut reader, 42);
    ///
    /// assert_eq!(reader.position(), 42, "Start position is 42");
    /// std::io::copy(&mut reader, &mut std::io::sink())
    ///     .expect("Should never fail");
    /// assert_eq!(reader.position(), len + 42);
    /// ```
    pub fn with_offset(inner: R, offset: usize) -> Self {
        Self {
            inner: PositionCacheReader::with_offset(inner, offset),
        }
    }
}

impl<R: io::Read> io::Read for SeekableSource<R> {
    fn read(&mut self, buf: &mut [u8]) -> io::Result<usize> {
        self.inner.read(buf)
    }
}

impl<R: io::BufRead> io::BufRead for SeekableSource<R> {
    fn fill_buf(&mut self) -> io::Result<&[u8]> {
        self.inner.fill_buf()
    }

    fn consume(&mut self, amt: usize) {
        self.inner.consume(amt)
    }
}

impl<R: io::Read + io::Seek> ParserSource for SeekableSource<R> {
    fn position(&self) -> u64 {
        self.inner.position() as u64
    }

    fn skip_distance(&mut self, distance: u64) -> io::Result<()> {
        // `PositionCacheReader<R>::skip_distance` will be available only when
        // `R: io::Seek`, and it will use `io::Seek::seek` efficiently.
        self.inner.skip_distance(distance)
    }
}