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
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
|
MANAGING SERIES EPISODES
========================
Since January 2006, IMDb changed the way it handles TV episodes:
now every episode is treated as full title.
Starting with version 2.5, also IMDbPY supports this new behavior.
The implementation is beta, and still subject to change.
Please try it and comment it.
TITLES
======
analyze_title() and build_title() now supports tv episodes.
You can pass a string to the analyze_title function in the format used
by the web server ("The Series" The Episode (2005)) or in the format
of the plain text data files ("The Series" (2004) {The Episode (#ser.epi)})
An example of the returned dictionary: call the function:
analyze_title('"The Series" The Episode (2005)', canonical=1)
the result will be:
{'kind': 'episode', # kind is set to 'episode'.
'year': '2005', # the release year of this episode.
'title': 'Episode, The', # episode title
'episode of': {'kind': 'tv series', # 'episode of' will contains
'title': 'Series, The'} # information about the series.
}
The 'episode of' key can be a dictionary or a Movie class instance with
the same information.
The build_title() function takes an optional argument: ptdf; is it's
set to false (the default), it returns the title of the episode in
the format used by the IMDb's web server ("Series, The" An Episode (2005)),
otherwise it uses the format used by the plain text data files (something
like "Series, The" (2004) {An Episode (#2.5)})
SERIES
======
You can retrieve information about seasons and episodes for a tv series:
from imdb import IMDb
i = IMDb()
m = i.get_movie('0389564') # The 4400.
m['kind'] # kind is 'tv series'.
i.update(m, 'episodes') # retrieves episodes information.
m['episodes'] # a dictionary with the format:
# {#season_number: {
# #episode_number: Movie object,
# #episode_number: Movie object,
# ...
# },
# ...
# }
# season_number always starts with 1, episode_number
# depends on the series' numbering schema: some series
# have a 'episode 0', while others starts counting from 1.
m['episodes'][1][1] # <Movie id:0502803[http] title:_"The 4400" Pilot (2004)_>
e = m['episodes'][1][2] # second episode of the first season.
e['kind'] # kind is 'episode'.
e['season'], e['episode'] # return 1, 2.
e['episode of'] # <Movie id:0389564[http] title:_"4400, The" (2004)_>
# XXX: beware that e['episode of'] and m _are not_ the
# same object, while both represents the same series.
# This is to avoid circular references; the
# e['episode of'] object only contains basics
# information (title, movieID, year, ....)
i.update(e) # retrieve normal information about this episode (cast, ...)
e['title'] # 'The New and Improved Carl Morrissey'
e['series title'] # 'The 4400'
e['long imdb episode title'] # '"The 4400" The New and Improved Carl Morrissey (2004)'
Summary of keys of the Movie object for a series episode:
'kind': set to 'episode'.
'episode of': set to a movie object, this is a reference to the series.
'season': an integer; the number of the season.
'episode': an integer; the number of the episode in the season.
'long imdb episode title': combines series and episode title.
'series title': title of the series.
'canonical series title': title of the series, in the canonical format.
Summary of keys of the Movie object for a series:
'kind': set to 'tv series'.
'episodes': dictionary (seasons) of dictionary (episodes in the season).
PEOPLE
======
You can retrieve information about single episodes acted/directed/... by
a person.
from imdb import IMDb
i = IMDb()
p = i.get_person('0005041') # Laura Innes.
p['actress'][0] # <Movie id:0568152[http] title:_"ER" (????)_>
# At this point you have an entry (in keys like 'actor', 'actress',
# 'director', ...) for every series the person starred/worked in, but
# you knows nothing about singles episodes.
i.update(p, 'episodes') # updates information about single episodes.
p['episodes'] # a dictionary with the format:
# {<TV Series Movie Object>: [
<Episode Movie Object>,
<Episode Movie Object>,
...
],
...
}
er = p['actress'][0] # ER tv series.
p['episodes'][er] # list of Movie objects; one for every ER episode
# she starred/worked in.
p['episodes'][er][0] # <Movie id:0568154[http] title:_"ER" Welcome Back Carter! (1995)_>
p['episodes'][er]['kind'] # 'episode'
p['episodes'][er][0].currentRole # 'Dr. Kerry Weaver'
GOODIES
=======
In the imdb.helpers module there are some functions useful to manage
lists of episodes:
- sortedSeasons(m) returns a sorted list of seasons of the given series.
E.g.:
>>> from imdb import IMDb
>>> i = IMDb()
>>> m = i.get_movie('0411008')
>>> i.update(m, 'episodes')
>>> sortedSeasons(m)
[1, 2]
- sortedEpisodes(m, season=None) returns a sorted list of episodes of the
the given series, considering only the
specified season(s) (every season, if None).
E.g.:
>>> from imdb import IMDb
>>> i = IMDb()
>>> m = i.get_movie('0411008')
>>> i.update(m, 'episodes')
>>> sortedEpisodes(m, season=1)
[<Movie id:0636289[http] title:_"Lost" Pilot: Part 1 (2004)_>, <Movie id:0636290[http] title:_"Lost" Pilot: Part 2 (2004)_>, ...]
|
