POE-Filter-Transparent-SMTP

The filter aims to make SMTP data transparent just before going onto
the wire as per RFC 821 Simple Mail Transfer Protocol Section
4.5.2. TRANSPARENCY. See L<http://www.faqs.org/rfcs/rfc821.html> for
details.

Conversely the filter takes transparent data from the wire and
converts it to the original format.

The main purpose of this filter is to help
L<POE::Component::Client::SMTP> create transparent messages when
comunicating with an SMTP server. However the filter can be used by
any Perl SMTP client or server.

Internally it uses L<POE::Filter::Line> in order to split messages
into lines. Also as stated in the RFC every line it puts on the wire
is ended by <CRLF>.

When receiving data from the wire (as it is the case for an SMTP
server), lines should be separated with <CRLF> as the RFC
specifies. However this is not always true as some SMTP clients are
broken. So if you are using the filter on the receiving end maybe you
would like to specify a regular expression that is more flexible for
the line terminator.

INSTALLATION

To install this module, run the following commands:

	perl Makefile.PL
	make
	make test
	make install

SUPPORT AND DOCUMENTATION

After installing, you can find documentation for this module with the
perldoc command.

    perldoc POE::Filter::Transparent::SMTP

You can also look for information at:

    RT, CPAN's request tracker
        http://rt.cpan.org/NoAuth/Bugs.html?Dist=POE-Filter-Transparent-SMTP

    AnnoCPAN, Annotated CPAN documentation
        http://annocpan.org/dist/POE-Filter-Transparent-SMTP

    CPAN Ratings
        http://cpanratings.perl.org/d/POE-Filter-Transparent-SMTP

    Search CPAN
        http://search.cpan.org/dist/POE-Filter-Transparent-SMTP


COPYRIGHT AND LICENCE

Copyright (c) 2008-2009 George Nistorica
All rights reserved.
This program is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.  See the LICENSE
file that comes with this distribution for more details.