use super::Paper;
const FIELDS: &str = "halId_s,title_s,authFullName_s,abstract_s,doiId_s,publicationDateY_i,fileMain_s,uri_s";
pub fn search(base_url: &str, query: &str, max_results: u32) -> Result<Vec<Paper>, String> {
let encoded = super::encode_query(query);
let url = format!(
"{}/search/?q={}&rows={}&wt=json&fl={}",
base_url, encoded, max_results, FIELDS
);
let mut last_err = String::new();
for attempt in 0..3 {
if attempt > 0 {
std::thread::sleep(std::time::Duration::from_millis(100 * (1 << attempt)));
}
match ureq::get(&url).call() {
Ok(resp) => {
let body = resp
.into_body()
.read_to_string()
.map_err(|e| format!("Failed to read response: {}", e))?;
return parse_search_response(&body);
}
Err(ureq::Error::StatusCode(429)) => {
last_err = "rate limited (429)".to_string();
continue;
}
Err(ureq::Error::StatusCode(code)) if code >= 500 => {
return Err(format!("Server error: {}", code));
}
Err(e) => {
return Err(format!("HTTP error: {}", e));
}
}
}
Err(last_err)
}
pub fn parse_search_response(json: &str) -> Result<Vec<Paper>, String> {
let root: serde_json::Value =
serde_json::from_str(json).map_err(|e| format!("JSON parse error: {}", e))?;
let docs = root["response"]["docs"]
.as_array()
.ok_or("missing 'response.docs' array")?;
let mut papers = Vec::new();
for item in docs {
let title = if let Some(arr) = item["title_s"].as_array() {
arr.first().and_then(|v| v.as_str()).unwrap_or("").to_string()
} else {
item["title_s"].as_str().unwrap_or("").to_string()
};
if title.is_empty() {
continue;
}
let id = item["halId_s"].as_str().unwrap_or("").to_string();
let authors: Vec<String> = item["authFullName_s"]
.as_array()
.map(|arr| {
arr.iter()
.filter_map(|a| a.as_str().map(|s| s.to_string()))
.collect()
})
.unwrap_or_default();
let doi = item["doiId_s"].as_str().map(|s| s.to_string());
let abstract_text = if let Some(arr) = item["abstract_s"].as_array() {
arr.first().and_then(|v| v.as_str()).map(|s| s.to_string())
} else {
item["abstract_s"].as_str().map(|s| s.to_string())
};
let year = item["publicationDateY_i"].as_u64().map(|y| y as u16);
let pdf_url = item["fileMain_s"].as_str().map(|s| s.to_string());
papers.push(Paper {
id,
title,
authors,
abstract_text,
year,
doi,
url: item["uri_s"].as_str().map(|s| s.to_string()),
pdf_url,
venue: None,
citations: None,
fields: vec![],
open_access: Some(true),
source: "hal".to_string(),
});
}
Ok(papers)
}
#[cfg(test)]
mod tests {
use super::*;
const FIXTURE: &str = include_str!("../../tests/fixtures/hal_search.json");
#[test]
fn parse_returns_ok() {
let result = parse_search_response(FIXTURE);
assert!(result.is_ok());
}
#[test]
fn parse_papers_not_empty() {
let papers = parse_search_response(FIXTURE).unwrap();
assert!(!papers.is_empty());
}
#[test]
fn parse_source_is_hal() {
let papers = parse_search_response(FIXTURE).unwrap();
for p in &papers {
assert_eq!(p.source, "hal");
}
}
#[test]
fn parse_id_is_hal_format() {
let papers = parse_search_response(FIXTURE).unwrap();
for p in &papers {
assert!(p.id.starts_with("hal-"), "id should start with hal-: {}", p.id);
}
}
#[test]
fn parse_title() {
let papers = parse_search_response(FIXTURE).unwrap();
for p in &papers {
assert!(!p.title.is_empty(), "paper {} has empty title", p.id);
}
}
#[test]
fn parse_authors() {
let papers = parse_search_response(FIXTURE).unwrap();
let with_authors: Vec<_> = papers.iter().filter(|p| !p.authors.is_empty()).collect();
assert!(!with_authors.is_empty(), "no papers with authors");
}
#[test]
fn parse_doi() {
let papers = parse_search_response(FIXTURE).unwrap();
let with_doi: Vec<_> = papers.iter().filter(|p| p.doi.is_some()).collect();
assert!(!with_doi.is_empty(), "no papers with DOI");
for p in &with_doi {
assert!(p.doi.as_ref().unwrap().starts_with("10."));
}
}
#[test]
fn parse_abstract() {
let papers = parse_search_response(FIXTURE).unwrap();
let with_abstract: Vec<_> = papers.iter().filter(|p| p.abstract_text.is_some()).collect();
assert!(!with_abstract.is_empty(), "no papers with abstract");
}
#[test]
fn parse_year() {
let papers = parse_search_response(FIXTURE).unwrap();
let with_year: Vec<_> = papers.iter().filter(|p| p.year.is_some()).collect();
assert!(!with_year.is_empty(), "no papers with year");
for p in &with_year {
assert!(p.year.unwrap() >= 2000);
}
}
#[test]
fn parse_pdf_url() {
let papers = parse_search_response(FIXTURE).unwrap();
let with_pdf: Vec<_> = papers.iter().filter(|p| p.pdf_url.is_some()).collect();
assert!(!with_pdf.is_empty(), "no papers with pdf_url");
}
#[test]
fn parse_open_access_always_true() {
let papers = parse_search_response(FIXTURE).unwrap();
for p in &papers {
assert_eq!(p.open_access, Some(true), "HAL papers are always OA");
}
}
#[test]
fn search_returns_papers() {
let mut server = mockito::Server::new();
let mock = server
.mock("GET", mockito::Matcher::Any)
.with_status(200)
.with_body(FIXTURE)
.create();
let papers = search(&server.url(), "test", 3).unwrap();
assert!(!papers.is_empty());
mock.assert();
}
#[test]
fn search_request_path() {
let mut server = mockito::Server::new();
let mock = server
.mock("GET", mockito::Matcher::Regex("/search/".to_string()))
.with_status(200)
.with_body(FIXTURE)
.create();
let _ = search(&server.url(), "test", 3);
mock.assert();
}
#[test]
fn search_request_contains_wt_json() {
let mut server = mockito::Server::new();
let mock = server
.mock("GET", mockito::Matcher::Regex("wt=json".to_string()))
.with_status(200)
.with_body(FIXTURE)
.create();
let _ = search(&server.url(), "test", 3);
mock.assert();
}
#[test]
fn search_request_contains_rows() {
let mut server = mockito::Server::new();
let mock = server
.mock("GET", mockito::Matcher::Regex("rows=3".to_string()))
.with_status(200)
.with_body(FIXTURE)
.create();
let _ = search(&server.url(), "test", 3);
mock.assert();
}
#[test]
fn search_request_contains_fl() {
let mut server = mockito::Server::new();
let mock = server
.mock("GET", mockito::Matcher::Regex("fl=".to_string()))
.with_status(200)
.with_body(FIXTURE)
.create();
let _ = search(&server.url(), "test", 3);
mock.assert();
}
}