Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

poe::filter::irc::compat(3pm) [debian man page]

POE::Filter::IRC::Compat(3pm)				User Contributed Perl Documentation			     POE::Filter::IRC::Compat(3pm)

NAME

       POE::Filter::IRC::Compat - A filter which converts POE::Filter::IRCD output into POE::Component::IRC events

SYNOPSIS

	my $filter = POE::Filter::IRC::Compat->new();
	my @events = @{ $filter->get( [ @lines ] ) };
	my @msgs = @{ $filter->put( [ @messages ] ) };

DESCRIPTION

       POE::Filter::IRC::Compat is a POE::Filter that converts POE::Filter::IRCD output into the POE::Component::IRC compatible event references.
       Basically a hack, so I could replace POE::Filter::IRC with something that was more generic.

       Among other things, it converts normal text into thoroughly CTCP-quoted messages, and transmogrifies CTCP-quoted messages into their
       normal, sane components. Rather what you'd expect a filter to do.

       A note: the CTCP protocol sucks bollocks. If I ever meet the fellow who came up with it, I'll shave their head and tattoo obscenities on
       it.  Just read the "specification" (docs/ctcpspec.html in this distribution) and you'll hopefully see what I mean. Quote this, quote that,
       quote this again, all in different and weird ways... and who the hell needs to send mixed CTCP and text messages? WTF? It looks like it's
       practically complexity for complexity's sake -- and don't even get me started on the design of the DCC protocol! Anyhow, enough ranting.
       Onto the rest of the docs...

METHODS

   "new"
       Returns a POE::Filter::IRC::Compat object. Takes no arguments.

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

   "get"
       Takes an arrayref of POE::Filter::IRCD hashrefs and produces an arrayref of POE::Component::IRC compatible event hashrefs. Yay.

   "get_one_start", "get_one"
       These perform a similar function as "get" but enable the filter to work with POE::Filter::Stackable.

   "put"
       Takes an array reference of CTCP messages to be properly quoted. This doesn't support CTCPs embedded in normal messages, which is a brain-
       dead hack in the protocol, so do it yourself if you really need it. Returns an array reference of the quoted lines for sending.

   "debug"
       Takes an optinal true/false value which enables/disables debugging accordingly. Returns the debug status.

   "chantypes"
       Takes an arrayref of possible channel prefix indicators.

   "identifymsg"
       Takes a boolean to turn on/off the support for CAPAB IDENTIFY-MSG.

AUTHOR

       Chris 'BinGOs' Williams

SEE ALSO

       POE::Filter::IRCD

       POE::Filter

       POE::Filter::Stackable

perl v5.14.2							    2011-12-07					     POE::Filter::IRC::Compat(3pm)

Check Out this Related Man Page

POE::Component::IRC::Plugin::NickReclaim(3pm)		User Contributed Perl Documentation	     POE::Component::IRC::Plugin::NickReclaim(3pm)

NAME

       POE::Component::IRC::Plugin::NickReclaim - A PoCo-IRC plugin for reclaiming your nickname

SYNOPSIS

	use strict;
	use warnings;
	use POE qw(Component::IRC Component::IRC::Plugin::NickReclaim);

	my $nickname = 'Flibble' . $$;
	my $ircname = 'Flibble the Sailor Bot';
	my $ircserver = 'irc.blahblahblah.irc';
	my $port = 6667;

	my $irc = POE::Component::IRC->spawn(
	    nick => $nickname,
	    server => $ircserver,
	    port => $port,
	    ircname => $ircname,
	) or die "Oh noooo! $!";

	POE::Session->create(
	    package_states => [
		main => [ qw(_start) ],
	    ],
	);

	 $poe_kernel->run();

	sub _start {
	    $irc->yield( register => 'all' );

	    # Create and load our NickReclaim plugin, before we connect
	    $irc->plugin_add( 'NickReclaim' =>
		POE::Component::IRC::Plugin::NickReclaim->new( poll => 30 ) );

	    $irc->yield( connect => { } );
	    return;
	}

DESCRIPTION

       POE::Component::IRC::Plugin::NickReclaim - A POE::Component::IRC plugin automagically deals with your bot's nickname being in use and
       reclaims it when it becomes available again.

       It registers and handles 'irc_433' events. On receiving a 433 event it will reset the nickname to the 'nick' specified with "spawn" or
       "connect", appendedwith an underscore, and then poll to try and change it to the original nickname. If someone in your channel who has the
       nickname you're after quits or changes nickname, the plugin will try to reclaim it immediately.

METHODS

   "new"
       Takes one optional argument:

       'poll', the number of seconds between nick change attempts, default is 30;

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

AUTHOR

       Chris 'BinGOs' Williams

       With amendments applied by Zoffix Znet

SEE ALSO

       POE::Component::IRC

perl v5.14.2							    2011-12-07			     POE::Component::IRC::Plugin::NickReclaim(3pm)
Man Page