Catman...AlephX(3pm)

💖 Catman...AlephX(3pm) 💖

okay bestie, buckle up — this is Catmandu::Importer::AlephX, aka the package that pulls metadata records straight out of an AlephX service. she's giving ✨library data✨ and honestly? iconic. 🎀

---

🌸 NAME 🌸

Catmandu::Importer::AlephX — the package that imports metadata records from the AlephX service. yes that's literally her whole job and she does it flawlessly 💅

---

✨ SYNOPSIS ✨

use Catmandu::Importer::AlephX;

my $importer = Catmandu::Importer::AlephX->new(
                    url => 'http://ram19:8995/X' ,
                    query => 'WRD=(art)' ,
                    base => 'usm01' ,
                    );

my $n = $importer->each(sub {
    my $r = $_[0];
    # ...
    say Dumper($r->{record});
    say Dumper($r->{items});
});

like. look at her. three lil params and she's cooking 🍓

---

🦋 METHODS 🦋

🌟 new(url => '...' , base => '...' , query => '...')

spawn a brand new AlephX importer, bestie. the required params are:

• the url — the base url of the AlephX service
• an Aleph base — the catalog name
• and a query

no skipping any of those three, okay? 👑

💜 common parameters

• url — base url of the alephx service (e.g. "http://ram19:8995/X")
• include_items — 0|1. when you set it to '1', the items of every bibliographical record are retrieved 🫶

🎀 alephx parameters

• base — name of catalog in Aleph where you want to search
• query — the query, of course 😌

💅 output

and this is what you get back, bestie — it's giving structured data:

 {
   record => [
     [
       'FMT',
       '',
       '',
       '_',
       'MX'
     ],
     [
       'LDR',
       '',
       '',
       '_',
       '01236npca^22001937|^4500'
     ]
     ..
   ],
   items => [
     {
       'sub-library' => 'WID',
       'chronological-k' => '',
       'chronological-i' => '',
       'library' => 'USM50',
       'collection' => 'HD',
       'call-no-1' => '$$2ZHCL$$hH 810.80.20',
       'chronological-j' => '',
       'requested' => 'N',
       'expected' => 'N',
       'barcode' => 'HWM4M4',
       'description' => '',
       'note' => '',
       'item-status' => '01',
       'rec-key' => '000048762000010',
       'enumeration-a' => '',
       'call-no-2' => '',
       'enumeration-b' => '',
       'enumeration-c' => '',
       'on-hold' => 'N'
     }
   ]

 }

---

⭐ count

⭐ each(&callback)

⭐ ...

every Catmandu::Importer is a Catmandu::Iterable, so all its methods are inherited — you get the whole family tree for free, no cap 🧚

⚠️ okay this part matters: the Catmandu::Importer::AlephX methods are not idempotent: Twitter feeds can only be read once. like… read it once and it's gone, bestie. no re-runs. 😭

---

👑 AUTHOR 👑

Patrick Hochstenbach — "patrick dot hochstenbach at ugent dot be" 📧

---

🌈 SEE ALSO 🌈

• Catmandu::Iterable

---

and that's the whole page, bestie!! 🎀 this was perl v5.36.0, dated 2023-02-02, and it's part of the User Contributed Perl Documentation — mwah, go read some records, you got this 💖✨🦋