NAME
Bot::Backbone::Service::ConsoleChat - Chat with an interactive command line
VERSION
version 0.142220
SYNOPSIS
service console => (
service => 'ConsoleChat',
);DESCRIPTION
This is a handy service for interacting with a bot from the command line. This can be useful for interfering with the state of the bot or working with the bot without going through some other chat server.
ATTRIBUTES
term
This is the internal readline terminal object.
No user serviceable parts.
prompt
This is the prompt displayed to the user. It is "> " by default. You may set this during initialization or the bot may modify it as desired.
username
This is the name of the user at the console. This is set to $ENV{USER} by default.
nickname
This is the nickname to give the user at the console. As of now, this is also se to $ENV{USER} be default.
It may be set to gecos or something by default in the future.`
EVENT HANDLERS
_start
Starts the chat and shows the first prompt.
got_console_input
Whenever the user hits enter, this dispatches, notifies the chat consumers, and puts up the next prompt.
Anything not matching a built-in command will be passed to the bot as a direct message. The built-in commands include:
/quit
This causes the bot to shutdown and exit.
cli_message
Handles most messages typed on the command line.
METHODS
initialize
This sets up the POE::Session that is used to manage the terminal wheel.
send_message
Whenever the bot sends a message, it will be displayed if it is a direct message back to the console or if the group name matches the "current_group". All other messages will be muted.
shutdown
Says good-bye and destroys the terminal object, which will shutdown the session and allow the bot to exit.
AUTHOR
Andrew Sterling Hanenkamp <hanenkamp@cpan.org>
COPYRIGHT AND LICENSE
This software is copyright (c) 2014 by Qubling Software LLC.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.