fix(stream)!: Remove Lockable in favor of methods

While this requires a little more boilerplate, it simplifies the API.

crates/anstream/src/auto.rs

@@ -1,7 +1,6 @@
 #[cfg(feature = "auto")]
 use crate::ColorChoice;
 use crate::IsTerminal;
-use crate::Lockable;
 use crate::RawStream;
 use crate::StripStream;
 #[cfg(all(windows, feature = "wincon"))]
@@ -178,7 +177,7 @@ impl AutoStream<std::io::Stdout> {
     /// - Faster performance when writing in a loop
     /// - Avoid other threads interleaving output with the current thread
     #[inline]
-    pub fn lock(self) -> <Self as Lockable>::Locked {
+    pub fn lock(self) -> AutoStream<std::io::StdoutLock<'static>> {
         let inner = match self.inner {
             StreamInner::PassThrough(w) => StreamInner::PassThrough(w.lock()),
             StreamInner::Strip(w) => StreamInner::Strip(w.lock()),
@@ -196,7 +195,7 @@ impl AutoStream<std::io::Stderr> {
     /// - Faster performance when writing in a loop
     /// - Avoid other threads interleaving output with the current thread
     #[inline]
-    pub fn lock(self) -> <Self as Lockable>::Locked {
+    pub fn lock(self) -> AutoStream<std::io::StderrLock<'static>> {
         let inner = match self.inner {
             StreamInner::PassThrough(w) => StreamInner::PassThrough(w.lock()),
             StreamInner::Strip(w) => StreamInner::Strip(w.lock()),
@@ -247,21 +246,3 @@ where
 
     // Not bothering with `write_fmt` as it just calls `write_all`
 }
-
-impl Lockable for AutoStream<std::io::Stdout> {
-    type Locked = AutoStream<<std::io::Stdout as Lockable>::Locked>;
-
-    #[inline]
-    fn lock(self) -> Self::Locked {
-        self.lock()
-    }
-}
-
-impl Lockable for AutoStream<std::io::Stderr> {
-    type Locked = AutoStream<<std::io::Stderr as Lockable>::Locked>;
-
-    #[inline]
-    fn lock(self) -> Self::Locked {
-        self.lock()
-    }
-}

crates/anstream/src/lib.rs

@@ -40,15 +40,13 @@ mod buffer;
 mod macros;
 mod auto;
 mod is_terminal;
-mod lockable;
 mod raw;
 mod strip;
 #[cfg(all(windows, feature = "wincon"))]
 mod wincon;
 
 pub use auto::AutoStream;
 pub use is_terminal::IsTerminal;
-pub use lockable::Lockable;
 pub use raw::RawStream;
 pub use strip::StripStream;
 #[cfg(all(windows, feature = "wincon"))]

crates/anstream/src/strip.rs

@@ -1,6 +1,5 @@
 use crate::adapter::StripBytes;
 use crate::IsTerminal;
-use crate::Lockable;
 use crate::RawStream;
 
 /// Only pass printable data to the inner `Write`
@@ -35,6 +34,36 @@ where
     }
 }
 
+impl StripStream<std::io::Stdout> {
+    /// Get exclusive access to the `StripStream`
+    ///
+    /// Why?
+    /// - Faster performance when writing in a loop
+    /// - Avoid other threads interleaving output with the current thread
+    #[inline]
+    pub fn lock(self) -> StripStream<std::io::StdoutLock<'static>> {
+        StripStream {
+            raw: self.raw.lock(),
+            state: self.state,
+        }
+    }
+}
+
+impl StripStream<std::io::Stderr> {
+    /// Get exclusive access to the `StripStream`
+    ///
+    /// Why?
+    /// - Faster performance when writing in a loop
+    /// - Avoid other threads interleaving output with the current thread
+    #[inline]
+    pub fn lock(self) -> StripStream<std::io::StderrLock<'static>> {
+        StripStream {
+            raw: self.raw.lock(),
+            state: self.state,
+        }
+    }
+}
+
 impl<S> IsTerminal for StripStream<S>
 where
     S: RawStream,
@@ -116,21 +145,6 @@ fn offset_to(total: &[u8], subslice: &[u8]) -> usize {
     subslice as usize - total as usize
 }
 
-impl<S> Lockable for StripStream<S>
-where
-    S: Lockable,
-{
-    type Locked = StripStream<<S as Lockable>::Locked>;
-
-    #[inline]
-    fn lock(self) -> Self::Locked {
-        Self::Locked {
-            raw: self.raw.lock(),
-            state: self.state,
-        }
-    }
-}
-
 #[cfg(test)]
 mod test {
     use super::*;

crates/anstream/src/wincon.rs

@@ -1,6 +1,5 @@
 use crate::adapter::WinconBytes;
 use crate::IsTerminal;
-use crate::Lockable;
 use crate::RawStream;
 
 /// Only pass printable data to the inner `Write`
@@ -42,6 +41,36 @@ where
     }
 }
 
+impl WinconStream<std::io::Stdout> {
+    /// Get exclusive access to the `WinconStream`
+    ///
+    /// Why?
+    /// - Faster performance when writing in a loop
+    /// - Avoid other threads interleaving output with the current thread
+    #[inline]
+    pub fn lock(self) -> WinconStream<std::io::StdoutLock<'static>> {
+        WinconStream {
+            raw: self.raw.lock(),
+            state: self.state,
+        }
+    }
+}
+
+impl WinconStream<std::io::Stderr> {
+    /// Get exclusive access to the `WinconStream`
+    ///
+    /// Why?
+    /// - Faster performance when writing in a loop
+    /// - Avoid other threads interleaving output with the current thread
+    #[inline]
+    pub fn lock(self) -> WinconStream<std::io::StderrLock<'static>> {
+        WinconStream {
+            raw: self.raw.lock(),
+            state: self.state,
+        }
+    }
+}
+
 impl<S> IsTerminal for WinconStream<S>
 where
     S: RawStream,
@@ -75,30 +104,6 @@ where
     }
 }
 
-impl Lockable for WinconStream<std::io::Stdout> {
-    type Locked = WinconStream<std::io::StdoutLock<'static>>;
-
-    #[inline]
-    fn lock(self) -> Self::Locked {
-        Self::Locked {
-            raw: self.raw.lock(),
-            state: self.state,
-        }
-    }
-}
-
-impl Lockable for WinconStream<std::io::Stderr> {
-    type Locked = WinconStream<std::io::StderrLock<'static>>;
-
-    #[inline]
-    fn lock(self) -> Self::Locked {
-        Self::Locked {
-            raw: self.raw.lock(),
-            state: self.state,
-        }
-    }
-}
-
 fn cap_wincon_color(color: anstyle::Color) -> Option<anstyle::AnsiColor> {
     match color {
         anstyle::Color::Ansi(c) => Some(c),