use core::fmt;
use serde::{Deserialize, Serialize};
#[derive(Clone, Copy, Debug, PartialEq, Eq, Serialize, Deserialize)]
pub struct PageQuery {
pub page: u32,
pub size: u32,
}
impl PageQuery {
pub const MAX_SIZE: u32 = 2000;
#[must_use]
pub const fn new() -> Self {
Self { page: 0, size: Self::MAX_SIZE }
}
#[must_use]
pub const fn with_size(size: u32) -> Self {
Self::at(0, size)
}
#[must_use]
pub const fn at(page: u32, size: u32) -> Self {
Self { page, size: if size > Self::MAX_SIZE { Self::MAX_SIZE } else { size } }
}
#[must_use]
pub const fn next(self) -> Self {
Self { page: self.page + 1, size: self.size }
}
#[must_use]
pub fn to_query_string(self) -> String {
format!("page={}&size={}", self.page, self.size)
}
#[must_use]
pub fn append_to(self, url: &str) -> String {
let separator = if url.contains('?') { '&' } else { '?' };
format!("{url}{separator}{}", self.to_query_string())
}
}
impl Default for PageQuery {
fn default() -> Self {
Self::new()
}
}
impl fmt::Display for PageQuery {
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
write!(f, "page={}&size={}", self.page, self.size)
}
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn the_query_matches_the_form_the_spec_documents() {
assert_eq!(PageQuery::at(0, 20).to_query_string(), "page=0&size=20");
}
#[test]
fn a_crawl_walks_pages_at_a_fixed_size() {
let first = PageQuery::with_size(500);
assert_eq!(first.page, 0);
let second = first.next();
assert_eq!((second.page, second.size), (1, 500));
}
#[test]
fn a_size_above_the_documented_maximum_is_clamped() {
assert_eq!(PageQuery::with_size(5000).size, PageQuery::MAX_SIZE);
assert_eq!(PageQuery::at(3, 5000).size, PageQuery::MAX_SIZE);
assert_eq!(PageQuery::with_size(500).size, 500);
assert_eq!(PageQuery::new().size, PageQuery::MAX_SIZE);
}
#[test]
fn appending_picks_the_right_separator() {
assert_eq!(PageQuery::at(1, 20).append_to("https://x/y"), "https://x/y?page=1&size=20");
assert_eq!(PageQuery::at(1, 20).append_to("https://x/y?a=b"), "https://x/y?a=b&page=1&size=20");
}
}