NAME

       "IO::Async::Protocol::LineStream" - stream-based protocols using lines of text

SYNOPSIS

       Most likely this class will be subclassed to implement a particular network protocol.

        package Net::Async::HelloWorld;

        use strict;
        use warnings;
        use base qw( IO::Async::Protocol::LineStream );

        sub on_read_line
        {
           my $self = shift;
           my ( $line ) = @_;

           if( $line =~ m/^HELLO (.*)/ ) {
              my $name = $1;

              $self->invoke_event( on_hello => $name );
           }
        }

        sub send_hello
        {
           my $self = shift;
           my ( $name ) = @_;

           $self->write_line( "HELLO $name" );
        }

       This small example elides such details as error handling, which a real protocol
       implementation would be likely to contain.

DESCRIPTION

EVENTS

       The following events are invoked, either using subclass methods or CODE references in
       parameters:

   on_read_line $line
       Invoked when a new complete line of input is received.

PARAMETERS

       The following named parameters may be passed to "new" or "configure":

   on_read_line => CODE
       CODE reference for the "on_read_line" event.

METHODS

   write_line
          $lineprotocol->write_line( $text )

       Writes a line of text to the transport stream. The text will have the end-of-line marker
       appended to it; $text should not end with it.

AUTHOR

       Paul Evans <leonerd@leonerd.org.uk>