NAME

App::Bondage::State - Generates IRC server replies based on information provided by POE::Component::IRC::State.

SYNOPSIS

 use App::Bondage::State;

 $irc->plugin_add('State', App::Bondage::State->new());

DESCRIPTION

App::Bondage::State is a POE::Component::IRC plugin. Its role is to use POE::Component::IRC::State's information as a cache so that fewer trips will be to the IRC server when clients submit queries. The methods here are only useful for a subset of the use cases that their corresponding commands are capable of, mostly because there are certain cases that only the actual IRC server can handle. However, the methods can handle all the automatic queries that modern IRC clients make, so it does the job.

Another thing this plugin does is hide from clients all server replies elicited by POE::Component::IRC::State's information gathering.

This plugin requires the IRC component to be POE::Component::IRC::State or a subclass thereof.

CONSTRUCTOR

new

Takes no arguments.

Returns a plugin object suitable for feeding to POE::Component::IRC's plugin_add() method.

METHODS

topic_reply

One argument:

An IRC channel which the IRC component is on

Returns IRC protocol line responses to the TOPIC command.

names_reply

One argument:

An IRC channel which the IRC component is on

Returns IRC protocol line responses to the NAMES command.

who_reply

One argument:

An IRC channel which the IRC component is on, or a known nickname

Returns IRC protocol line responses to the WHO command.

names_reply

One or two arguments:

The IRC component's nickname, or a channel which the component is on and an optional mode type

Returns IRC protocol line responses to the MODE command.

enqueue

In case a client asks for information about a channel while it is being synced, it should call this method, and the information will be provided as soon as it has been gathered.

Takes three arguments:

A code reference which will be called for every line of response generated, the type of reply being asked for (e.g. 'who_reply'), and the arguments to the corresponding method.

is_syncing

Takes one argument:

An IRC channel.

Returns 1 if the channel or nick is being synced, 0 otherwise.

AUTHOR

Hinrik Örn Sigurðsson, hinrik.sig@gmail.com

cpanm App::Bondage

perl -MCPAN -e shell
install App::Bondage