Email::MIME - Easy MIME message parsing.
use Email::MIME; my $parsed = Email::MIME->new($message); my Email::MIME @parts = $parsed->parts; my $decoded = $parsed->body; my $non_decoded = $parsed->body_raw; my $content_type = $parsed->content_type;
This is an extension of the Email::Simple module, to handle MIME encoded messages. It takes a message as a string, splits it up into its constituent parts, and allows you access to various parts of the message. Headers are decoded from MIME encoding.
This is an alpha release, designed to stimulate discussion on the API, which may change in future releases. Please send me comments about any features you think Email::MIME should have. Note that I expect most things to be driven by subclassing and mix-ins.
Email::MIME
Please see Email::Simple for the base set of methods. It won't take very long. Added to that, you have:
This returns a set of Email::MIME objects reflecting the parts of the message. If it's a single-part message, you get the original object back.
This decodes and returns the body of the object. For top-level objects in multi-part messages, this is highly likely to be something like "This is a multi-part message in MIME format."
This returns the body of the object, but doesn't decode the transfer encoding.
This is a shortcut for access to the content type header.
This provides the suggested filename for the attachment part. Normally it will return the filename from the headers, but if filename is passed a true parameter, it will generate an appropriate "stable" filename if one is not found in the MIME headers.
filename
Casey West, casey@geeknest.com
casey@geeknest.com
Simon Cozens, simon@cpan.org (retired)
simon@cpan.org
You may distribute this module under the terms of the Artistic or GPL licenses.
This module was generously sponsored by Best Practical (http://www.bestpractical.com/) and Pete Sergeant.
Email::Simple.
To install Email::MIME, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Email::MIME
CPAN shell
perl -MCPAN -e shell install Email::MIME
For more information on module installation, please visit the detailed CPAN module installation guide.