NAME
    POE::Filter::HTTP::Parser - A POE filter for HTTP based on HTTP::Parser

SYNOPSIS
        use POE::Filter::HTTP::Parser;

        my $request_filter = POE::Filter::HTTP::Parser->new( type => 'request' );
        my $arrayref_of_request_objects = $filter->get( [ $stream ] );

        my $response_filter = POE::Filter::HTTP::Parser->new( type => 'response' );
        my $arrayref_of_response_objects = $filter->get( [ $stream ] );

DESCRIPTION
    POE::Filter::HTTP::Parser is a POE::Filter for HTTP which is based on
    HTTP::Parser.

    It will produce HTTP::Request or HTTP::Response objects from a stream of
    HTTP text, depending on the "type" that is specified during construction
    of the filter object.

CONSTRUCTOR
    "new"
        Creates a new POE::Filter::HTTP::Parser object. Takes one optional
        argument, whether to produce HTTP::Request objects, "request", or
        HTTP::Reponse objects, "response". "response" is the default
        behaviour if "type" is not specified.

          'type', set to either 'request' or 'response', default is 'response';

METHODS
    "get"
    "get_one_start"
    "get_one"
        Takes an arrayref which is contains lines of text. Returns an
        arrayref of either HTTP::Request or HTTP::Response objects depending
        on the "type" that has been specified.

    "get_pending"
        Returns any data remaining in a filter's input buffer. The filter's
        input buffer is not cleared, however. Returns an array reference if
        there's any data, or undef if the filter was empty.

    "put"
        Takes an arrayref of either HTTP::Response objects or HTTP::Request
        objects depending on whether "type" is set to "request" or
        "response", respectively.

        If "type" is "response", then this accepts HTTP::Request objects. If
        "type" is "request", then this accepts HTTP::Response objects.

        This does make sense if you think about it.

        The given objects are returned to their stream form.

    "clone"
        Makes a copy of the filter, and clears the copy's buffer.

AUTHOR
    Chris "BinGOs" Williams

    The "put" method for HTTP responses was borrowed from POE::Filter::HTTPD
    by Artur Bergman and Rocco Caputo.

LICENSE
    Copyright © Chris Williams, Artur Bergman and Rocco Caputo.

    This module may be used, modified, and distributed under the same terms
    as Perl itself. Please see the license that came with your Perl
    distribution for details.

SEE ALSO
    POE::Filter

    HTTP::Parser

    POE::Filter::HTTPD