1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
|
What's IMDbPY?
==============
NOTE: see also the recommendations in the "DISCLAIMER.txt" file.
IMDbPY is a Python package useful to retrieve and manage the data of
the IMDb movie database.
IMDbPY is mainly a tool intended for programmers and developers, but
some example scripts are included.
If you're a poor, simple, clueless user, read the "README.users" file. :-)
Seriously: take a look at the provided example scripts even if you're
a Really Mighty Programmer(tm), they should clearly show how to use IMDbPY.
Other IMDbPY-based programs can be downloaded from:
http://imdbpy.sourceforge.net/?page=programs
If you want to develop a program/script/package/framework using the
IMDbPY package, see the "README.package" file, for instructions about
how to use this package.
If you're installing IMDbPY in a smart phone, PDA or hand-held system,
read the "README.mobile" file.
If you're crazy enough and/or you've realized that your higher
inspiration in life is to help the development of IMDbPY, begin reading
the "README.devel" file. ;-)
INSTALLATION
============
Everything you need to do is to run, as the root user, the command:
# python setup.py install
If, for some reason, it doesn't work, you can copy the "./imdb"
directory in the local site-packages directory of the python
major version you're using.
To know what major version of python you've installed, run:
$ python -V
It should return a string like "Python 2.3.5"; in this example
the major version is "2.3".
Now copy the "./imdb" directory:
# cp -r ./imdb /usr/local/lib/python{MAJORVERSION}/site-packages/
The setup.py contains some configuration options that could
be useful if you're installing IMDbPY in a system with very
little hard disk space (like an handheld device) or where
you've not a complete development environment available;
read the "README.mobile" file.
If you want to use a local copy of the whole IMDb's database,
read the "README.local" file.
If you want to insert the content of the plain text data files
into a SQL database, read the "README.sqldb" file.
HELP
====
Refer to the web site http://imdbpy.sf.net/ and subscribe to the
mailing list: http://imdbpy.sf.net/?page=help#ml
UNICODE NOTICE
==============
Since release 2.4, IMDbPY internally manages every information about
movies and people using unicode strings. Please read the README.utf8 file.
FEATURES
========
So far you can search for a movie with a given title or a person
with a given name, and retrieve information for a given movie or person;
the supported data access systems are 'http' (i.e.: the data are fetched
through the IMDb's web server http://akas.imdb.com) and 'local',
meaning that the data are taken from the plain text data files;
see http://www.imdb.com/interfaces.html for more information.
The same plain text data files used with the 'local' data access
system can be converted to a SQL database, using the "imdbpy2sql.py"
script, and then accessed using the 'sql' data access system.
For mobile systems there's the 'mobile' data access system, useful
for PDA, hand-held devices and smart phones.
Another data access system is 'httpThin', which is equal to 'http'
but fetch less data and so it is (or at least it tries to be)
suitable for systems with limited bandwidth but normal CPU power.
FEATURES OF THE HTTP DATA ACCESS SYSTEM
=======================================
* Returns almost every available information about a movie or person.
* The use of the "akas" server will provide access to a lot of
AKA titles in many languages, so it's really useful if English is
not your native language.
* By default includes adult titles (and people who have worked
only in adult movies) in the results of a title/name search; this
behavior can be changed with the do_adult_search() method; please
read the "README.adult" file.
* You can set/use a proxy to access the web; if set, the HTTP_PROXY
environment variable will be automatically used, otherwise you can set a
proxy with the set_proxy() method of the class returned by the
imdb.IMDb function; obviously this method is available only for the http
data access system, since it's defined in the IMDbHTTPAccessSystem class
of the parser.http package.
Example:
from imdb import IMDb
i = IMDb(accessSystem='http') # the accessSystem argument is not really
# needed, since "http" is the default.
i.set_proxy('http://localhost:8080/')
You can force a direct connection to the net setting the proxy
to a null value (i.e.: i.set_proxy('')).
FEATURES OF THE SQL DATA ACCESS SYSTEM
======================================
* Returns every information available in the plain text data files.
* Every database supported by SQLObject is available.
FEATURES OF THE MOBILE DATA ACCESS SYSTEM
=========================================
* Very lightweight, returns almost every needed information.
* Accessories data sets (like 'goofs', 'trivia' and so on) are always
available (being a subclass of the 'http' data access system).
FEATURES OF THE LOCAL DATA ACCESS SYSTEM
========================================
* Retrieve almost every available information, in a decently short time.
|
