Catman...er::SRU(3pm)

💖 NAME 💖

Catmandu::Importer::SRU — the package that imports SRU data, and yes bestie, that's literally the whole personality 🦋

It lives in the Perl world under manual section 3pm (User Contributed Perl Documentation), so if you were looking for it in man, that's where it's at. 💅

---

✨ SYNOPSIS ✨

okay so here's the whole vibe, look:

use Catmandu::Importer::SRU;

my %attrs = (
  base => 'http://www.unicat.be/sru',
  query => '(isbn=0855275103 or isbn=3110035170 or isbn=9010017362 or isbn=9014026188)',
  recordSchema => 'marcxml',
  parser => 'marcxml'
);

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

my $count = $importer->each(sub {
      my $schema   = $record->{recordSchema};
      my $packing  = $record->{recordPacking};
      my $position = $record->{recordPosition};
      my $data     = $record->{recordData};
  # ...
});

# Using Catmandu::Importer::SRU::Package::marcxml, included in this release

my $importer = Catmandu::Importer::SRU->new(
  base => 'http://www.unicat.be/sru',
  query => '(isbn=0855275103 or isbn=3110035170 or isbn=9010017362 or isbn=9014026188)',
  recordSchema => 'marcxml' ,
  parser => 'marcxml' ,
);

# Using a homemade parser

my $importer = Catmandu::Importer::SRU->new(
  base => 'http://www.unicat.be/sru',
  query => '(isbn=0855275103 or isbn=3110035170 or isbn=9010017362 or isbn=9014026188)',
  recordSchema => 'marcxml' ,
  parser => MyParser->new , # or parser => '+MyParser'
);

three whole ways to set it up, pick your fighter 🎀

---

🌈 DESCRIPTION 🌈

This Catmandu::Importer imports records via SRU. that's it, that's the job, and it does it gorgeously ✨

SRU diagnostics are emitted as warnings — except for when parser is set to "meta". noted, so you're not out here confused when your terminal starts yelling at you 😭

---

🧚 CONFIGURATION 🧚

every knob you can turn, in order, no skips, we don't do skips here 👑

• base — the base URL of the SRU server. required, so like, don't forget it 💀
• query — the CQL query. also required. both of these are non-negotiable bestie 🫶
• limit — how many records get fetched in one batch. defaults to 10. this gets translated into the SRU request parameter "maximumRecords".

Records come in multiple batches of this size, or smaller. so if you set a limit, that's the ceiling per batch, not the total. iykyk ✨

• total — the total number of records this importer may return.

Not set by default. so it's a free-for-all unless you cap it 🌸

• recordSchema — set to "dc" by default 🎀
• sortkeys — optional sorting. optional!! no pressure 💜
• operation — set to "searchRetrieve" by default 🌟
• version — set to 1.1 by default ⭐
• userAgent — the HTTP user agent, set to "Mozilla/5.0" by default. yes, it's cosplaying as a browser, let it live 🦋
• http_client — an instance of HTTP::Tiny or a compatible class to fetch URLs with. bring your own, if you want 🔥
• parser — this one controls how records get parsed before importing. the options are:
  • An instance of a Perl package that implements a parse subroutine. peep the default value Catmandu::Importer::SRU::Parser if you want an example 👀
  • The name of a Perl package that implements a parse subroutine. the name must be prepended with "+", or it gets prefixed with Catmandu::Importer::SRU::Parser::. for instance, "marcxml" will create a Catmandu::Importer::SRU::Parser::marcxml. that's the glow-up pipeline ✨
  • A function reference that gets passed the unparsed record. roll your own, main character energy 💅

---

👑 METHODS 👑

All methods of Catmandu::Importer and, by extension, Catmandu::Iterable are inherited. they're yours now, no cap 🫶

On top of those, here's the extra:

💜 url

Return the current SRU request URL. useful for debugging — literally the "what am i even requesting rn" button, obsessed 🔍

---

🔥 SEE ALSO 🔥

• Catmandu::Importer
• Catmandu::Iterable
• <http://www.loc.gov/standards/sru/>

---

okay and for the cute sign-off: this whole thing is documented as perl v5.38.2, dated 2021-09-02, and it's the Catmandu::Importer::SRU(3pm) page — so if you need to cite it, that's the receipt 🧾💖 now go fetch some records, bestie, you're gonna ate 🌈✨