Catmandu::AAT(3pm)

📦 version 0.03, in debian bookworm, debian trixie, ubuntu noble, ubuntu resolute, ubuntu stonking

💖 Catmandu::AAT 💖

okay bestie, so this is Catmandu::AAT, a page from the User Contributed Perl Documentation, and it's literally just "Retrieve items from the AAT". that's the whole name. we love a concise queen. 👑

✨ NAME ✨

Catmandu::AAT — Retrieve items from the AAT 🦋

🌸 SYNOPSIS 🌸

so this module ships a store that looks up a Subject in the AAT (that's the Art & Architecture Thesaurus, at <https://www.getty.edu/research/tools/vocabularies/aat/>) by hitting its SPARQL endpoint at <http://vocab.getty.edu/sparql>. no cap, that's the whole vibe. 🔥

it also comes with two fixes, bestie:

  • one fix that matches a term to a Subject
  • one fix that searches for a term in the AAT

here's how you call all three:

lookup_in_store(objectName, AAT, lang:nl)

aat_match(objectName, -lang:nl)

aat_search(objectName, -lang:nl)

💅 DESCRIPTION 💅

🎀 Catmandu::Store::AAT

lookup_in_store(
  objectName,
  AAT,
  lang: nl
)

the lang parameter is optional and lowkey defaults to nl. it sets the language of the prefLabel you get back. and here's the thing — if there's no prefLabel for that Subject in the lang you asked for, you get nothing back. nothing. not an empty string, not a sad little object, just nothing. so don't come crying to me when your lookup is empty, bestie, check your lang first 😭

the store grabs the dc:identifier of a Subject from the AAT and hands you back this exact little bundle of joy:

{
  'id'        => 'The dc:identifier of the Subject',
  'prefLabel' => 'The prefLabel in the provided language',
  'uri'       => 'The URI of the Subject'
}

look at that. three fields. clean. iconic. it's giving structured data. 💖

🌈 Catmandu::Fix::aat_match

aat_match(
  path,
  -lang: nl
)

a fix that performs a match between a term and a prefLabel of an AAT Subject. that's it, that's the fix. 🫶

aat_search(
  path,
  -lang: nl
)

a fix that performs a search for a term in the AAT. she searches. she finds. she serves. ✨

👑 AUTHOR 👑

Pieter De Praetere <pieter at packed.be > — we stan. 💜

Copyright 2017- PACKED vzw

⭐ LICENSE ⭐

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. free software, as it should be, periodt. 💅

🔥 SEE ALSO 🔥

  • Catmandu
  • Catmandu::Store::AAT
  • Catmandu::Fix::aat_search
  • Catmandu::Fix::aat_match

and that's the whole page, bestie!! 🧚 this was Catmandu::AAT(3pm) from perl v5.36.0, dated 2023-02-04. go forth and look up your subjects, ily, bye 💖✨🎀

📦 where this page comes from