Struct CrossrefClient 

pub struct CrossrefClient { /* private fields */ }

High-level API client.

Wraps the synchronous crossref::Crossref client (created fresh per blocking call) and a shared reqwest::Client for async Unpaywall queries.

Implementations

impl CrossrefClient

pub fn new(config: Arc<Config>) -> Result<Self>

Construct a new client from the resolved configuration.

pub fn new_with_base_urls( config: Arc<Config>, crossref_url: Option<String>, unpaywall_url: Option<String>, ) -> Result<Self>

Construct a client with custom base URLs (for testing and integration environments).

pub async fn fetch_work(&self, doi: &str) -> Result<WorkMeta>

Fetch metadata for a single DOI, then enrich with Unpaywall OA data.

pub async fn fetch_works(&self, dois: &[&str]) -> Vec<Result<WorkMeta>>

Fetch metadata for multiple DOIs, returning results in order.

pub async fn search(&self, query: &SearchQuery) -> Result<SearchResult>

Execute a search query and return a page of results.

pub async fn fetch_unpaywall(&self, doi: &str) -> Result<UnpaywallRecord>

Query Unpaywall for OA information about a DOI.

pub async fn download_pdf(&self, doi: &str, dest_dir: &Path) -> Result<PathBuf>

Download the best OA PDF to dest_dir / <DOI>.pdf.

Falls back to EZproxy if the direct URL returns a non-200 status, and finally returns a https://doi.org/{doi} link if no PDF is accessible.

Returns the path where the file was written, or the best-effort URL if the PDF was not downloaded.