README
1NAME
2 WWW::VenusEnvy - Retrieve VenusEnvy comic strip images
3
4SYNOPSIS
5 use WWW::VenusEnvy qw(get_strip mirror_strip strip_url);
6
7 # Get the URL for todays strip
8 my $image_url = strip_url();
9
10 # Get todays strip
11 my $image_blob = get_strip();
12
13 # Get a specific strip by specifying the ID
14 my $christmas_kiss = get_strip("20051229");
15
16 # Write todays strip to local_filename.gif on disk
17 my $filename_written = mirror_strip("local_filename.gif");
18
19 # Write a specific strip to mystrip.gif on disk
20 my $filename_written = mirror_strip("mystrip.gif","20051229");
21
22DESCRIPTION
23 This module will download the latest VenusEnvy comic strip from the
24 Keenspace website and return a binary blob of the image, or write it to
25 disk.
26
27EXPORTS
28 The following functions can be exported with the ":all" export tag, or
29 individually as is show in the above example.
30
31 strip_url
32 # Return todays strip URL
33 my $url = strip_url();
34
35 # Return the strip URL for 19th August 2005
36 $url = strip_url("20050819");
37
38 Accepts an optional argument specifying the date of the comic strip in
39 ISO format "YYYYMMDD".
40
41 get_strip
42 # Get todays comic strip image
43 my $image_blob = get_strip();
44
45 Accepts an optional argument specifying the date of the comic strip in
46 ISO format "YYYYMMDD".
47
48 mirror_strip
49 # Write todays comic strip to "mystrip.gif" on disk
50 my $filename_written = mirror_strip("mystrip.gif");
51
52 Accepts two optional arguments. The first is the filename that the comic
53 strip should be written to on disk. The second specifies the date of the
54 comic strip in ISO format "YYYYMMDD".
55
56 Returns the name of the file that was written to disk.
57
58VERSION
59 $Id: VenusEnvy.pm,v 1.10 2006/01/28 13:17:40 nicolaw Exp $
60
61AUTHOR
62 Nicola Worthington <nicolaw@cpan.org>
63
64 <http://perlgirl.org.uk>
65
66COPYRIGHT
67 Copyright 2005,2006 Nicola Worthington.
68
69 This software is licensed under The Apache Software License, Version
70 2.0.
71
72 <http://www.apache.org/licenses/LICENSE-2.0>
73
74