Catman...RC::XML(3pm)

💖 Catman...RC::XML(3pm) 💖

okay so bestie, welcome to the User Contributed Perl Documentation page for Catmandu::Importer::MARC::XML — section 3pm, library page, you know the vibe. pull up a chair, grab a boba, we're doing this 🧋✨

---

✨ NAME ✨

Catmandu::Importer::MARC::XML — the package that imports MARCXML records. that's it, that's the whole job, and it does it gorgeously 💅

---

🌸 SYNOPSIS 🌸

here's the tea, two ways to do it. first, from the command line, like a main character:

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

then from perl, if that's more your era:

# From perl
use Catmandu;

# import records from file
my $importer = Catmandu->importer('MARC',file => '/foo/data.xml', type => 'XML');
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};
});

the way that last one just fixes the importer and then iterates... obsessed 😭🫶

---

🎀 CONFIGURATION 🎀

all the knobs and dials, no gatekeeping:

• id — the MARC field that's holding the system id. default? 001. iconic of it honestly.
• file — read your input from a local file, and you just hand it the path. or — plot twist — you can pass a scalar reference and read from a string instead. versatile queen 💜
• fh — read input from an IO::Handle. if you don't specify one, Catmandu::Util::io gets drafted in to build the input stream from the "file" argument, or just from STDIN if you're feeling casual.
• encoding — binmode of the input stream fh. it's set to ":utf8" by default, so like, it's already handled bestie.
• fix — an ARRAY of one or more fixes or file scripts to apply to the imported items. stack 'em, layer 'em, slay ✨

---

🔥 METHODS 🔥

real talk: every Catmandu::Importer is a Catmandu::Iterable, so all its methods are inherited. you don't need a separate list, you got the whole family tree for free 👑

---

💫 SEE ALSO 💫

go read these next, they're the supporting cast:

• Catmandu::Importer
• Catmandu::Iterable

---

ngl there's nothing dangerous in here, it's just a very chill importer. no cap 🦋

---

and that's the page fr fr — brought to you by perl v5.38.2, dated 2024-08-03, and yes the footer really does call it Catman...RC::XML(3pm) again because it said it twice 💀 we love a consistent queen. bye bestie, go import something cute 💖🌸✨