use serde::{Deserialize, Serialize};
use url::Url;
#[derive(Debug, Clone, Default, PartialEq, Serialize, Deserialize)]
#[non_exhaustive]
pub struct SearchResults {
#[serde(default)]
pub content: Vec<SearchEntry>,
}
impl SearchResults {
pub fn len(&self) -> usize {
self.content.len()
}
pub fn is_empty(&self) -> bool {
self.content.is_empty()
}
pub fn entries(&self) -> &[SearchEntry] {
&self.content
}
pub fn into_entries(self) -> Vec<SearchEntry> {
self.content
}
pub fn urls(&self) -> Vec<Url> {
self.content.iter().filter_map(|e| e.url()).collect()
}
}
impl IntoIterator for SearchResults {
type Item = SearchEntry;
type IntoIter = std::vec::IntoIter<SearchEntry>;
fn into_iter(self) -> Self::IntoIter {
self.content.into_iter()
}
}
#[derive(Debug, Clone, Default, PartialEq, Serialize, Deserialize)]
#[non_exhaustive]
pub struct SearchEntry {
#[serde(default)]
pub title: Option<String>,
#[serde(default)]
pub description: Option<String>,
#[serde(default, deserialize_with = "null_as_empty")]
pub url: String,
}
fn null_as_empty<'de, D: serde::Deserializer<'de>>(deserializer: D) -> Result<String, D::Error> {
Ok(Option::<String>::deserialize(deserializer)?.unwrap_or_default())
}
impl SearchEntry {
pub fn url(&self) -> Option<Url> {
Url::parse(&self.url).ok()
}
}
#[cfg(test)]
mod tests {
#![allow(
clippy::unwrap_used,
clippy::expect_used,
clippy::panic,
clippy::unreachable,
clippy::indexing_slicing,
clippy::string_slice
)]
use super::*;
#[test]
fn reads_the_wire_shape() {
let json = r#"{"content":[
{"title":"Example","description":"A page","url":"https://example.com/a"},
{"url":"not a url"}
]}"#;
let results: SearchResults = serde_json::from_str(json).expect("search results");
assert_eq!(results.len(), 2);
assert_eq!(results.entries()[0].title.as_deref(), Some("Example"));
assert!(results.entries()[1].title.is_none());
assert_eq!(results.urls().len(), 1);
}
#[test]
fn a_null_field_on_one_entry_does_not_lose_the_whole_list() {
let json = r#"{"content":[
{"title":null,"description":null,"url":null},
{"title":"Example","url":"https://example.com/a"}
]}"#;
let results: SearchResults = serde_json::from_str(json).expect("search results");
assert_eq!(results.len(), 2);
assert_eq!(results.entries()[0].url, "");
assert!(results.entries()[0].url().is_none());
assert_eq!(results.urls().len(), 1);
}
#[test]
fn an_absent_list_reads_as_no_results() {
let results: SearchResults = serde_json::from_str("{}").expect("search results");
assert!(results.is_empty());
assert_eq!(results.into_entries().len(), 0);
}
}