IMDB::Persons(3pm)

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 one 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
No Matches.=head1 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
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.