Usage

Create aCrossref client:

let client =Crossref::builder().build()?;

let client =Crossref::builder().token("token").build()?;

let client =Crossref::builder().polite("polite@example.com").token("your token").build()?;

Constructing Queries

let query =WorksQuery::new("Machine Learning")// field queries supported for `Works`.field_query(FieldQuery::author("Some Author"))// filters are specific for each resource component.filter(WorksFilter::HasOrcid).order(Order::Asc).sort(Sort::Score);

Get Records

pubenumMembers{/// target a specific member at `/members/{id}`Identifier(String),/// target all members that match the query at `/members?query...`Query(MembersQuery),/// target a `Work` for a specific member at `/members/{id}/works?query..`Works(WorksIdentQuery),}

Examples

let work = client.work("10.1037/0003-066X.59.1.29")?;let agency = client.work_agency("10.1037/0003-066X.59.1.29")?;let funder = client.funder("funder_id")?;let member = client.member("member_id")?;

let query =WorksQuery::new("Machine Learning");// one page of the matching resultslet works = client.works(query)?;

let works = client.works("Machine Learning")?;

use crossref::*;fn run() -> Result<()> {    let client = Crossref::builder().build()?;    let works = client.member_works(WorksQuery::new("machine learning")    .sort(Sort::Score).into_ident("member_id"))?;    Ok(())}

use crossref::*;fnrun() ->Result<()>{let client =Crossref::builder().build()?;let works = client.works(WorksQuery::new("machine learning").sort(Sort::Score).into_combined_query::<Members>("member_id"))?;Ok(())}

use crossref::{Crossref,WorksQuery,Work};fnrun() ->Result<(), crossref::Error>{let client =Crossref::builder().build()?;let all_works:Vec<Work> = client.deep_page(WorksQuery::new("Machine Learning")).flat_map(|x|x.items).collect();Ok(())}

use crossref::{Crossref,WorksQuery,Work};fnrun() ->Result<(), crossref::Error>{let client =Crossref::builder().build()?;let all_works:Vec<Work> = client.deep_page("Machine Learning").into_work_iter().collect();Ok(())}

use crossref::{Crossref,Funders,WorksQuery,Work,WorkList};fnrun() ->Result<(), crossref::Error>{let client =Crossref::builder().build()?;let all_funder_work_list:Vec<WorkList> = client.deep_page(WorksQuery::default().into_combined_query::<Funders>("funder id")).collect();Ok(())}

use crossref::{Crossref,Funders,WorksQuery,Work,WorkList};fnrun() ->Result<(), crossref::Error>{let client =Crossref::builder().build()?;let all_works:Vec<Work> = client.deep_page(WorksQuery::default().into_combined_query::<Funders>("funder id")).into_work_iter().collect();Ok(())}

Command Line Application

Installation

cargo install crossref --features cli

Usage

USAGE:    crossref <SUBCOMMAND>FLAGS:    -h, --help       Prints help information    -V, --version    Prints version informationSUBCOMMANDS:    funders     Query crossref funders    help        Prints this message or the help of the given subcommand(s)    journals    Query crossref journals    members     Query crossref members    prefixes    Query crossref prefixes    types       Query crossref types    works       Query crossref works

USAGE:    crossref works [FLAGS] [OPTIONS] [SUBCOMMAND]FLAGS:    -a, --append       if the output file already exists, append instead of overwriting the file    -d, --deep-page    Enable deep paging. If a limit is set, then the limit takes priority.    -h, --help         Prints help information    -s, --silent       do not print anything    -V, --version      Prints version informationOPTIONS:    -i, --id <id>                    The id of component.    -l, --limit <limit>              limit the amount of results        --offset <offset>            Sets an offset where crossref begins to retrieve items.        --order <order>              How to order the results: asc or desc    -o <output>                      output path where the results shall be stored        --polite <polite>            The email to use to get into crossref's polite pool    -q, --query <query_terms>...     The free form terms for the query        --sample <sample>            Request randoms Elements. Overrides all other options.        --sort <sort>                How to sort the results, such as updated, indexed, published, issued        --token <token>              The token to use for the crossref client        --user-agent <user_agent>    The user agent to use for the crossref client

Examples

 crossref works --id"10.1037/0003-066X.59.1.29"

 crossref works --id"10.1037/0003-066X.59.1.29" -o output.json

 crossref<works|journals|members|prefixes|types> --id"10.1037/0003-066X.59.1.29" -o output.json

crossref <works|funders|members> --query "A search term such as `Machine learning` for works" --limit 10 --offset 200 --order asc

crossref works member 98

License