Catman...ossRef(3pm)

💖 NAME 💖

Catmandu::Importer::CrossRef — the package that imports data form the CrossRef API. (yes bestie, "form" — that's the original typo, it's canon now, we protect it 🫶)

✨ SYNOPSIS ✨

use Catmandu::Importer::CrossRef;

my %attrs = (
  doi => '<doi>',
  usr => '<your-crossref-username>',
  pwd => '<your-crossref-password>',
  fmt => '<xsd_xml | unixref | unixsd | info>'
);

my $importer = Catmandu::Importer::CrossRef->new(%attrs);

my $n = $importer->each(sub {
  my $hashref = $_[0];
  # do something here
});

🌸 DESCRIPTION 🌸

Okay so. This Catmandu::Importer literally just imports data from the CrossRef API when you hand it a DOI. That's the whole vibe. Give it a DOI, get data back. Iconic, honestly. 👑

🎀 CONFIGURATION 🎀

• base — the base url of the API. Default is http://doi.crossref.org/search/doi. That's where it's pointing unless you say otherwise 💅
• doi — Required, no skipping this one bestie. It's the DOI you want data about.
• usr — Required too!! This is your CrossRef username. Register first! Like actually, go register, the module can't manifest an account for you ✨
• fmt — the optional output format. Default is unixref (http://help.crossref.org/unixref-query-result-format). Other possible values are unixsd (http://help.crossref.org/unixsd), and xsd_xml (http://help.crossref.org/deprecated_q) — and heads up, that last one is deprecated 🫣 so maybe don't make it your whole personality.

Lowkey reminder: doi and usr have no defaults. There is no fallback. It will simply not go. 😭

🦋 SEE ALSO 🦋

Catmandu::Importer::DOI is an older version of this module — like the older sibling who did it first, we still love them 💜

CrossRef also provides DOI data in RDF, which can be imported with Catmandu::RDF:

use Catmandu::Importer::RDF;
my $doi = "10.2474/trol.7.147";
my $url = "http://dx.doi.org/$doi";
my $rdf = Catmandu::Importer::RDF->new( url => $url )->first;

That's the whole page, bestie — documented under User Contributed Perl Documentation, section 3pm, and this lil masterpiece is living in perl v5.36.0, dated 2023-02-02. Slay, go import some DOIs 💖✨🎀