Struct ArxivSource 

pub struct ArxivSource { /* private fields */ }

arXiv Source impl. Phase 1 returns the PDF bytes and skips metadata (the export.arxiv.org Atom feed is documented but XML parsing is deferred to a follow-up PR — TODO Phase 1+).

Implementations

impl ArxivSource

pub fn new() -> Self

Production constructor. Uses the public arxiv.org PDF endpoint.

pub fn with_base(base: Url) -> Self

Construct with an arbitrary base URL.

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

pub async fn fetch_metadata_only( &self, id: &ArxivId, ctx: &FetchContext, ) -> Result<Value, FetchError>

Fetch ONLY the Atom-feed metadata for the given arXiv id. Does NOT touch the PDF endpoint — this is the entry point for the metadata_only orchestrator (docs/MCP_TOOLS.md §11).

Emits a single LogEvent::Fetch row under Capability::Metadata so the audit trail distinguishes metadata-only attempts from full (PDF) fetches.

Errors

• FetchError::Http on transport / status / size-cap failures.
• FetchError::SourceSchema if the response body is not well-formed Atom XML.
• FetchError::Log if the provenance row write fails (fail-closed per docs/PROVENANCE_LOG.md §5).

Trait Implementations

impl Clone for ArxivSource

fn clone(&self) -> ArxivSource

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ArxivSource

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

Formats the value using the given formatter.

impl Default for ArxivSource

fn default() -> Self

Returns the “default value” for a type.

impl Source for ArxivSource

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.