OAI_PMH(1p)

💖 OAI_PMH(1p) 💖

okay bestie, pull up a chair, because we're about to talk about oai_pmh.pl — a little icon from the User Contributed Perl Documentation corner of the world. its whole job? pipe OAI-PMH to the command-line. that's it. that's the gig. and it ate. 🎀

---

✨ SYNOPSIS ✨

        oai_pmh.pl <options> [baseURL]

---

🦋 OPTIONS 🦋

• --help — get help, bestie. we love a self-aware queen. 💅
• --man — show the man page. the full lore. the director's cut. 📖
• --verbose — be more verbose. and like, it's repeatable, so you can stack it and get even more verbose. go off. 🗣️
• --force — force a non-conformant OAI request. yeah. she's a little rebellious. no cap. 🔥
• --from <ISO datetime> — the "from" date. ISO datetime, pls. ⏰
• --identifier <identifier> — the OAI identifier, for GetRecord or ListMetadataFormats. 🆔
• --metadataPrefix <mdp> — specify the format of the metadata you wanna retrieve. 🎀
• -X/--request <command> — the verb you're requesting. defaults to ListRecords, which is lowkey the main character. 👑
• --set <oai set> — only request the records in this set. we're being selective, periodt. 💅
• --until <ISO datetime> — the "until" date. also ISO datetime. symmetrical queen. ⏳

---

🌸 DESCRIPTION 🌸

so the vibe here is: retrieve data from OAI-PMH endpoints. the output format is literally this:

        <headers>

        <content>
        <FORMFEED>

where <headers> are in HTTP header format. the content is the raw XML as exposed by the repository — no glow-up, no editing, just exactly what the repo handed over. and each record is separated by a FORMFEED character. yes, a literal form feed. iconic behaviour, honestly. 🧚

for example, here's a whole moment:

        oai_pmh.pl -X GetRecord --metadataPrefix oai_dc \
                --identifier oai:eprints.soton.ac.uk:20 http://eprints.soton.ac.uk/cgi/oai2

heads up bestie: that --force flag means a non-conformant OAI request. it's not playing by the rules, and that's on purpose. use it with intention, not on autopilot. 💀

---

and that's the whole page, fr fr. this lil manual is from perl v5.36.0, dated 2023-09-28 — thanks for coming to my ted talk, ily, go fetch some metadata 🫶💖✨