Catman...::Lint(3pm)

✨ NAME ✨

okay so bestie, welcome to Catman...::Lint (it lives in the User Contributed Perl Documentation section, 3pm, iykyk) 💖

Catmandu::Importer::MARC::Lint — a package that imports USMARC records, except it runs them through MARC::Lint first so you get that validation tea ☕✨

---

🌸 SYNOPSIS 🌸

# From the command line
$ catmandu convert MARC --type Lint --fix "marc_map('245a','title')" < /foo/data.mrc

# From perl
use Catmandu;

# import records from file
my $importer = Catmandu->importer('MARC',file => '/foo/data.mrc', type => 'Lint');
my $fixer    = Catmandu->fixer("marc_map('245a','title')");

$importer->each(sub {
    my $item = shift;
    ...
});

# or using the fixer

$fixer->fix($importer)->each(sub {
    my $item = shift;
    printf "title: %s\n" , $item->{title};
});

---

🦋 DESCRIPTION 🦋

so every single item that the Catmandu::Importer::MARC::Lint importer hands you comes with three keys, no more no less, periodt 💅

'_id'    : the system identifier of the record (usually the 001 field)
'record' : an ARRAY of ARRAYs containing the record data
'lint'   : the output of MARC::Lint's check_record on the MARC record

• '_id' — the system identifier of the record, which is usually the 001 field 👑
• 'record' — an ARRAY of ARRAYs holding the record data, it's giving nested, it's giving structure 🧚
• 'lint' — literally the output of MARC::Lint's check_record run on the MARC record 🔥

---

🎀 CONFIGURATION 🎀

• id — the MARC field that holds the system id (default: 001) 🫶
• file — read input from a local file by passing its path. alternatively you can pass a scalar reference and it'll read from a string, flexible much? 😌
• fh — read input from an IO::Handle. if you don't specify one, Catmandu::Util::io gets used to create the input stream from the "file" argument, or from STDIN 🌈
• encoding — binmode of the input stream "fh". it's set to ":utf8" by default, iconic 💜
• fix — an ARRAY of one or more fixes or file scripts that get applied to the imported items ✨

---

👑 METHODS 👑

every Catmandu::Importer is a Catmandu::Iterable, so all its methods are inherited — you get the whole inheritance situation for free, slay 🎉

---

💀 SEE ALSO 💀

• Catmandu::Importer
• Catmandu::Iterable

---

okay that's the whole page bestie, go forth and lint those MARC records 💖 this was perl v5.38.2, dated 2024-08-03, and yes it's still filed under Catman...::Lint(3pm) because the vibes are eternal 🎀✨🦋