feat: Expose AutoStream getters for the wrapped RawStream

crates/anstream/src/auto.rs

@@ -146,7 +146,29 @@ where
         }
     }
 
-    /// Get the wrapped [`RawStream`]
+    /// Returns a reference to the wrapped [`RawStream`].
+    #[inline]
+    pub fn as_inner(&self) -> &S {
+        match &self.inner {
+            StreamInner::PassThrough(w) => w,
+            StreamInner::Strip(w) => w.as_inner(),
+            #[cfg(all(windows, feature = "wincon"))]
+            StreamInner::Wincon(w) => w.as_inner(),
+        }
+    }
+
+    /// Returns a mutable reference to the wrapped [`RawStream`].
+    #[inline]
+    pub fn as_inner_mut(&mut self) -> &mut S {
+        match &mut self.inner {
+            StreamInner::PassThrough(w) => w,
+            StreamInner::Strip(w) => w.as_inner_mut(),
+            #[cfg(all(windows, feature = "wincon"))]
+            StreamInner::Wincon(w) => w.as_inner_mut(),
+        }
+    }
+
+    /// Get the wrapped [`RawStream`].
     #[inline]
     pub fn into_inner(self) -> S {
         match self.inner {

crates/anstream/src/strip.rs

@@ -16,7 +16,7 @@ impl<S> StripStream<S>
 where
     S: std::io::Write,
 {
-    /// Only pass printable data to the inner `Write`
+    /// Only pass printable data to the inner `Write`.
     #[inline]
     pub fn new(raw: S) -> Self {
         Self {
@@ -25,7 +25,19 @@ where
         }
     }
 
-    /// Get the wrapped [`std::io::Write`]
+    /// Returns a reference to the wrapped [`std::io::Write`].
+    #[inline]
+    pub fn as_inner(&self) -> &S {
+        &self.raw
+    }
+
+    /// Returns a mutable reference to the wrapped [`std::io::Write`].
+    #[inline]
+    pub fn as_inner_mut(&mut self) -> &mut S {
+        &mut self.raw
+    }
+
+    /// Get the wrapped [`std::io::Write`].
     #[inline]
     pub fn into_inner(self) -> S {
         self.raw

crates/anstream/src/wincon.rs

@@ -20,7 +20,7 @@ impl<S> WinconStream<S>
 where
     S: anstyle_wincon::WinconStream,
 {
-    /// Only pass printable data to the inner `Write`
+    /// Only pass printable data to the inner `Write`.
     #[inline]
     pub fn new(raw: S) -> Self {
         Self {
@@ -29,7 +29,17 @@ where
         }
     }
 
-    /// Get the wrapped [`anstyle_wincon::WinconStream`]
+    /// Returns a reference to the wrapped [`anstyle_wincon::WinconStream`].
+    pub fn as_inner(&self) -> &S {
+        &self.raw
+    }
+
+    /// Returns a mutable reference to the wrapped [`anstyle_wincon::WinconStream`].
+    pub fn as_inner_mut(&mut self) -> &mut S {
+        &mut self.raw
+    }
+
+    /// Get the wrapped [`anstyle_wincon::WinconStream`].
     #[inline]
     pub fn into_inner(self) -> S {
         self.raw