lucia 0.5.0

use core::{num::NonZeroU16, time::Duration};

/// Determines how many times a series of requests can be performed within a certain duration
#[derive(Clone, Copy, Debug)]
pub struct RequestLimit {
  duration: Duration,
  limit: NonZeroU16,
}

impl RequestLimit {
  /// If `duration` is zero then this structure will basically be a no-op.
  ///
  /// Limits must start at 1 to always be at least one request.
  #[inline]
  pub fn new(limit: u16, duration: Duration) -> crate::Result<Self> {
    Ok(Self { duration, limit: limit.try_into()? })
  }

  /// Useful for tests.
  #[
    // u16::MAX is greater than 0
    allow(clippy::missing_panics_doc, clippy::unwrap_used)
  ]
  #[inline]
  pub fn unlimited() -> Self {
    Self { duration: Duration::from_secs(0), limit: NonZeroU16::new(u16::MAX).unwrap() }
  }

  /// The interval range that can contain a maximum number of [Self::limit] requests
  #[inline]
  pub const fn duration(&self) -> &Duration {
    &self.duration
  }

  /// Upper bound or maximum possible number of requests
  #[inline]
  pub fn limit(&self) -> u16 {
    self.limit.into()
  }
}

#[test]
fn limit_can_not_be_zero() {
  assert!(RequestLimit::new(0, <_>::default()).is_err())
}