IMDB::Persons.3pm

Langue: en

Autres versions - même langue

Version: 2009-12-14 (ubuntu - 24/10/10)

Section: 3 (Bibliothèques de fonctions)

Sommaire

NAME

IMDB::Persons - Perl extension for retrieving movies persons from IMDB.com

SYNOPSIS

         use IMDB::Persons;
 
         #
         # Retrieve a person information by IMDB code
         #
         my $person = new IMDB::Persons(crit => '0000129');
 
         or 
 
         #
         # Retrieve a person information by name
         #
         my $person = new IMDB::Persons(crit => 'Tom Cruise');
 
         or 
 
         #
         # Process already stored HTML page from IMDB
         #
         my $person = new IMDB::Persons(file => 'imdb.html');
 
         if($person->status) {
                 print "Name: ".$person->name."\n";
                 print "Birth Date: ".$person->date_of_birth."\n";
         } else {
                 print "Something wrong: ".$person->error."!\n";
         }

DESCRIPTION

IMDB::Persons allows to retrieve an information about IMDB persons (actors, actresses, directors etc): full name, photo, date and place of birth, mini bio and filmography.

Object Private Methods

_init()
Initialize a new object.
_search_person()
Implements a logic to search IMDB persons by their names.

Object Public Methods

name()
Retrieve a person full name 
         my $person_name = $person->name();
mini_bio()
Returns a mini bio for specified IMDB person 
         my $mini_bio = $person->mini_bio();
date_of_birth()
Returns a date of birth of IMDB person in format 'day' 'month caption' 'year': 
         my $d_birth = $person->date_of_birth();
place_of_birth()
Returns a name of place of the birth 
         my $place = $person->place_of_birth();
photo()
Return a path to the person's photo 
         my $photo = $person->photo();
filmography()
Returns a person's filmography as a hash of arrays with following structure: 
         my $fg = $person->filmography();
 
         __DATA__
         $fg = {
                 'Section' => [
                         {       title   => 'movie title', 
                                 role    => 'person role', 
                                 year    => 'year of movie production',
                                 code    => 'IMDB code of movie',        
                         }
                 ];
         }

The section can be In Development, Actor, Self, Thanks, Archive Footage, Producer etc.

genres()
Retrieve a list of movie genres for specified person: 
         my $genres = $persons->genres;
plot_keywords()
Retrieve a list of keywords for movies where specified person plays: 
         my $keywords = $persons->plot_keywords;

EXPORTS

Nothing

BUGS

Please, send me any found bugs by email: stepanov.michael@gmail.com.

SEE ALSO

IMDB::Film IMDB::BaseClass WWW::Yahoo::Movies HTML::TokeParser

AUTHOR

Mikhail Stepanov AKA nite_man (stepanov.michael@gmail.com) Copyright (c) 2004 - 2007, Mikhail Stepanov. This module is free software. It may be used, redistributed and/or modified under the same terms as Perl itself.