NAME

Parse::Colloquy::Bot - Parse Colloquy bot/client terminal output

SYNOPSIS

     use strict;
     use Parse::Colloquy::Bot qw(:all);
     use Data::Dumper;

# ... connect to Colloquy and read from the server ...

     my $parsed = parse_line($raw_input);
     print Dumper($parsed);

DESCRIPTION

This module will parse the raw "client" or "bot" terminal line output from a connection to a Colloquy server.

FUNCTIONS
parse_line
Accepts a single scalar input line or an array of input. Will return a hash reference or array of hash references for each input line, depending on the context that the function called.

EXAMPLE

The following input line from Colloquy:

LISTTALK neech2 %hello my name is neech {perl}

Will be parsed in to the following structure:

     $VAR1 = {
              'raw' => 'LISTTALK neech2      %hello my name is neech {perl}',
              'msgtype' => 'LISTTALK',
              'person' => 'neech2',
              'list' => '%perl'
              'text' => 'hello my name is neech',
              'args' => [
                          'hello',
                          'my',
                          'name',
                          'is',
                          'neech'
                        ],
              'command' => 'hello',
              'cmdargs' => [
                             'my',
                             'name',
                             'is',
                             'neech'
                           ],
              'respond' => undef,
              'time' => 1148224087,
            };

SEE ALSO

Colloquy::Data, Colloquy::Bot::Simple, Chatbot::TalkerBot

VERSION

$Id: Bot.pm 483 2006-05-22 21:36:46Z nicolaw $

AUTHOR

Nicola Worthington <nicolaw@cpan.org>

<http://perlgirl.org.uk>

COPYRIGHT

Copyright 2006 Nicola Worthington.

This software is licensed under The Apache Software License, Version 2.0.

<http://www.apache.org/licenses/LICENSE-2.0>