Catman...search(3pm)

💖 Catmandu::Fix::viaf_match — aka the Catman...search(3pm) page, but make it cute 💖

okay bestie, listen up, because this one is a whole moment. It lives in the User Contributed Perl Documentation corner of the Catman...search(3pm) universe, and it's literally just "go find this person's name in VIAF" energy. Obsessed. 🦋

---

🌸 NAME 🌸

Catmandu::Fix::viaf_match — perform a search for a name in VIAF 🎀

✨ SYNOPSIS ✨

like, this is how you'd actually call it:

viaf_search(authorName, -lang:'nl-NL', -fallback_lang:'en-US')

that's it. that's the vibe. 💅

💜 DESCRIPTION 💜

So what this fix does is it goes and performs a search for a name, no cap. And not just one place — it queries both mainHeadingEl and the local.personalNames. Like, thorough. It checks everywhere. Queen behavior. 👑

Then it hands you back the prefLabel in whatever lang you asked for, orrrr it falls back to fallback_lang if there's no label in your lang. And if fallback_lang also isn't there? Yeah, the prefLabel comes back empty. tragic, but that's the rules. 😭

And the fix returns a list, where each element is shaped like this:

{
  'dcterms:identifier' => 'The identifier',
  'guid'               => 'The VIAF URL',
  'schema:birthDate'   => 'Birth date, if provided',
  'schema:deathDate'   => 'Death date, if provided',
  'schema:description' => 'Description, if provided',
  'skos:prefLabel'     => 'prefLabel, in lang or fallback_lang'
}

look at those keys. so structured. so slay. ✨

🎀 PARAMETERS 🎀

Required parameters (you gotta, bestie)

• path — the path to the name. that's the whole thing. no path, no search. 🙈

Optional parameters (nice to have, not mandatory)

• lang — the language of the returned skos:prefLabel. If it can't find one, it falls back to fallback_lang. Use IETF language tags for this one — here's the link so you can be that girl who cites her sources: <https://en.wikipedia.org/wiki/IETF_language_tag> 🌈
• fallback_lang — the fallback language. the backup bestie. the one who shows up when nobody else does. 🫶

---

👑 AUTHOR 👑

Pieter De Praetere <pieter at packed.be > — icon, legend, the moment. 💖

🌸 COPYRIGHT 🌸

Copyright 2017- PACKED vzw — respect the legacy, fr fr. ✨

💅 LICENSE 💅

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. so like, go off, but follow the rules. 🎀

🦋 SEE ALSO 🦋

• Catmandu
• Catmandu::VIAF
• Catmandu::Store::VIAF
• Catmandu::Fix::viaf_match

iykyk. the whole family tree. 🔥

---

and that's the page, bestie! 🥰 this masterpiece was brought to you by perl v5.36.0, dated 2023-02-04, and it's the Catman...search(3pm) page — so if you ever forget where you read it, you know exactly where to look. mwah. 💋🌺⭐