WWW::Comic::Plugin::XKCD - WWW::Comic plugin to fetch XKCD comic

WWW-Comic-Plugin-XKCD documentation Contained in the WWW-Comic-Plugin-XKCD distribution.

Index

Code Index:

NAME

Top

WWW::Comic::Plugin::XKCD - WWW::Comic plugin to fetch XKCD comic

SYNOPSIS

Top

See WWW::Comic for full details, but here's a brief example:

 use WWW::Comic;
 my $wc = new WWW::Comic;
 my $latest_candh_strip_url 
    = WWW::Comic->strip_url(comic => 'xkcd');

DESCRIPTION

Top

A plugin for WWW::Comic to fetch the xkcd comic from http://www.xkcd.org/

See WWW::Comic and WWW::Comic::Plugin for information on the WWW::Comic interface.

FUNCTIONS

Top

new

Constructor - see WWW::Comic for usage

strip_url

Returns the URL to the current strip image (or, if given the 'id' param, the URL to that particular strip)

AUTHOR

Top

David Precious, <davidp at preshweb.co.uk>

BUGS

Top

Please report any bugs or feature requests to bug-www-comic-plugin-XKCD at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=WWW-Comic-Plugin-XKCD. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

Top

You can find documentation for this module with the perldoc command.

    perldoc WWW::Comic::Plugin::XKCD

You can also look for information at:

* RT: CPAN's request tracker

http://rt.cpan.org/NoAuth/Bugs.html?Dist=WWW-Comic-Plugin-XKCD

* AnnoCPAN: Annotated CPAN documentation

http://annocpan.org/dist/WWW-Comic-Plugin-XKCD

* CPAN Ratings

http://cpanratings.perl.org/d/WWW-Comic-Plugin-XKCD

* Search CPAN

http://search.cpan.org/dist/WWW-Comic-Plugin-XKCD

ACKNOWLEDGEMENTS

Top

To Nicola Worthington (NICOLAW) for writing WWW::Comic

COPYRIGHT & LICENSE

Top

Copyright 2008 David Precious, all rights reserved.

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

WWW-Comic-Plugin-XKCD documentation Contained in the WWW-Comic-Plugin-XKCD distribution. 
package WWW::Comic::Plugin::XKCD;

use warnings;
use strict;
use Carp;

use vars qw($VERSION @ISA %COMICS);
our $VERSION = '0.02';
@ISA = qw(WWW::Comic::Plugin);
%COMICS = (xkcd => 'xkcd - A webcomic of romance, sarcasm, math, and language');

# $Id: XKCD.pm 331 2008-04-07 21:58:43Z davidp $



sub new {
    my $class = shift;
    my $self = { homepage => 'http://www.xkcd.org/' };
    bless $self, $class;
    return $self;
}


sub strip_url {
    my $self = shift;
    my %param = @_;
    
    my $url = $self->{homepage};
    $url .= "$param{id}/" if $param{id};
    
    my $response = $self->_new_agent->get($url);
    if ($response->is_success) {
        my $html = $response->content;
        my $alt_text = 'Cyanide and Happiness, a daily webcomic';
        if ($html 
            =~ m{<h3>Image URL \(for hotlinking/embedding\): (.+)</h3>}msi)
        {
            my $url = $1;
            return $url;
        } else {
            carp "Failed to find C+H comic strip at $url";
            warn "Content was:\n$html\n";
            return;
        }
    
    } else {
        carp "Failed to fetch $url - " . $response->status_line;
        return;
    }
    
}


1; # End of WWW::Comic::Plugin::XKCD