NAME

POE::Component::IRC::Plugin::ImageMirror - A PoCo-IRC plugin which uploads select images to a mirror service

SYNOPSIS

To quickly get an IRC bot with this plugin up and running, you can use App::Pocoirc:

 $ pocoirc -s irc.perl.org -j '#bots' -a ImageMirror

Or use it in your code:

 use POE::Component::IRC::Plugin::ImageMirror;

 # mirror all images from 4chan.org
 $irc->plugin_add(ImageMirror => POE::Component::IRC::Plugin::ImageMirror->new(
     URI_match => [
         qr{4chan\.org/\w+/src/.*(?i:jpe?g|gif|png)$},
     ],
 ));

DESCRIPTION

POE::Component::IRC::Plugin::ImageMirror is a POE::Component::IRC plugin. It looks for image URLs in the channel log and uploads the images to Imageshack and Imgur, then prints a short description of the image along with the new URLs.

 <avar> http://images.4chan.org/b/src/1267339589262.gif
 -MyBot:#channel- gif (318 x 241) - http://imgur.com/RWcSE.gif - http://img535.imageshack.us/img535/9685/1267339589262.gif

This plugin makes use of POE::Component::IRC::Plugin::URI::Find. An instance will be added to the plugin pipeline if it is not already present.

METHODS

new

Takes the following optional arguments:

'Channels', an array reference of channels names. If you don't supply this, images will be mirrored in all channels.

'URI_match', an array reference of regex objects. Any url found must match at least one of these regexes if it is to be uploaded. If you don't supply this parameter, a default regex of qr/(?i:jpe?g|gif|png)$/ is used.

'URI_subst', an hash reference of regex/string pairs. These substitutions will be done on the accepted URIs before they are processed further.

Example:

 # always fetch 7chan images via http, not https
 URI_subst => [
     qr{(?<=^)https(?=://(?:www\.)?7chan\.org)} => 'http',
 ]

'URI_title', whether or not to include a title produced by URI::Title. Defaults to true.

'Imgur_user', an Imgur username. If provided, the images uploaded to Imgur will be under this account rather than anonymous.

'Imgur_pass', an Imgur account password to go with 'ImgurUser'.

'Method', how you want messages to be delivered. Valid options are 'notice' (the default) and 'privmsg'.

'Eat', when enabled, will prevent further processing of irc_urifind_uri events by other plugins for URIs which this plugin mirrors. False by default.

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

AUTHOR

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

Imageshack-related code provided by Ævar Arnfjörð Bjarmason <avar@cpan.org>.

LICENSE AND COPYRIGHT

Copyright 2010 Hinrik Örn Sigurðsson

This program is free software, you can redistribute it and/or modify it under the same terms as Perl itself.

cpanm POE::Component::IRC::Plugin::ImageMirror

perl -MCPAN -e shell
install POE::Component::IRC::Plugin::ImageMirror