lol_html 2.7.2

use super::Range;
use encoding_rs::{Encoding, WINDOWS_1252};
use std::borrow::Cow;
use std::fmt::{self, Debug};
use std::ops::Deref;
use std::str;

/// An error used to indicate that an encoded string has replacements and can't be converted losslessly.
#[derive(Debug, Default, PartialEq, Eq, PartialOrd, Ord)]
#[allow(unnameable_types)] // accidentally exposed via `tag.set_name()`
pub struct HasReplacementsError;

/// A thin wrapper around byte slice with handy APIs attached
#[derive(Copy, Clone, PartialEq, Eq, Hash, Default)]
#[repr(transparent)]
pub(crate) struct Bytes<'b>(&'b [u8]);

/// A thin wrapper around either byte slice or owned bytes with some handy APIs attached
#[derive(Clone, PartialEq, Eq, Hash)]
#[allow(unnameable_types)] // accidentally exposed via `tag.set_name()`
#[repr(transparent)]
pub struct BytesCow<'b>(Cow<'b, [u8]>);

impl<'b> BytesCow<'b> {
    #[inline]
    pub fn from_str(string: &'b str, encoding: &'static Encoding) -> Self {
        encoding.encode(string).0.into()
    }

    /// Same as `BytesCow::from_str(&string).into_owned()`, but avoids copying in the common case where
    /// the output and input encodings are the same.
    pub fn from_string<'tmp>(
        string: impl Into<Cow<'tmp, str>>,
        encoding: &'static Encoding,
    ) -> BytesCow<'static> {
        let string = string.into();
        BytesCow(Cow::Owned(match encoding.encode(string.as_ref()).0 {
            Cow::Owned(bytes) => bytes,
            Cow::Borrowed(_) => string.into_owned().into_bytes(),
        }))
    }

    #[inline]
    pub fn from_str_without_replacements(
        string: &'b str,
        encoding: &'static Encoding,
    ) -> Result<Self, HasReplacementsError> {
        let (res, _, has_replacements) = encoding.encode(string);

        if has_replacements {
            Err(HasReplacementsError)
        } else {
            Ok(res.into())
        }
    }

    #[inline]
    pub fn into_owned(self) -> BytesCow<'static> {
        BytesCow(Cow::Owned(self.0.into_owned()))
    }

    #[inline]
    pub(crate) fn as_ref(&self) -> Bytes<'_> {
        Bytes(&self.0)
    }

    pub fn as_string(&self, encoding: &'static Encoding) -> String {
        self.as_ref().as_string(encoding)
    }

    pub fn as_lowercase_string(&self, encoding: &'static Encoding) -> String {
        self.as_ref().as_lowercase_string(encoding)
    }
}

impl<'b> Bytes<'b> {
    #[inline]
    pub(crate) fn new(bytes: &'b [u8]) -> Self {
        Self(bytes)
    }

    #[inline]
    pub fn as_string(&self, encoding: &'static Encoding) -> String {
        encoding.decode(self.0).0.into_owned()
    }

    #[inline]
    pub fn as_lowercase_string(&self, encoding: &'static Encoding) -> String {
        encoding.decode(self.0).0.to_ascii_lowercase()
    }

    #[inline]
    pub(crate) const fn as_slice(&self) -> &'b [u8] {
        self.0
    }

    #[inline]
    pub(crate) fn slice(&self, range: Range) -> Self {
        debug_assert!(self.0.get(range.start..range.end).is_some());
        // Optimizes to panic-free branchless
        let end = range.end.min(self.0.len());
        let start = range.start.min(end);
        Self(&self.0[start..end])
    }

    #[inline]
    pub fn split_at(&self, pos: usize) -> (Self, Self) {
        let (before, after) = self.0.split_at(pos);
        (Self(before), Self(after))
    }

    #[inline]
    pub(crate) fn opt_slice(&self, range: Option<Range>) -> Option<Self> {
        let range = range?;
        self.0.get(range.start..range.end).map(Self)
    }

    pub(crate) fn as_debug_string(&self) -> String {
        // NOTE: use WINDOWS_1252 (superset of ASCII) encoding here as
        // the most safe variant since we don't know which actual encoding
        // has been used for bytes.
        self.as_string(WINDOWS_1252)
    }
}

impl<'b> From<Cow<'b, [u8]>> for BytesCow<'b> {
    #[inline]
    fn from(bytes: Cow<'b, [u8]>) -> Self {
        Self(bytes)
    }
}

impl<'b> From<Bytes<'b>> for BytesCow<'b> {
    #[inline]
    fn from(bytes: Bytes<'b>) -> Self {
        Self(Cow::Borrowed(bytes.0))
    }
}

impl<'b> From<&'b [u8]> for BytesCow<'b> {
    #[inline]
    fn from(bytes: &'b [u8]) -> Self {
        Self(bytes.into())
    }
}

impl Debug for BytesCow<'_> {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        self.as_ref().fmt(f)
    }
}

impl<'b> From<BytesCow<'b>> for Box<[u8]> {
    #[inline]
    fn from(bytes: BytesCow<'b>) -> Self {
        match bytes.0 {
            Cow::Owned(v) if v.len() == v.capacity() => v.into_boxed_slice(),
            _ => Self::from(&bytes.0[..]),
        }
    }
}

impl Debug for Bytes<'_> {
    #[cold]
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        write!(f, "`{}`", self.as_debug_string())
    }
}

impl Deref for BytesCow<'_> {
    type Target = [u8];

    #[inline]
    fn deref(&self) -> &[u8] {
        &self.0
    }
}

impl Deref for Bytes<'_> {
    type Target = [u8];

    #[inline]
    fn deref(&self) -> &[u8] {
        self.0
    }
}