deno_semver 0.10.0

// Copyright 2018-2025 the Deno authors. All rights reserved. MIT license.

use std::borrow::Borrow;
use std::ops::Deref;

use capacity_builder::StringAppendable;
use capacity_builder::StringType;
use serde::Deserialize;
use serde::Serialize;

macro_rules! shared {
  ($ident:ident) => {
    impl $ident {
      #[inline(always)]
      pub fn from_cow(cow: std::borrow::Cow<str>) -> Self {
        match cow {
          std::borrow::Cow::Borrowed(s) => Self::from_str(s),
          std::borrow::Cow::Owned(s) => Self::from_string(s),
        }
      }

      #[inline(always)]
      pub fn as_str(&self) -> &str {
        self.0.as_str()
      }

      #[inline(always)]
      pub fn push(&mut self, c: char) {
        self.0.push(c);
      }

      #[inline(always)]
      pub fn push_str(&mut self, s: &str) {
        self.0.push_str(s);
      }

      #[inline(always)]
      pub fn to_string(&self) -> String {
        self.0.to_string()
      }
    }

    impl std::fmt::Display for $ident {
      #[inline(always)]
      fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        self.0.fmt(f)
      }
    }

    impl Deref for $ident {
      type Target = str;

      #[inline(always)]
      fn deref(&self) -> &Self::Target {
        self.0.as_str()
      }
    }

    impl Borrow<str> for $ident {
      #[inline(always)]
      fn borrow(&self) -> &str {
        self.as_str()
      }
    }

    impl AsRef<std::path::Path> for $ident {
      fn as_ref(&self) -> &std::path::Path {
        std::path::Path::new(self.0.as_str())
      }
    }

    impl PartialEq<str> for $ident {
      #[inline(always)]
      fn eq(&self, other: &str) -> bool {
        self.0.as_str() == other
      }
    }

    impl PartialEq<&str> for $ident {
      #[inline(always)]
      fn eq(&self, other: &&str) -> bool {
        self.0.as_str() == *other
      }
    }

    impl PartialEq<String> for $ident {
      #[inline(always)]
      fn eq(&self, other: &String) -> bool {
        self.0.as_str() == other
      }
    }

    impl PartialEq<&String> for $ident {
      #[inline(always)]
      fn eq(&self, other: &&String) -> bool {
        self.0.as_str() == other.as_str()
      }
    }

    impl PartialEq<$ident> for str {
      #[inline(always)]
      fn eq(&self, other: &$ident) -> bool {
        self == other.0
      }
    }

    impl PartialEq<$ident> for &str {
      #[inline(always)]
      fn eq(&self, other: &$ident) -> bool {
        *self == other.0
      }
    }

    impl PartialEq<$ident> for String {
      #[inline(always)]
      fn eq(&self, other: &$ident) -> bool {
        self.as_str() == other.0.as_str()
      }
    }

    impl PartialEq<&$ident> for String {
      #[inline(always)]
      fn eq(&self, other: &&$ident) -> bool {
        self.as_str() == other.0.as_str()
      }
    }

    impl<'a> StringAppendable<'a> for &'a $ident {
      #[inline(always)]
      fn append_to_builder<TString: capacity_builder::StringType>(
        self,
        builder: &mut capacity_builder::StringBuilder<'a, TString>,
      ) {
        builder.append(self.0.as_str())
      }
    }
  };
}

#[cfg(any(unix, windows))]
mod stack_string {
  use serde::Deserializer;
  use serde::de::Error;
  use serde::de::Visitor;
  use std::fmt;

  use super::*;

  /// A 24 byte string that uses the stack when < 24 bytes.
  #[derive(
    Debug, Default, Clone, PartialOrd, Ord, PartialEq, Eq, Hash, Serialize,
  )]
  pub struct StackString(hipstr::HipStr<'static>);

  // todo(dsherret): remove once https://github.com/polazarus/hipstr/pull/38 lands
  struct StackStringVisitor;

  impl Visitor<'_> for StackStringVisitor {
    type Value = StackString;

    fn expecting(&self, formatter: &mut fmt::Formatter) -> fmt::Result {
      formatter.write_str("a string")
    }

    #[inline(always)]
    fn visit_str<E>(self, v: &str) -> Result<Self::Value, E>
    where
      E: Error,
    {
      Ok(StackString::from_str(v))
    }
  }

  impl<'de> serde::Deserialize<'de> for StackString {
    #[inline(always)]
    fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
    where
      D: Deserializer<'de>,
    {
      deserializer.deserialize_str(StackStringVisitor)
    }
  }

  shared!(StackString);

  impl StackString {
    #[inline(always)]
    pub fn with_capacity(size: usize) -> Self {
      Self(hipstr::HipStr::with_capacity(size))
    }

    #[inline(always)]
    pub fn from_static(s: &'static str) -> Self {
      Self(hipstr::HipStr::from_static(s))
    }

    /// Creates a `StackString` from a `&str`.
    #[inline(always)]
    #[allow(clippy::should_implement_trait)]
    pub fn from_str(s: &str) -> Self {
      Self(hipstr::HipStr::from(s))
    }

    /// Creates a `StackString` from a `String`.
    ///
    /// Generally you don't want to end up with a `String` in the first
    /// place, which is why this struct doesn't implement `From<String>`
    #[inline(always)]
    pub fn from_string(s: String) -> Self {
      Self(hipstr::HipStr::from(s))
    }

    pub fn replace(&self, from: &str, to: &str) -> Self {
      // hipstr currently doesn't have a targeted replace method
      Self(self.0.replace(from, to).into())
    }

    pub fn into_string(self) -> String {
      match self.0.into_string() {
        Ok(value) => value,
        Err(existing) => existing.to_string(),
      }
    }
  }

  impl StringType for StackString {
    type MutType = hipstr::HipStr<'static>;

    #[inline(always)]
    fn with_capacity(
      size: usize,
    ) -> Result<Self::MutType, std::collections::TryReserveError> {
      Ok(hipstr::HipStr::with_capacity(size))
    }

    #[inline(always)]
    fn from_mut(inner: Self::MutType) -> Self {
      Self(inner)
    }
  }

  // Note: Do NOT implement `From<String>` in order to discourage its use
  // because we shouldn't end up with a `String` in the first place.

  // It would be nice to only implement this for 'static strings, but unfortunately
  // rust has trouble giving nice error messages when trying to do that and requiring
  // having to write `StackString::from_str` in test code instead of `"something".into()`
  // is not very nice.
  impl From<&str> for StackString {
    #[inline(always)]
    fn from(s: &str) -> Self {
      Self(hipstr::HipStr::from(s))
    }
  }
}

mod small_stack_string {
  use super::*;

  /// A 16 byte string that uses the stack when < 16 bytes.
  #[derive(
    Debug,
    Default,
    Clone,
    PartialOrd,
    Ord,
    PartialEq,
    Eq,
    Hash,
    Serialize,
    Deserialize,
  )]
  pub struct SmallStackString(ecow::EcoString);

  shared!(SmallStackString);

  impl SmallStackString {
    #[inline(always)]
    pub fn from_static(s: &'static str) -> Self {
      Self(ecow::EcoString::from(s))
    }

    #[inline(always)]
    pub fn with_capacity(size: usize) -> Self {
      Self(ecow::EcoString::with_capacity(size))
    }

    /// Creates a `SmallStackString` from a `&str`.
    #[inline(always)]
    #[allow(clippy::should_implement_trait)]
    pub fn from_str(s: &str) -> Self {
      Self(ecow::EcoString::from(s))
    }

    /// Creates a `SmallStackString` from a `String`.
    ///
    /// Generally you don't want to end up with a `String` in the first
    /// place, which is why this struct doesn't implement `From<String>`
    #[inline(always)]
    pub fn from_string(s: String) -> Self {
      Self(ecow::EcoString::from(s))
    }

    pub fn replace(&self, from: &str, to: &str) -> Self {
      Self(self.0.replace(from, to))
    }

    pub fn into_string(self) -> String {
      self.0.into()
    }
  }

  impl StringType for SmallStackString {
    type MutType = ecow::EcoString;

    #[inline(always)]
    fn with_capacity(
      size: usize,
    ) -> Result<Self::MutType, std::collections::TryReserveError> {
      Ok(ecow::EcoString::with_capacity(size))
    }

    #[inline(always)]
    fn from_mut(inner: Self::MutType) -> Self {
      Self(inner)
    }
  }

  // Note: Do NOT implement `From<String>` in order to discourage its use
  // because we shouldn't end up with a `String` in the first place.

  // It would be nice to only implement this for 'static strings, but unfortunately
  // rust has trouble giving nice error messages when trying to do that and requiring
  // having to write `SmallStackString::from_str` in test code instead of `"something".into()`
  // is not very nice.
  impl From<&str> for SmallStackString {
    #[inline(always)]
    fn from(s: &str) -> Self {
      Self(ecow::EcoString::from(s))
    }
  }
}

// This module is for comparing the implementations above with a regular `String`.
// For example, do `pub regular_string::RegularString as StackString;`
mod regular_string {
  use super::*;

  #[derive(
    Debug,
    Default,
    Clone,
    PartialOrd,
    Ord,
    PartialEq,
    Eq,
    Hash,
    Serialize,
    Deserialize,
  )]
  pub struct RegularString(String);

  shared!(RegularString);

  impl RegularString {
    #[inline(always)]
    pub fn from_static(s: &'static str) -> Self {
      Self(String::from(s))
    }

    #[inline(always)]
    pub fn with_capacity(size: usize) -> Self {
      Self(String::with_capacity(size))
    }

    /// Creates a `SmallStackString` from a `&str`.
    #[inline(always)]
    #[allow(clippy::should_implement_trait)]
    pub fn from_str(s: &str) -> Self {
      Self(String::from(s))
    }

    /// Creates a `SmallStackString` from a `String`.
    ///
    /// Generally you don't want to end up with a `String` in the first
    /// place, which is why this struct doesn't implement `From<String>`
    #[inline(always)]
    pub fn from_string(s: String) -> Self {
      Self(s)
    }

    pub fn replace(&self, from: &str, to: &str) -> Self {
      Self(self.0.replace(from, to))
    }

    pub fn into_string(self) -> String {
      self.0
    }
  }

  impl StringType for RegularString {
    type MutType = String;

    #[inline(always)]
    fn with_capacity(
      size: usize,
    ) -> Result<Self::MutType, std::collections::TryReserveError> {
      Ok(String::with_capacity(size))
    }

    #[inline(always)]
    fn from_mut(inner: Self::MutType) -> Self {
      Self(inner)
    }
  }

  impl From<&str> for RegularString {
    #[inline(always)]
    fn from(s: &str) -> Self {
      Self(String::from(s))
    }
  }
}

// this is here to allow easily swapping implementations
pub use small_stack_string::SmallStackString;

#[cfg(not(any(unix, windows)))]
pub use regular_string::RegularString as StackString;
#[cfg(any(unix, windows))]
pub use stack_string::StackString;