is_first/is_last to ease handling of Position::Only

Author: kornelski

src/with_position.rs

@@ -45,7 +45,7 @@ where
 /// The first component of the value yielded by `WithPosition`.
 /// Indicates the position of this element in the iterator results.
 ///
-/// When handling the first or last position,
+/// When handling the [first](Position::is_first) or [last](Position::is_last) position,
 /// remember to consider the special case of [`Position::Only`].
 ///
 /// See [`.with_position()`](crate::Itertools::with_position) for more information.
@@ -58,9 +58,23 @@ pub enum Position {
     /// This is the last element, and there was more than one element.
     Last,
     /// This is the only element.
+    ///
+    /// Makes [`.is_first()`](Position::is_first) and [`.is_last()`](Position::is_last) true at the same time.
     Only,
 }
 
+impl Position {
+    /// Unlike `position == First`, it's also true for [`Position::Only`]
+    pub fn is_first(self) -> bool {
+        self == Self::First || self == Self::Only
+    }
+
+    /// Unlike `position == Last`, it's also true for [`Position::Only`]
+    pub fn is_last(self) -> bool {
+        self == Self::Last || self == Self::Only
+    }
+}
+
 impl<I: Iterator> Iterator for WithPosition<I> {
     type Item = (Position, I::Item);