Filmweb¶
-
class
filmweb.filmweb.
Filmweb
¶ -
login
(name, password)¶ Authenticates user.
Parameters: - name (str) – account name
- password (str) – account password
Note
Throws
exceptions.RequestFailed
(20, ‘badCreadentials’) if bad credentials are passed.
-
search
(query)¶ Searches in Filmweb database.
Parameters: query (str) – search query Returns: list containing result items (they can be: Film
,Person
,Channel
,Cinema
)Return type: list Example: fw = Filmweb() items = fw.search('Jak działa jamniczek') if len(items) > 0 and isinstance(items[0], Film): print(items[0].name, items[0].year)
-
get_popular_films
()¶ Returns 100 popular films.
Returns: list of Films
’s
-
get_popular_persons
()¶ Returns 100 popular persons.
Returns: list of Person
’s
-
get_top
(film_type, genre=None, worldwide=True)¶ Returns TOP 500 popular films.
Parameters: - film_type (str) –
Film
type (film, serial, videogame) - genre (str) – genre name (ignored if film_type==videogame)
- worldwide (bool) – determines if returned top
Film
’s should be from any country or only Poland (can’t be False if film_type==videogame)
Returns: list of results
[ { 'film': Film(uid, type, rate, votes), 'position': int(), 'position_prev': int() } ]
- film_type (str) –
-
get_upcoming_films
(above_date=None)¶ Returns upcoming
Film
’sParameters: above_date (date) – date which above results are returned Returns: list of results [ { 'date': str(), 'films': [ { 'film': Film(uid, name, year, poster), 'person_names': [str(), str()] } ] } ]
-
get_born_today_persons
()¶ Returns born today persons.
Returns: list of Person
’s
-
get_trailers
(offset=0, limit=10)¶ Returns trailer from newest.
Parameters: - offset (int) – start position
- limit (int) – maximum of results
Returns: list of
Video
’s
-
get_popular_trailers
(offset=0, limit=10)¶ Returns popular trailers.
Parameters: - offset (int) – start position
- limit (int) – maximum of results
Returns: list of
Video
’s
-
get_video_categories
()¶ Returns Filmweb productions categories.
Returns: list of categories [ { 'name': str(), 'name_friendly': str(), 'description': str() } ]
-
get_filmweb_productions
(category, offset=0, limit=10)¶ Returns newest Filmweb productions from given category.
Parameters: - offset (int) – start position
- limit (int) – maximum of results
Returns: list
[ { 'category_description': str(), 'videos': [Video(uid, category, name, date, img, min_age, vid_urls)] } ]
Note
This gonna throw
exceptions.RequestFailed
(20, ‘IllegalArgumentException’) if category is unknown.
-
update_films_info
(films)¶ Updates multiple film instances with basic info (name, year, rate, votes, duration, poster).
Parameters: films (list) – list of Film
’s instances (max = 100)
-