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_field('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