Catman...r::meta(3pm)

🦋 NAME 🦋

Catmandu::Importer::SRU::Parser::meta — bestie, this lil package's whole job is transforming SRU response metadata into a Perl hash. That's it, that's the gig. 💅

(oh and psst, it lives in the 3pm manual section, iykyk 🎀)

---

✨ SYNOPSIS ✨

okay so here's how you actually call it:

my $importer = Catmandu::Importer::SRU->new(
  base   => 'http://www.unicat.be/sru',
  query  => 'tit=cinema',
  parser => 'meta',
);

look at that. parser => 'meta' is the main character of this whole operation. slay. 👑

---

🌸 DESCRIPTION 🌸

so Catmandu::Importer::SRU::Parser — this one — hands you back a single item packed with the SRU SearchRetrieve Response Parameters of a request. The official lore for those parameters lives over at http://www.loc.gov/standards/sru/sru-1-1.html#responseparameters if you wanna go read the source material. no cap. 📚

here's everything that comes back in that one item, one by one:

• version — the SRU version of the response, like 1.1.
• numberOfRecords — how many records the query actually matched. heads up: if the query fails, this is 0. literally zero. not a single one. 😭
• resultSetId — the identifier for a result set that got created when the query was executed.
• resultSetIdleTime — the number of seconds until that created result set gets deleted. it's giving "you have this long, bestie, then it's gone". ⏳
• nextRecordPosition — the next position within the result set, right after the final returned record. unless this is the last part of the result set, in which case, well, that's the end of the road. 🛣️
• diagnostics — an array of diagnostics, and each one has a "uri", a "details" (optional, so it might ghost you), and a "message" (also optional). 🙈
• extraResponseData — additional info that's specific to the profile. the bonus content, the deleted scenes. ⭐
• echoedSearchRetrieveRequest — the request parameters, handed back to you as a hash of key-value pairs. it's echoing your own words back at you fr fr. 🌈

and bestie, one more — in addition, the field "requestUrl" contains the full request URL. the whole thing, the complete link, iconic. 🔥

🫶 tiny reminder: all of this arrives as one single item. don't go looking for a list, that's not the vibe here.

---

🎀 the cute sign-off 🎀

this page is from perl v5.38.2, dated 2021-09-02, and it's filed under Catmandu::Importer::SRU::Parser::meta(3pm) in the User Contributed Perl Documentation. bye bestie, go parse something pretty 💖✨