Jozef Kutej > Data-Header-Fields-0.04 > Data::Header::Fields

Download:
Data-Header-Fields-0.04.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.04   Source  

NAME ^

Data::Header::Fields - encode and decode RFC822 header field lines

SYNOPSIS ^

        use IO::Any;
        my $email_msg = IO::Any->slurp([ 'path', 'to', 'email.eml' ]);
        my ($email_header, $email_body) = split(/^\s*$/m, $email_msg, 2);

        use Data::Header::Fields;
        my $dhf = Data::Header::Fields->new->decode(\$email_header);
        print 'From    - ', $dhf->get_value('From'), "\n";
        print 'Subject - ', $dhf->get_value('Subject'), "\n";
        print 'Date    - ', $dhf->get_value('Date'), "\n";
        print '--- cut ---', "\n";

        $dhf->set_value('To' => ' anyone@anywhere');
        $dhf->rm_fields('Received');
        
        print $dhf->encode();

WARNING ^

experimental, use on your own risk :-)

DESCRIPTION ^

RFC822 - Standard for ARPA Internet Text Messages (http://tools.ietf.org/html/rfc822#section-3.2) describes the format of header lines used in emails. The tricky part is the line folding.

There are some "forks" of this standard. One of them is Debian RFC-2822-like fields and the other is RFC2425 that defines the so called vCard format. Data::Header::Fields is generic enough to serve as a base class to parse those as well.

One of the main goals of the module is to be able to edit the headers while keeping the lines that were not changed untouched.

For the moment this is all documentation. After more tests with vCards and using this module for the basic parsing in Parse::Deb::Control it will be stable enough.

Currently this distribution is highly radioactive!

SEE ALSO ^

http://tools.ietf.org/html/rfc2822 - Internet Message Format

AUTHOR ^

Jozef Kutej

syntax highlighting: