Struct UnpaywallSource 

pub struct UnpaywallSource { /* private fields */ }

Unpaywall Source impl.

Implementations

impl UnpaywallSource

pub fn new(contact_email: String) -> Self

Production constructor. The contact_email is REQUIRED for the polite pool — Unpaywall returns 403 without it.

pub fn with_base(base: Url, contact_email: String) -> Self

Construct with an arbitrary base URL.

The orchestrator (doiget-cli::commands::fetch) uses this to honor the DOIGET_UNPAYWALL_BASE env var, which lets integration tests point the source at a wiremock origin without compile-time gates. Production callers use UnpaywallSource::new.

Trait Implementations

impl Clone for UnpaywallSource

fn clone(&self) -> UnpaywallSource

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UnpaywallSource

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Source for UnpaywallSource

fn name(&self) -> &str

Stable name used in metadata ([doiget].source) and provenance rows. Conventional values: "crossref", "unpaywall", "arxiv", "openalex", "semantic-scholar", "doaj", "tdm-elsevier", etc. (see docs/SOURCES.md).

fn can_serve(&self, _profile: &CapabilityProfile, ref_: &Ref) -> bool

True if this source can plausibly serve the given ref under the runtime capability profile. Implementations MUST be fast and non-blocking; the orchestrator calls can_serve to decide whether to invoke fetch at all.

fn fetch<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, ref_: &'life1 Ref, _profile: &'life2 CapabilityProfile, ctx: &'life3 FetchContext, ) -> Pin<Box<dyn Future<Output = Result<FetchResult, FetchError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

Perform the source-specific fetch.