Nicola Worthington > WWW-VenusEnvy > WWW::VenusEnvy

Download:
WWW-VenusEnvy-1.10.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 1.10   Source  

NAME ^

WWW::VenusEnvy - Retrieve VenusEnvy comic strip images

SYNOPSIS ^

 use WWW::VenusEnvy qw(get_strip mirror_strip strip_url);
 
 # Get the URL for todays strip
 my $image_url = strip_url();
 
 # Get todays strip
 my $image_blob = get_strip();
 
 # Get a specific strip by specifying the ID
 my $christmas_kiss = get_strip("20051229");
 
 # Write todays strip to local_filename.gif on disk
 my $filename_written = mirror_strip("local_filename.gif");
 
 # Write a specific strip to mystrip.gif on disk
 my $filename_written = mirror_strip("mystrip.gif","20051229");

DESCRIPTION ^

This module will download the latest VenusEnvy comic strip from the Keenspace website and return a binary blob of the image, or write it to disk.

EXPORTS ^

The following functions can be exported with the :all export tag, or individually as is show in the above example.

strip_url

 # Return todays strip URL
 my $url = strip_url();
 
 # Return the strip URL for 19th August 2005
 $url = strip_url("20050819");

Accepts an optional argument specifying the date of the comic strip in ISO format YYYYMMDD.

get_strip

 # Get todays comic strip image
 my $image_blob = get_strip();

Accepts an optional argument specifying the date of the comic strip in ISO format YYYYMMDD.

mirror_strip

 # Write todays comic strip to "mystrip.gif" on disk
 my $filename_written = mirror_strip("mystrip.gif");

Accepts two optional arguments. The first is the filename that the comic strip should be written to on disk. The second specifies the date of the comic strip in ISO format YYYYMMDD.

Returns the name of the file that was written to disk.

VERSION ^

$Id: VenusEnvy.pm,v 1.10 2006/01/28 13:17:40 nicolaw Exp $

AUTHOR ^

Nicola Worthington <nicolaw@cpan.org>

http://perlgirl.org.uk

COPYRIGHT ^

Copyright 2005,2006 Nicola Worthington.

This software is licensed under The Apache Software License, Version 2.0.

http://www.apache.org/licenses/LICENSE-2.0

syntax highlighting: