Deprecate byte patterns

Author: dylni

Cargo.toml

@@ -29,4 +29,5 @@ getrandom = "0.2"
 [features]
 default = ["memchr", "raw_os_str"]
 
+deprecated-byte-patterns = []
 raw_os_str = []

src/lib.rs

@@ -77,6 +77,11 @@
 //!
 //! ### Optional Features
 //!
+//! - **deprecated-byte-patterns** -
+//!   Provides an implementation of [`Pattern`] for [`u8`] that panics when it
+//!   is not an ASCII character. *This feature is deprecated and was only added
+//!   to ease removal of this pattern type.*
+//!
 //! - **print\_bytes** -
 //!   Provides implementations of [`print_bytes::ToBytes`] for [`RawOsStr`] and
 //!   [`RawOsString`].
@@ -428,5 +433,6 @@ mod private {
     impl Sealed for PathBuf {}
     impl Sealed for &str {}
     impl Sealed for &String {}
+    #[cfg(feature = "deprecated-byte-patterns")]
     impl Sealed for u8 {}
 }

src/pattern.rs

@@ -4,9 +4,11 @@ pub trait Encoded {
     fn __get(&self) -> &[u8];
 }
 
+#[cfg(feature = "deprecated-byte-patterns")]
 #[derive(Clone)]
 pub struct EncodedByte([u8; 1]);
 
+#[cfg(feature = "deprecated-byte-patterns")]
 impl Encoded for EncodedByte {
     #[inline]
     fn __get(&self) -> &[u8] {
@@ -86,6 +88,11 @@ impl<'a> Pattern for &'a String {
     }
 }
 
+#[cfg(feature = "deprecated-byte-patterns")]
+#[cfg_attr(
+    os_str_bytes_docs_rs,
+    doc(cfg(feature = "deprecated-byte-patterns"))
+)]
 impl Pattern for u8 {
     #[doc(hidden)]
     type __Encoded = EncodedByte;