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
macro_rules! decoder {
($(#[$attr:meta])* $name:ident<$inner:ident> $({ $($inherent_methods:tt)* })*) => {
pin_project_lite::pin_project! {
$(#[$attr])*
///
/// This structure implements an [`AsyncRead`](tokio::io::AsyncRead) interface and will
/// read compressed data from an underlying stream and emit a stream of uncompressed data.
#[derive(Debug)]
pub struct $name<$inner> {
#[pin]
inner: crate::tokio::bufread::Decoder<$inner, crate::codec::$name>,
}
}
impl<$inner: tokio::io::AsyncBufRead> $name<$inner> {
/// Creates a new decoder which will read compressed data from the given stream and
/// emit a uncompressed stream.
pub fn new(read: $inner) -> $name<$inner> {
$name {
inner: crate::tokio::bufread::Decoder::new(read, crate::codec::$name::new()),
}
}
$($($inherent_methods)*)*
}
impl<$inner> $name<$inner> {
/// Configure multi-member/frame decoding, if enabled this will reset the decoder state
/// when reaching the end of a compressed member/frame and expect either EOF or another
/// compressed member/frame to follow it in the stream.
pub fn multiple_members(&mut self, enabled: bool) {
self.inner.multiple_members(enabled);
}
/// Acquires a reference to the underlying reader that this decoder is wrapping.
pub fn get_ref(&self) -> &$inner {
self.inner.get_ref()
}
/// Acquires a mutable reference to the underlying reader that this decoder is
/// wrapping.
///
/// Note that care must be taken to avoid tampering with the state of the reader which
/// may otherwise confuse this decoder.
pub fn get_mut(&mut self) -> &mut $inner {
self.inner.get_mut()
}
/// Acquires a pinned mutable reference to the underlying reader that this decoder is
/// wrapping.
///
/// Note that care must be taken to avoid tampering with the state of the reader which
/// may otherwise confuse this decoder.
pub fn get_pin_mut(self: std::pin::Pin<&mut Self>) -> std::pin::Pin<&mut $inner> {
self.project().inner.get_pin_mut()
}
/// Consumes this decoder returning the underlying reader.
///
/// Note that this may discard internal state of this decoder, so care should be taken
/// to avoid losing resources when this is called.
pub fn into_inner(self) -> $inner {
self.inner.into_inner()
}
}
impl<$inner: tokio::io::AsyncBufRead> tokio::io::AsyncRead for $name<$inner> {
fn poll_read(
self: std::pin::Pin<&mut Self>,
cx: &mut std::task::Context<'_>,
buf: &mut tokio::io::ReadBuf<'_>,
) -> std::task::Poll<std::io::Result<()>> {
self.project().inner.poll_read(cx, buf)
}
}
impl<$inner: tokio::io::AsyncWrite> tokio::io::AsyncWrite for $name<$inner> {
fn poll_write(
self: std::pin::Pin<&mut Self>,
cx: &mut std::task::Context<'_>,
buf: &[u8],
) -> std::task::Poll<std::io::Result<usize>> {
self.get_pin_mut().poll_write(cx, buf)
}
fn poll_flush(
self: std::pin::Pin<&mut Self>,
cx: &mut std::task::Context<'_>,
) -> std::task::Poll<std::io::Result<()>> {
self.get_pin_mut().poll_flush(cx)
}
fn poll_shutdown(
self: std::pin::Pin<&mut Self>,
cx: &mut std::task::Context<'_>,
) -> std::task::Poll<std::io::Result<()>> {
self.get_pin_mut().poll_shutdown(cx)
}
fn poll_write_vectored(
self: std::pin::Pin<&mut Self>,
cx: &mut std::task::Context<'_>,
bufs: &[std::io::IoSlice<'_>],
) -> std::task::Poll<std::io::Result<usize>> {
self.get_pin_mut().poll_write_vectored(cx, bufs)
}
fn is_write_vectored(&self) -> bool {
self.get_ref().is_write_vectored()
}
}
const _: () = {
fn _assert() {
use crate::util::{_assert_send, _assert_sync};
use core::pin::Pin;
use tokio::io::AsyncBufRead;
_assert_send::<$name<Pin<Box<dyn AsyncBufRead + Send>>>>();
_assert_sync::<$name<Pin<Box<dyn AsyncBufRead + Sync>>>>();
}
};
}
}