Struct EuropePmcClient 

pub struct EuropePmcClient { /* private fields */ }

Client for the Europe PMC REST API.

Provides cross-source search, JATS full-text retrieval, reference and citation graphs, external database links, and supplementary file downloads. No API key is required; transport-level configuration (timeout, user agent, retry, rate limiting, caching) is shared with the rest of the workspace via ClientConfig.

Example

use pubmed_client::europe_pmc::{EuropePmcClient, EuropePmcId};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = EuropePmcClient::new();
    let results = client.search("malaria vaccine", 10).await?;
    for r in &results {
        println!("{}/{}: {}", r.source, r.id, r.title.as_deref().unwrap_or(""));
    }

    let article = client.fetch_full_text(&EuropePmcId::pmc("PMC3258128")?).await?;
    println!("Title: {}", article.title().unwrap_or("Untitled"));
    Ok(())
}

Implementations

impl EuropePmcClient

pub async fn get_citations_page( &self, id: &EuropePmcId, page: u32, page_size: u32, ) -> Result<EuropePmcCitationList>

Fetch a single page of the citation list (citing articles) for a record.

pub async fn get_citations( &self, id: &EuropePmcId, ) -> Result<Vec<EuropePmcCitation>>

Fetch all citing articles for a record, following page numbers until exhausted.

impl EuropePmcClient

pub fn new() -> Self

Create a new Europe PMC client with default configuration.

pub fn with_config(config: ClientConfig) -> Self

Create a new Europe PMC client with custom configuration.

Transport settings (timeout, user agent, retry, rate limit, cache) are taken from config. The NCBI-specific base_url field is ignored; the Europe PMC base URL is used instead.

pub fn with_client(client: Client) -> Self

Create a new Europe PMC client with a custom HTTP client and default config.

pub fn with_base_url(self, base_url: String) -> Self

Override the base URL (e.g. to target a proxy or a wiremock test server).

pub async fn clear_cache(&self)

Clear the full-text cache, if one is configured.

pub fn cache_entry_count(&self) -> u64

Return the number of cached full-text entries (best-effort).

pub async fn sync_cache(&self)

Flush pending cache operations (useful in tests).

impl EuropePmcClient

pub async fn fetch_full_text(&self, id: &EuropePmcId) -> Result<PmcArticle>

Fetch and parse the full text of a Europe PMC record into a PmcArticle.

Europe PMC serves full text as JATS XML, which is parsed by the same parser used for NCBI PMC. Parsing into a PmcArticle requires a PMC id, so this method only supports PMC-sourced records; for other sources use EuropePmcClient::fetch_full_text_xml to get the raw JATS instead.

Results are cached when a cache is configured (key epmc-ft:<source>:<id>).

Errors

• ParseError::PmcNotAvailable — the record is not PMC-sourced.
• crate::PubMedError::ApiError — the HTTP request failed.

pub async fn fetch_full_text_xml(&self, id: &EuropePmcId) -> Result<String>

Fetch the raw JATS XML full text for a Europe PMC record.

Works for any source that has full text available. Returns the response body verbatim.

Unlike the list endpoints, Europe PMC addresses full text by the record id alone (/{id}/fullTextXML) rather than by (source, id); a source-qualified path answers 404.

impl EuropePmcClient

pub async fn get_database_links_page( &self, id: &EuropePmcId, page: u32, page_size: u32, ) -> Result<EuropePmcDatabaseLinkList>

Fetch a single page of external database cross-references for a record.

pub async fn get_database_links( &self, id: &EuropePmcId, ) -> Result<Vec<EuropePmcDatabaseLink>>

Fetch all external database cross-references for a record.

impl EuropePmcClient

pub async fn get_references_page( &self, id: &EuropePmcId, page: u32, page_size: u32, ) -> Result<EuropePmcReferenceList>

Fetch a single page of the reference list (works cited) for a record.

pub async fn get_references( &self, id: &EuropePmcId, ) -> Result<Vec<EuropePmcReference>>

Fetch all references for a record, following page numbers until exhausted.

impl EuropePmcClient

pub async fn search( &self, query: &str, limit: usize, ) -> Result<Vec<EuropePmcResult>>

Search Europe PMC and return up to limit lite results.

Convenience wrapper over EuropePmcClient::search_all using ResultType::Lite. For cursor control or core detail, use EuropePmcClient::search_page / EuropePmcClient::search_all.

pub async fn search_page( &self, query: &str, opts: &EuropePmcSearchOptions, ) -> Result<EuropePmcSearchResponse>

Fetch a single page of search results.

The returned EuropePmcSearchResponse::next_cursor_mark is the cursor to pass back via opts.cursor_mark to fetch the following page.

pub async fn search_all( &self, query: &str, max_results: usize, opts: &EuropePmcSearchOptions, ) -> Result<Vec<EuropePmcResult>>

Fetch search results across pages until max_results is reached or the result set is exhausted.

Follows the nextCursorMark chain. Europe PMC signals the end of results by returning the same cursor it was given, so the loop also stops when the cursor stops advancing.

impl EuropePmcClient

pub async fn fetch_supplementary_files( &self, id: &EuropePmcId, ) -> Result<Vec<u8>>

Fetch the supplementary-files ZIP archive for a record into memory.

Returns the raw bytes of the ZIP. As with full text, Europe PMC addresses this endpoint by the record id alone (/{id}/supplementaryFiles) rather than by (source, id).

pub async fn download_supplementary_files( &self, id: &EuropePmcId, output_path: impl AsRef<Path>, ) -> Result<PathBuf>

Download the supplementary-files ZIP archive for a record to output_path.

output_path is the full path of the ZIP file to write. Parent directories are created if needed. Returns the written path.

Trait Implementations

impl Clone for EuropePmcClient

fn clone(&self) -> EuropePmcClient

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for EuropePmcClient

fn default() -> Self

Returns the “default value” for a type.