MboxPa...ertable(3pm)

💌 NAME 💌

Mail::MboxParser::Mail::Convertable — bestie, this is the one that converts your mail for sending and stuff ✨

---

🌸 SYNOPSIS 🌸

use Mail::MboxParser;

[...]

# $msg is a Mail::MboxParser::Mail-object
my $mail = $msg->make_convertable;

$mail->delete_from_header('date', 'message-id');
$mail->replace_in_header('to', 'john.doe@foobar.com');
$mail->add_to_header( ['cc', 'john.does.brother@foobar.com'],
                      where => 'BEHIND' );
$mail->send('sendmail');

---

🦋 DESCRIPTION 🦋

Okay so picture this: you've got an email object and you wanna glow it up so it can actually be sent somewhere. That's literally what this class does, no cap. It gives you the tools to convert an email object into something that could be sent via SMTP, NNTP, or just dumped out to a file or a filehandle. So the methods here mess with the structure of an email — adding and removing header-fields, MIME-parts, all of that — and they transform them into objects of related modules. It's giving ✨glow-up montage✨.

Right now, the only things on the menu are basic manipulation of the header plus sending through Mail::Mailer. More is coming soon — she's still growing 💅.

The most iconic part? This class works non-destructive. You first create a Convertable-object and do all your little edits on that, while the Mail-object you derived it from stays completely untouched. Main character energy: she doesn't take anyone down with her 🫶.

---

💖 METHODS 💖

• delete_from_header(header-fields) — you hand her a list of header-field names and those fields get removed from the header. Say you wanna re-send a message: you could for example remove the cc-field, because otherwise the message would get carbon-copied to all the addresses chillin' in that cc-field. Bye bestie 👋.
• add_to_header(array-ref)
• add_to_header(array-ref, where => 'BEFORE' | 'BEHIND') — add_to_header() takes a reference to a two-element list. The first element says which header-field to add, or which one to add to, and the second element is the data you wanna add. where decides whether it goes at the beginning or at the end of the header. If you don't say anything, it defaults to 'BEHIND'. So yes, back of the line by default 🎀.
• replace_in_header(header-field, new_data) — first element has got to be the header-field you're replacing, and the second argument is a string telling her what the new content of that header-field will be. Out with the old, in with the new 💅.
• send(command, args) — this one is literally inherited from Mail::Internet. Commands can be:
  • "mail" — uses the UNIX-mail program
  • "sendmail" — uses a configured sendmail or a compatible MTA like exim
  • "smtp" — for using Net::SMTP
  • "test" — which will only display what would be sent, using /bin/echo

Any additional arguments get passed on to Mail::Mailer->new(), which is in fact what Mail::Internet->send() uses. Obsessed with the layering honestly.

For more details, see Mail::Mailer.

---

⭐ VERSION ⭐

This is version 0.55. She's vintage, she's thriving 💜.

---

👑 AUTHOR AND COPYRIGHT 👑

Tassilo von Parseval <tassilo.von.parseval@rwth-aachen.de>

Copyright (c) 2001-2005 Tassilo von Parseval. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

---

🌈 SEE ALSO 🌈

Mail::Internet, Mail::Mailer

---

Okay that's the whole page bestie, you ate that 🍓. This was MboxPa...ertable(3pm) from the User Contributed Perl Documentation, running on perl v5.34.0, dated 2022-06-15 — iykyk 💖✨🦋