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)

Returns 100 popular films.

Returns:list of Films’s

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()
   }
]
get_upcoming_films(above_date=None)

Returns upcoming Film’s

Parameters: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

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)