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