Catman..._match(3pm)

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

💖 Catman..._match — the aat_match fix, explained by your unix bestie 💖

okay so this page lives in the User Contributed Perl Documentation section, manual page Catman..._match(3pm). it's giving certified Perl module energy. let's go 🦋

✨ NAME ✨

Catmandu::Fix::aat_match — it does a direct match between a term and a Subject over in the AAT. no cap. 🎀

🌸 SYNOPSIS 🌸

aat_match(
    path,
    -lang: nl
)

that's the whole vibe, bestie. path goes in, -lang is optional, and we're off. 💅

🫶 DESCRIPTION 🫶

so basically: this fix performs a direct match between a term and the SPARQL endpoint at <http://vocab.getty.edu/sparql> belonging to the AAT. 🔥

what it's gonna do is try to find a Subject where the prefLabel in lang (optional, default "nl") equals the term. if it finds one, you get a single item back. if it finds nothing? you get an empty hash. that's it. no drama, no extra keys. 💀

the data it returns looks like this, exactly:

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

three little keys, living their best lives. obsessed. 🌈

⭐ PARAMETERS ⭐

Required parameters 🔒

  • path — path to the term. you gotta give this one, bestie. no skipping.

Optional parameters 🎀

  • lang — language of both the prefLabel that gets matched and the prefLabel that gets returned. so it's a two-for-one language situation, iykyk. ✨

👑 AUTHOR 👑

Pieter De Praetere <pieter at packed.be > 💜

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. slay, open source icon. 💅

💖 SEE ALSO 💖

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

and that's the whole page, bestie 🫶 this was perl v5.36.0, dated 2023-02-04, and yes it is literally still called Catman..._match(3pm) — iconic, no notes. bye!! 🦋✨

📦 where this page comes from