Crate doi

Digital Object Identifier (DOI) resolver for Rust

This crate provides a simple way to resolve DOIs and retrieve metadata using the DOI APIs.

Basic Usage

The following is a basic example of using this library:

use doi::Doi;
let doi = Doi::new("10.1109/TCSII.2024.3366282");
match doi.resolve() {
    Ok(resolved) => println!("Resolved Link: {}", resolved),
    Err(e) => eprintln!("Error: {}", e),
}

Please refer to the API documentation for more information. More complicated constructions can be done using the DoiBuilder struct.

Metadata

This library also provides a way to retrieve metadata for a DOI. The metadata feature is required to use this functionality (enabled by default).

use doi::Doi;
let doi = Doi::new("10.1109/TCSII.2024.3366282");
match doi.metadata() {
    Ok(metadata) => println!("Paper Title: {}", metadata.title.unwrap_or("<unknown>".to_string())),
    Err(e) => eprintln!("Error: {}", e),
}

The raw JSON metadata can be retrieved using the metadata_json method, powered by serde_json.

use doi::Doi;
let doi = Doi::new("10.1109/TCSII.2024.3366282");
match doi.metadata_json() {
    Ok(metadata) => println!("Metadata: {}", metadata),
    Err(e) => eprintln!("Error: {}", e),
}

Blocking Requests

This library is designed to use blocking I/O, depending on the ureq library for HTTP requests.

License

This project is licensed under the MIT license.

Structs

Doi

Digital Object Identifier (DOI) is a unique identifier for a digital object such as a document.

DoiBuilder

Builder for the Doi struct.

DoiMetadata

Metadata for a DOI.

DoiMetadataPerson

Metadata for a person.

Enums

DoiMetadataType

Metadata type for a DOI.

JsonValue

Represents any valid JSON value.