/ 
WWW-TV-0.03
River stage zero No dependents
/ WWW::TV::Episode

NAME

WWW::TV::Episode - Parse TV.com for TV Episode information.

SYNOPSIS

use WWW::TV::Episode qw();
my $episode = WWW::TV::Series->new(id => '475567');

print $episode->summary;

DESCRIPTION

The WWW::TV::Episode module parses TV.com episode information using LWP::UserAgent. Unfortunately I can't see a way to search for an episode by name, so I haven't implemented it. It is probably possible to do so if you populate a series object and grep $series->episodes for the episode name you are searching for.

METHODS

new

The new() method is the constructor. It takes the id of the show
assuming you have previously looked that up.

    my $episode = WWW::TV::Episode->new(id => 475567);

It also (optionally) takes the name of the episode. This is not used
in any way to search for the episode, but is used as initial data
population for that field so that the html isn't parsed if you only
want an object with the name. This is used by the L<WWW::TV::Series>
object to populate a big array of episodes that have names without
needing to fetch any pages.

id

The ID of this episode, according to TV.com

name

Returns a string containing the name of the episode.

summary

Returns a string containing basic information about this series.

season_number

Returns the season number that this episode appeared in.

episode_number

Returns the overall number of this episode. Note, this is not
necessarily the production order of the episodes, but is the order
in which they aired.

first_aired

Returns a string of the date this episode first aired.

stars

Returns a comma delimited string of the stars that appeared in this episode

guest_stars

Returns a comma delimited string of the guest stars that appeared in this
episode

recurring_roles

Returns a comma delimited string of the people who have recurring roles
that appeared in this episode

writer

Returns a comma delimited string of the people that wrote this episode

directors

Returns a comma delimited string of the people that directed this episode

url

Returns the url that was used to create this object.

series

Returns an L<WWW::TV::Series> object which is the series that this
episode is a part of.

SEE ALSO

WWW::TV::Series

KNOWN ISSUES

There isn't yet any caching support. I don't see a need for it, but if you feel the need to implement it then don't let me stop you.

There also isn't support for proxy servers yet. LWP should use it from your environment if you really need it, but who still uses them anyway? Isn't it all done transparently these days.

BUGS

Please report any bugs or feature requests to bug-WWW-TV@rt.cpan.org, or through the web interface at http://rt.cpan.org.

AUTHOR

Danial Pearce cpan@tigris.id.au

LICENCE AND COPYRIGHT

Copyright (c) 2006, Danial Pearce cpan@tigris.id.au. All rights reserved.

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