Documentation

These are some of the documents for the current stable (4.9) IMDbPY release:

• A short introduction to IMDbPY, its features and instructions to install it (with notes for packagers)
• Instructions and tips to use IMDbPY on mobile systems
• How to put the whole IMDb's database in a SQL database
• Use export information in XML format
• Localize the tags used in the XML format
• Search and manage keywords
• Use the IMDbPY package in your programs
• Basic instructions to develop and extend IMDbPY
• Notes for sensitive people
• About the example scripts
• About TV series' episodes support
• UNICODE support
• Support for characters
• Support for companies
• Things to do

Examples

Here is a short example of how you can use it directly from the Python interpreter or in your own programs:

#!/usr/bin/env python

# Import the imdb package.
import imdb

# Create the object that will be used to access the IMDb's database.
ia = imdb.IMDb() # by default access the web.

# Search for a movie (get a list of Movie objects).
s_result = ia.search_movie('The Untouchables')

# Print the long imdb canonical title and movieID of the results.
for item in s_result:
   print item['long imdb canonical title'], item.movieID

# Retrieves default information for the first result (a Movie object).
the_unt = s_result[0]
ia.update(the_unt)

# Print some information.
print the_unt['runtime']
print the_unt['rating']
director = the_unt['director'] # get a list of Person objects.

# Get the first item listed as a "goof".
ia.update(the_unt, 'goofs')
print the_unt['goofs'][0]

# The first "trivia" for the first director.
b_depalma = director[0]
ia.update(b_depalma)
print b_depalma['trivia'][0]

Another example, using a local SQL database, after you've populated it with the data from the plain text data files using the imdbpy2sql.py script like this (assuming you've already created an imdb empty database: see documentation for more information):

python imdbpy2sql.py -d /path/to/the/plain/text/data/files/ -u mysql://USER:PASSWD@localhost/imdb

#!/usr/bin/env python

from imdb import IMDb

ia = IMDb('sql', uri='mysql://USER:PASSWORD@localhost/imdb')
search_sk = ia.search_person(u'Stanley Kubrick')
for person in search_sk:
   print person['name'], person.personID

sk = search_sk[0]
ia.update(sk)
print 'Last directed movie:', sk['director'][0]

Get help