Struct Engine 

pub struct Engine { /* private fields */ }

Implementations

impl Engine

pub async fn abstracts(&self, works: &[&SourceRecord]) -> AbstractsReport

The abstract for each work: its own record’s if present, otherwise the first other provider’s (by priority) that has one. Works are identified by their records’ identifiers; pass a record with merged identifiers to widen the search.

impl Engine

pub async fn check( &self, claims: &[Claim], limit: u32, progress: impl FnMut(usize), ) -> Vec<Checked>

Verifies every claim and derives findings, including duplicates across claims. progress is called with each claim’s index as it completes.

impl Engine

pub async fn resolve(&self, claim: &Claim, limit: u32) -> ResolveReport

Gathers and scores every candidate for claim. limit caps results per provider search.

pub async fn verify(&self, claim: &Claim, limit: u32) -> Verification

Decides whether claim refers to a real work, stopping early once it does.

pub fn verify_many<'a>( &'a self, claims: &'a [Claim], limit: u32, ) -> impl Stream<Item = Verification> + 'a

Verifies many claims, several at a time (each provider’s pacing still applies), yielding results in claim order as they complete.

pub async fn prefetch(&self, claims: &[Claim]) -> LookupReport

Looks up every identifier the claims assert, in one batched call per provider. With a cache attached, this warms it so verifying the claims one by one (and streaming results) doesn’t look them up one by one.

impl Engine

pub async fn latest_versions(&self, works: &[&SourceRecord]) -> VersionsReport

The latest version of each work its record says is superseded (Work::newer_version), asking the providers that report notices. One batched lookup per step along the chains.

impl Engine

pub fn builder() -> EngineBuilder

pub fn providers(&self) -> impl Iterator<Item = &Arc<dyn Provider>>

Registered providers, in priority order.

pub async fn lookup(&self, ids: &[WorkId], fields: FieldSet) -> LookupReport

Looks up every ID, falling through providers by priority. Never fails as a whole: per-ID outcomes are in the report.

pub async fn add_notices(&self, report: &mut LookupReport)

Adds editorial notices, in both directions, to records that another provider supplied, from the providers that report them in detail (Crossref): an original then lists its corrections and retractions, a correction the work it corrects. Batched and cached, like lookups.

pub async fn add_open_access(&self, report: &mut LookupReport)

Fills in where works can be read free, for records whose provider didn’t say, from the first provider (by priority) that does.

pub async fn search( &self, source: Option<&str>, query: &SearchQuery, ) -> Result<SearchReport, EngineError>

Searches one provider: source if given, otherwise the first that supports the query’s mode.