use url::Url;
use crate::cli::SortKind;
use crate::config::MAX_PER_PAGE;
use crate::domain::{AllowedOrigin, SearchQuery};
use crate::error::{AppError, AppResult, ErrorDetail, InternalOp, Subject};
pub fn clamp_search_pagination(per_page: u32, page: u32) -> (u32, u32) {
(per_page.clamp(1, MAX_PER_PAGE), page.max(1))
}
pub fn validate_search_pagination(per_page: u32, page: u32) -> AppResult<(u32, u32)> {
if page < 1 {
return Err(AppError::of(ErrorDetail::PageBelowOne));
}
if !(1..=MAX_PER_PAGE).contains(&per_page) {
return Err(AppError::of(ErrorDetail::PerPageOutOfRange {
max: MAX_PER_PAGE,
got: per_page,
}));
}
Ok((per_page, page))
}
fn crates_api_base(origin: &AllowedOrigin) -> String {
format!("{}/api/v1/crates", origin.as_str().trim_end_matches('/'))
}
pub fn planned_url(
query: &SearchQuery,
per_page: u32,
sort: SortKind,
page: u32,
) -> AppResult<Url> {
planned_url_on_host(
&AllowedOrigin::crates_io_default(),
query,
per_page,
sort,
page,
)
}
pub fn planned_url_on_host(
origin: &AllowedOrigin,
query: &SearchQuery,
per_page: u32,
sort: SortKind,
page: u32,
) -> AppResult<Url> {
let (per_page, page) = clamp_search_pagination(per_page, page);
let base = crates_api_base(origin);
let mut url = Url::parse(&base).map_err(|e| {
AppError::of_with_source(
ErrorDetail::Internal {
op: InternalOp::UrlBuild,
},
e,
)
})?;
{
let mut q = url.query_pairs_mut();
q.append_pair("q", query.as_str());
q.append_pair("per_page", &per_page.to_string());
q.append_pair("sort", sort.as_api_str());
q.append_pair("page", &page.to_string());
}
Ok(url)
}
pub fn planned_url_with_page_token(
origin: &AllowedOrigin,
query: &SearchQuery,
per_page: u32,
sort: SortKind,
page_token: &str,
) -> AppResult<Url> {
let token = page_token.trim();
if token.is_empty() {
return Err(AppError::of(ErrorDetail::Empty {
subject: Subject::PageToken,
}));
}
if token.chars().any(|c| c.is_control()) || token.len() > crate::config::MAX_URL_FIELD_CHARS {
return Err(AppError::of(ErrorDetail::ControlCharacters {
subject: Subject::PageToken,
}));
}
if let Ok(page) = token.parse::<u32>() {
return planned_url_on_host(origin, query, per_page, sort, page);
}
let base = crates_api_base(origin);
let base_url = Url::parse(&base).map_err(|e| {
AppError::of_with_source(
ErrorDetail::Internal {
op: InternalOp::UrlBuild,
},
e,
)
})?;
let qs = token.trim_start_matches('?');
if qs.contains('=') {
let mut url = base_url;
url.set_query(Some(qs));
return Ok(url);
}
let (per_page, _) = clamp_search_pagination(per_page, 1);
let mut url = base_url;
{
let mut q = url.query_pairs_mut();
q.append_pair("q", query.as_str());
q.append_pair("per_page", &per_page.to_string());
q.append_pair("sort", sort.as_api_str());
q.append_pair("seek", qs);
}
Ok(url)
}