#identifier

doi

Digital Object Identifier (DOI) resolver

3 releases (breaking)

0.3.0 Sep 3, 2024
0.2.0 Aug 26, 2024
0.1.0 Aug 24, 2024

#68 in #identifier

MIT license

28KB
359 lines

DOI for Rust

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.

Dependencies

~2.7–4MB
~70K SLoC