File Coverage

blib/lib/WebService/BBC/MusicCharts.pm
Criterion Covered Total %
statement 23 56 41.0
branch 2 10 20.0
condition 0 3 0.0
subroutine 7 11 63.6
pod 5 5 100.0
total 37 85 43.5


line stmt bran cond sub pod time code
1             =head1 NAME
2              
3             WebService::BBC::MusicCharts - Retrieve and return UK music chart listings
4              
5             =head1 SYNOPSIS
6              
7             use WebService::BBC::MusicCharts;
8              
9             my $chart = WebService::BBC::MusicCharts->new( chart => 'album' );
10             my $count = 1;
11              
12             foreach my $title ($chart->titles) {
13             print "At $count we have $title\n";
14             $count++;
15             }
16              
17             =head1 DESCRIPTION
18              
19             The WebService::BBC::MusicCharts module provides access to some of the BBCs
20             online music charts via a simple object-oriented interface.
21              
22             It currently supports the singles chart, album chart and downloaded music
23             charts.
24              
25             =head1 EXAMPLES
26              
27             use WebService::BBC::MusicCharts;
28              
29             my $albums = WebService::BBC::MusicCharts->new( chart => 'album' );
30              
31             foreach my $chart_position (1..40) {
32             my $details = $albums->number($chart_position);
33             print "$chart_position: ", $details->{title};
34             print " by ", $details->{artist},"\n";
35             }
36              
37             =cut
38              
39             #######################################################################
40              
41             package WebService::BBC::MusicCharts;
42 1     1   23812 use strict;
  1         2  
  1         35  
43 1     1   5 use warnings;
  1         1  
  1         32  
44 1     1   937 use LWP::Simple qw(get);
  1         82696  
  1         8  
45 1     1   1039 use Template::Extract;
  1         760  
  1         31  
46 1     1   7 use vars qw($VERSION);
  1         2  
  1         779  
47              
48             $VERSION = "0.01";
49              
50             my %charts = (
51             album => 'http://www.bbc.co.uk/radio1/chart/albums.shtml',
52             download => 'http://www.bbc.co.uk/radio1/chart/downloads.shtml',
53             singles => 'http://www.bbc.co.uk/radio1/chart/singles.shtml',
54             );
55              
56              
57             =head1 METHODS
58              
59             =over 4
60              
61             =item new ( chart => 'chart type' )
62              
63             This is the constructor for a new WebService::BBC::MusicCharts object.
64             The C argument is required (and can currently be 'album',
65             'download' or 'singles') and the module will C if it is either
66             missing or passed an invalid value.
67              
68             The constructor also does the actual page fetch, which may also C
69             if the C fails. Wrapping the C invocation in an C isn't
70             a bad idea.
71              
72             =back
73              
74             =cut
75              
76             #----------------------------------------#
77              
78             sub new {
79 1     1 1 13 my $class = shift;
80 1         4 my $self = {@_};
81              
82 1 50       7 die "Unknown chart '$self->{chart}'" unless $charts{$self->{chart}};
83              
84 1         7 my @chart_entries = _get_entries($charts{$self->{chart}});
85              
86 0         0 push(@{$self->{entries}}, @chart_entries);
  0         0  
87              
88 0         0 bless ($self, $class);
89 0         0 return $self;
90             }
91              
92             #----------------------------------------#
93              
94             =over 4
95              
96             =item chart_type
97              
98             Returns the type of chart that this instance represents. Mostly used
99             when I was debugging the module.
100              
101             =back
102              
103             =cut
104              
105             sub chart_type {
106 0     0 1 0 my $self = shift;
107 0         0 return $self->{chart};
108             }
109              
110             #----------------------------------------#
111              
112             =over 4
113              
114             =item titles
115              
116             Returns an array containing all the titles from the chart this instance
117             represents.
118              
119             =back
120              
121             =cut
122              
123             sub titles {
124 0     0 1 0 my $self = shift;
125 0         0 my @titles;
126              
127 0         0 foreach my $title (@{$self->{entries}}) {
  0         0  
128 0         0 push(@titles, $title->{title});
129             }
130              
131 0         0 return @titles;
132             }
133              
134             #----------------------------------------#
135              
136             =over 4
137              
138             =item artists
139              
140             Returns an array containing all the artists from the chart this instance
141             represents.
142              
143             =back
144              
145             =cut
146              
147             # TODO merge the iterator methods in to one.
148              
149             sub artists {
150 0     0 1 0 my $self = shift;
151 0         0 my @artists;
152              
153 0         0 foreach my $title (@{$self->{entries}}) {
  0         0  
154 0         0 push(@artists, $title->{artist});
155             }
156              
157 0         0 return @artists;
158             }
159              
160             #----------------------------------------#
161              
162             =over 4
163              
164             =item number($num)
165              
166             The number method must be called with a valid integer (it accepts any
167             between 1 and 40), it then returns a hash ref containing the details for
168             the song/album at that chart position.
169              
170             The fields returned are:
171             C - the name of the artist
172             C - the title of the single or album </td> </tr> <tr> <td class="h" > <a name="173">173</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> C<label> - the owning record label </td> </tr> <tr> <td class="h" > <a name="174">174</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> C<this_week> - the current chart position of the song/album </td> </tr> <tr> <td class="h" > <a name="175">175</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> C<last_week> - The position this song/album was at last week. This </td> </tr> <tr> <td class="h" > <a name="176">176</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> will either be a number, NEW or RE (re-entry) </td> </tr> <tr> <td class="h" > <a name="177">177</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> C<weeks_in_chart> - the number of weeks it's been in the chart </td> </tr> <tr> <td class="h" > <a name="178">178</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s">   </td> </tr> <tr> <td class="h" > <a name="179">179</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> If called without an argument, or with one that's not between 1 and 40, it </td> </tr> <tr> <td class="h" > <a name="180">180</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> will return undef. </td> </tr> <tr> <td class="h" > <a name="181">181</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s">   </td> </tr> <tr> <td class="h" > <a name="182">182</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> =back </td> </tr> <tr> <td class="h" > <a name="183">183</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s">   </td> </tr> <tr> <td class="h" > <a name="184">184</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> =cut </td> </tr> <tr> <td class="h" > <a name="185">185</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s">   </td> </tr> <tr> <td class="h" > <a name="186">186</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> sub number { </td> </tr> <tr> <td class="h" > <a name="187">187</a> </td> <td class="c0" > 0 </td> <td >   </td> <td >   </td> <td class="c0" > <a href="blib-lib-WebService-BBC-MusicCharts-pm--subroutine.html#187-1"> 0 </a> </td> <td class="c3" > <a href="blib-lib-WebService-BBC-MusicCharts-pm--subroutine.html#187-1"> 1 </a> </td> <td > 0 </td> <td class="s"> my $self = shift; </td> </tr> <tr> <td class="h" > <a name="188">188</a> </td> <td class="c0" > 0 </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td > 0 </td> <td class="s"> my $number = shift; </td> </tr> <tr> <td class="h" > <a name="189">189</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s">   </td> </tr> <tr> <td class="h" > <a name="190">190</a> </td> <td class="c0" > 0 </td> <td class="c0" > <a href="blib-lib-WebService-BBC-MusicCharts-pm--branch.html#190-1"> 0 </a> </td> <td >   </td> <td >   </td> <td >   </td> <td > 0 </td> <td class="s"> return unless $number; </td> </tr> <tr> <td class="h" > <a name="191">191</a> </td> <td class="c0" > 0 </td> <td class="c0" > <a href="blib-lib-WebService-BBC-MusicCharts-pm--branch.html#191-1"> 0 </a> </td> <td >   </td> <td >   </td> <td >   </td> <td > 0 </td> <td class="s"> return unless $number =~ /^\d+$/; </td> </tr> <tr> <td class="h" > <a name="192">192</a> </td> <td class="c0" > 0 </td> <td class="c0" > <a href="blib-lib-WebService-BBC-MusicCharts-pm--branch.html#192-1"> 0 </a> </td> <td class="c0" > <a href="blib-lib-WebService-BBC-MusicCharts-pm--condition.html#192-1"> 0 </a> </td> <td >   </td> <td >   </td> <td > 0 </td> <td class="s"> return if ($number < 1 || $number > 40); </td> </tr> <tr> <td class="h" > <a name="193">193</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s">   </td> </tr> <tr> <td class="h" > <a name="194">194</a> </td> <td class="c0" > 0 </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td > 0 </td> <td class="s"> $number--; # we're using 0 offset arrays </td> </tr> <tr> <td class="h" > <a name="195">195</a> </td> <td class="c0" > 0 </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td > 0 </td> <td class="s"> my $entry = $self->{entries}->[$number]; </td> </tr> <tr> <td class="h" > <a name="196">196</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s">   </td> </tr> <tr> <td class="h" > <a name="197">197</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> } </td> </tr> <tr> <td class="h" > <a name="198">198</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s">   </td> </tr> <tr> <td class="h" > <a name="199">199</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> #----------------------------------------# </td> </tr> <tr> <td class="h" > <a name="200">200</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s">   </td> </tr> <tr> <td class="h" > <a name="201">201</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> # internal function that parses the HTML, builds the objects internal </td> </tr> <tr> <td class="h" > <a name="202">202</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> # state and passes it back to the constructor. Dense but not complex </td> </tr> <tr> <td class="h" > <a name="203">203</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s">   </td> </tr> <tr> <td class="h" > <a name="204">204</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> sub _get_entries { </td> </tr> <tr> <td class="h" > <a name="205">205</a> </td> <td class="c3" > 1 </td> <td >   </td> <td >   </td> <td class="c3" > <a href="blib-lib-WebService-BBC-MusicCharts-pm--subroutine.html#205-1"> 1 </a> </td> <td >   </td> <td > 3 </td> <td class="s"> my $chart_url = shift; </td> </tr> <tr> <td class="h" > <a name="206">206</a> </td> <td class="c3" > 1 </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td > 9 </td> <td class="s"> my $extract = Template::Extract->new(); </td> </tr> <tr> <td class="h" > <a name="207">207</a> </td> <td class="c3" > 1 </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td > 52677 </td> <td class="s"> my @chart_entries; </td> </tr> <tr> <td class="h" > <a name="208">208</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s">   </td> </tr> <tr> <td class="h" > <a name="209">209</a> </td> <td class="c3" > 1 </td> <td class="c0" > <a href="blib-lib-WebService-BBC-MusicCharts-pm--branch.html#209-1"> 50 </a> </td> <td >   </td> <td >   </td> <td >   </td> <td > 10 </td> <td class="s"> my $chart_page = get($chart_url) </td> </tr> <tr> <td class="h" > <a name="210">210</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> or die "Failed to get chart."; </td> </tr> <tr> <td class="h" > <a name="211">211</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s">   </td> </tr> <tr> <td class="h" > <a name="212">212</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> # define the extraction template </td> </tr> <tr> <td class="h" > <a name="213">213</a> </td> <td class="c0" > 0 </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> my $template = << 'END_OF_TEMPLATE'; </td> </tr> <tr> <td class="h" > <a name="214">214</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> [% FOREACH entries %] </td> </tr> <tr> <td class="h" > <a name="215">215</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> [% ... %] </td> </tr> <tr> <td class="h" > <a name="216">216</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> <td class="col1">[% thisweek %]</td>[% ... %] </td> </tr> <tr> <td class="h" > <a name="217">217</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> <td class="col2">[% lastweek %]</td>[% ... %] </td> </tr> <tr> <td class="h" > <a name="218">218</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> <td class="col3">([% weeksin %])</td>[% ... %] </td> </tr> <tr> <td class="h" > <a name="219">219</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> <h4>[% artist %]</h4>[% ... %] </td> </tr> <tr> <td class="h" > <a name="220">220</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> <h5>[% title %]</h5>[% ... %] </td> </tr> <tr> <td class="h" > <a name="221">221</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> <p>([% label %])[% ... %] </td> </tr> <tr> <td class="h" > <a name="222">222</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> [% ... %] </td> </tr> <tr> <td class="h" > <a name="223">223</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> [% END %] </td> </tr> <tr> <td class="h" > <a name="224">224</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> END_OF_TEMPLATE </td> </tr> <tr> <td class="h" > <a name="225">225</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s">   </td> </tr> <tr> <td class="h" > <a name="226">226</a> </td> <td class="c0" > 0 </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> for (@{$extract->extract($template, $chart_page)->{entries}}) { </td> </tr> <tr> <td class="h" > <a > </a> </td> <td class="c0" > 0 </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s">   </td> </tr> <tr> <td class="h" > <a name="227">227</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> # tidy up "last week" </td> </tr> <tr> <td class="h" > <a name="228">228</a> </td> <td class="c0" > 0 </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> $_->{lastweek} =~ m/^\s*(\w+)/; </td> </tr> <tr> <td class="h" > <a name="229">229</a> </td> <td class="c0" > 0 </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> my $last_week = $1; </td> </tr> <tr> <td class="h" > <a name="230">230</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s">   </td> </tr> <tr> <td class="h" > <a name="231">231</a> </td> <td class="c0" > 0 </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> my %entry_details = ( </td> </tr> <tr> <td class="h" > <a name="232">232</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> artist => $_->{artist}, </td> </tr> <tr> <td class="h" > <a name="233">233</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> title => $_->{title}, </td> </tr> <tr> <td class="h" > <a name="234">234</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> label => $_->{label}, </td> </tr> <tr> <td class="h" > <a name="235">235</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> this_week => $_->{thisweek}, </td> </tr> <tr> <td class="h" > <a name="236">236</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> last_week => $last_week, </td> </tr> <tr> <td class="h" > <a name="237">237</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> weeks_in_chart => $_->{weeksin} </td> </tr> <tr> <td class="h" > <a name="238">238</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> ); </td> </tr> <tr> <td class="h" > <a name="239">239</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s">   </td> </tr> <tr> <td class="h" > <a name="240">240</a> </td> <td class="c0" > 0 </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> push(@chart_entries, \%entry_details); </td> </tr> <tr> <td class="h" > <a name="241">241</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> } </td> </tr> <tr> <td class="h" > <a name="242">242</a> </td> <td class="c0" > 0 </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> return @chart_entries; </td> </tr> <tr> <td class="h" > <a name="243">243</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> } </td> </tr> <tr> <td class="h" > <a name="244">244</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s">   </td> </tr> <tr> <td class="h" > <a name="245">245</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> #----------------------------------------# </td> </tr> <tr> <td class="h" > <a name="246">246</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s">   </td> </tr> <tr> <td class="h" > <a name="247">247</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> 1; </td> </tr> <tr> <td class="h" > <a name="248">248</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s">   </td> </tr> <tr> <td class="h" > <a name="249">249</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> ####################################################################### </td> </tr> <tr> <td class="h" > <a name="250">250</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s">   </td> </tr> <tr> <td class="h" > <a name="251">251</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> =head1 DEPENDENCIES </td> </tr> <tr> <td class="h" > <a name="252">252</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s">   </td> </tr> <tr> <td class="h" > <a name="253">253</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> WebService::BBC::MusicCharts requires the following modules: </td> </tr> <tr> <td class="h" > <a name="254">254</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s">   </td> </tr> <tr> <td class="h" > <a name="255">255</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> L<LWP::Simple> </td> </tr> <tr> <td class="h" > <a name="256">256</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s">   </td> </tr> <tr> <td class="h" > <a name="257">257</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> L<Template::Extract> </td> </tr> <tr> <td class="h" > <a name="258">258</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s">   </td> </tr> <tr> <td class="h" > <a name="259">259</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> =head1 LICENCE AND COPYRIGHT </td> </tr> <tr> <td class="h" > <a name="260">260</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s">   </td> </tr> <tr> <td class="h" > <a name="261">261</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> Copyright (C) 2006 Dean Wilson. All Rights Reserved. </td> </tr> <tr> <td class="h" > <a name="262">262</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s">   </td> </tr> <tr> <td class="h" > <a name="263">263</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> This module is free software; you can redistribute it and/or modify it </td> </tr> <tr> <td class="h" > <a name="264">264</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> under the same terms as Perl itself. </td> </tr> <tr> <td class="h" > <a name="265">265</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s">   </td> </tr> <tr> <td class="h" > <a name="266">266</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> =head1 AUTHOR </td> </tr> <tr> <td class="h" > <a name="267">267</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s">   </td> </tr> <tr> <td class="h" > <a name="268">268</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> Dean Wilson <dean.wilson@gmail.com> </td> </tr> <tr> <td class="h" > <a name="269">269</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s">   </td> </tr> <tr> <td class="h" > <a name="270">270</a> </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td >   </td> <td class="s"> =cut </td> </tr> </table> </body> </html>