README
1NAME
2 WWW::Dilbert - Retrieve Dilbert of the day comic strip images
3
4SYNOPSIS
5 use WWW::Dilbert 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 $ethical_garbage_man = get_strip("2666040051128");
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","2666040051128");
21
22DESCRIPTION
23 This module will download the latest Dilbert of the Day cartoon strip
24 from the Dilbert website and return a binary blob of the image, or write
25 it to 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 matching ID 200512287225
36 $url = strip_url("200512287225");
37
38 Accepts an optional argument strip ID argument.
39
40 get_strip
41 # Get todays comic strip image
42 my $image_blob = get_strip();
43
44 Accepts an optional argument strip ID argument.
45
46 mirror_strip
47 # Write todays comic strip to "mystrip.gif" on disk
48 my $filename_written = mirror_strip("mystrip.gif");
49
50 Accepts two optional arguments. The first is the filename that the comic
51 strip should be written to on disk. The second specifies the strip ID.
52
53 Returns the name of the file that was written to disk.
54
55VERSION
56 $Id: Dilbert.pm,v 1.19 2006/01/12 22:30:11 nicolaw Exp $
57
58AUTHOR
59 Nicola Worthington <nicolaw@cpan.org>
60
61 <http://perlgirl.org.uk>
62
63COPYRIGHT
64 Copyright 2004,2005,2006 Nicola Worthington.
65
66 This software is licensed under The Apache Software License, Version
67 2.0.
68
69 <http://www.apache.org/licenses/LICENSE-2.0>
70
71