import datetime import logging import re from .exceptions import TraktException, TraktAuthException from exceptions_helper import ConnectionSkipException, ex from six import iteritems from .trakt import TraktAPI from lib.tvinfo_base.exceptions import BaseTVinfoShownotfound from lib.tvinfo_base import TVInfoBase, TVINFO_TRAKT, TVINFO_TMDB, TVINFO_TVDB, TVINFO_TVRAGE, TVINFO_IMDB, \ TVINFO_SLUG, TVInfoPerson, TVINFO_TWITTER, TVINFO_FACEBOOK, TVINFO_WIKIPEDIA, TVINFO_INSTAGRAM, TVInfoCharacter, \ TVInfoShow, TVInfoIDs, TVInfoSocialIDs, TVINFO_TRAKT_SLUG, TVInfoEpisode, TVInfoSeason, RoleTypes from sg_helpers import clean_data, enforce_type, try_int from lib.dateutil.parser import parser # noinspection PyUnreachableCode if False: from typing import Any, AnyStr, Dict, List, Optional, Union from six import integer_types id_map = { 'trakt': TVINFO_TRAKT, 'slug': TVINFO_SLUG, 'tvdb': TVINFO_TVDB, 'imdb': TVINFO_IMDB, 'tmdb': TVINFO_TMDB, 'tvrage': TVINFO_TVRAGE } id_map_reverse = {v: k for k, v in iteritems(id_map)} tz_p = parser() log = logging.getLogger('api_trakt.api') log.addHandler(logging.NullHandler()) def _convert_imdb_id(src, s_id): # type: (int, integer_types) -> integer_types if TVINFO_IMDB == src: try: return try_int(re.search(r'(\d+)', s_id).group(1), s_id) except (BaseException, Exception): pass return s_id class TraktSearchTypes(object): text = 1 trakt_id = 'trakt' trakt_slug = 'trakt_slug' tvdb_id = 'tvdb' imdb_id = 'imdb' tmdb_id = 'tmdb' tvrage_id = 'tvrage' all = [text, trakt_id, tvdb_id, imdb_id, tmdb_id, tvrage_id, trakt_slug] def __init__(self): pass map_id_search = {TVINFO_TVDB: TraktSearchTypes.tvdb_id, TVINFO_IMDB: TraktSearchTypes.imdb_id, TVINFO_TMDB: TraktSearchTypes.tmdb_id, TVINFO_TRAKT: TraktSearchTypes.trakt_id, TVINFO_TRAKT_SLUG: TraktSearchTypes.trakt_slug} class TraktResultTypes(object): show = 'show' episode = 'episode' movie = 'movie' person = 'person' list = 'list' all = [show, episode, movie, person, list] def __init__(self): pass class TraktIndexer(TVInfoBase): supported_id_searches = [TVINFO_TVDB, TVINFO_IMDB, TVINFO_TMDB, TVINFO_TRAKT, TVINFO_TRAKT_SLUG] supported_person_id_searches = [TVINFO_TRAKT, TVINFO_IMDB, TVINFO_TMDB] # noinspection PyUnusedLocal # noinspection PyDefaultArgument def __init__(self, custom_ui=None, sleep_retry=None, search_type=TraktSearchTypes.text, result_types=[TraktResultTypes.show], *args, **kwargs): super(TraktIndexer, self).__init__(*args, **kwargs) self.config.update({ 'apikey': '', 'debug_enabled': False, 'custom_ui': custom_ui, 'proxy': None, 'cache_enabled': False, 'cache_location': '', 'valid_languages': [], 'langabbv_to_id': {}, 'language': 'en', 'base_url': '', 'search_type': search_type if search_type in TraktSearchTypes.all else TraktSearchTypes.text, 'sleep_retry': sleep_retry, 'result_types': result_types if isinstance(result_types, list) and all( [x in TraktResultTypes.all for x in result_types]) else [TraktResultTypes.show], }) @staticmethod def _make_result_obj(shows, results): # type: (List[Dict], List[TVInfoShow]) -> None if shows: try: for s in shows: if s['ids']['trakt'] not in [i['ids'].trakt for i in results]: ti_show = TVInfoShow() countries = clean_data(s['country']) if countries: countries = [countries] else: countries = [] ti_show.id, ti_show.seriesname, ti_show.overview, ti_show.firstaired, ti_show.airs_dayofweek, \ ti_show.runtime, ti_show.network, ti_show.origin_countries, ti_show.official_site, \ ti_show.status, ti_show.rating, ti_show.genre_list, ti_show.ids = s['ids']['trakt'], \ clean_data(s['title']), enforce_type(clean_data(s['overview']), str, ''), s['firstaired'], \ (isinstance(s['airs'], dict) and s['airs']['day']) or '', \ s['runtime'], s['network'], countries, s['homepage'], s['status'], s['rating'], \ s['genres_list'], \ TVInfoIDs(trakt=s['ids']['trakt'], tvdb=s['ids']['tvdb'], tmdb=s['ids']['tmdb'], rage=s['ids']['tvrage'], imdb=s['ids']['imdb'] and try_int(s['ids']['imdb'].replace('tt', ''), None)) ti_show.genre = '|'.join(ti_show.genre_list or []) results.append(ti_show) except (BaseException, Exception) as e: log.debug('Error creating result dict: %s' % ex(e)) def _search_show(self, name=None, ids=None, **kwargs): # type: (AnyStr, Dict[integer_types, integer_types], Optional[Any]) -> List[TVInfoShow] """This searches Trakt for the series name, If a custom_ui UI is configured, it uses this to select the correct series. """ results = [] # type: List[TVInfoShow] if ids: for t, p in iteritems(ids): if t in self.supported_id_searches: if t in (TVINFO_TVDB, TVINFO_IMDB, TVINFO_TMDB, TVINFO_TRAKT, TVINFO_TRAKT_SLUG): cache_id_key = 's-id-%s-%s' % (t, p) is_none, shows = self._get_cache_entry(cache_id_key) if not self.config.get('cache_search') or (None is shows and not is_none): try: show = self.search(p, search_type=map_id_search[t]) except (BaseException, Exception): continue self._set_cache_entry(cache_id_key, show, expire=self.search_cache_expire) else: show = shows else: continue self._make_result_obj(show, results) if name: names = ([name], name)[isinstance(name, list)] len_names = len(names) for i, n in enumerate(names, 1): cache_name_key = 's-name-%s' % n is_none, shows = self._get_cache_entry(cache_name_key) if not self.config.get('cache_search') or (None is shows and not is_none): try: all_series = self.search(n) self._set_cache_entry(cache_name_key, all_series, expire=self.search_cache_expire) except (BaseException, Exception): all_series = [] else: all_series = shows if not isinstance(all_series, list): all_series = [all_series] if i == len_names and 0 == len(all_series) and not results: log.debug('Series result returned zero') raise BaseTVinfoShownotfound('Show-name search returned zero results (cannot find show on TVDB)') if all_series: if None is not self.config['custom_ui']: log.debug('Using custom UI %s' % self.config['custom_ui'].__name__) custom_ui = self.config['custom_ui'] ui = custom_ui(config=self.config) self._make_result_obj(ui.select_series(all_series), results) else: self._make_result_obj(all_series, results) final_result = [] # type: List[TVInfoShow] seen = set() film_type = re.compile(r'(?i)films?\)$') for r in results: if r.id not in seen: seen.add(r.id) title = r.seriesname or '' if not film_type.search(title): final_result.append(r) else: log.debug('Search result ignored: %s ' % title) return final_result @staticmethod def _dict_prevent_none(d, key, default): v = None if isinstance(d, dict): v = d.get(key, default) return (v, default)[None is v] def search(self, series, search_type=None): # type: (AnyStr, Union[int, AnyStr]) -> List search_type = search_type or self.config['search_type'] if TraktSearchTypes.trakt_slug == search_type: url = '/shows/%s?extended=full' % series elif TraktSearchTypes.text != search_type: url = '/search/%s/%s?type=%s&extended=full&limit=100' % (search_type, (series, 'tt%07d' % series)[ TraktSearchTypes.imdb_id == search_type and not str(series).startswith('tt')], ','.join(self.config['result_types'])) else: url = '/search/%s?query=%s&extended=full&limit=100' % (','.join(self.config['result_types']), series) filtered = [] kwargs = {} if None is not self.config['sleep_retry']: kwargs['sleep_retry'] = self.config['sleep_retry'] try: from sickgear.helpers import clean_data resp = TraktAPI().trakt_request(url, **kwargs) if len(resp): if isinstance(resp, dict): resp = [{'type': 'show', 'score': 1, 'show': resp}] for d in resp: if isinstance(d, dict) and 'type' in d and d['type'] in self.config['result_types']: for k, v in iteritems(d): d[k] = clean_data(v) if 'show' in d and TraktResultTypes.show == d['type']: d.update(d['show']) del d['show'] d['seriesname'] = self._dict_prevent_none(d, 'title', '') d['genres_list'] = d.get('genres', []) d['genres'] = ', '.join(['%s' % v for v in d.get('genres', []) or [] if v]) d['firstaired'] = (d.get('first_aired') and re.sub(r'T.*$', '', str(d.get('first_aired'))) or d.get('year')) filtered.append(d) except (ConnectionSkipException, TraktException) as e: log.debug('Could not connect to Trakt service: %s' % ex(e)) return filtered @staticmethod def _convert_person_obj(person_obj): # type: (Dict) -> TVInfoPerson try: birthdate = person_obj['birthday'] and tz_p.parse(person_obj['birthday']).date() except (BaseException, Exception): birthdate = None try: deathdate = person_obj['death'] and tz_p.parse(person_obj['death']).date() except (BaseException, Exception): deathdate = None return TVInfoPerson(p_id=person_obj['ids']['trakt'], name=person_obj['name'], bio=person_obj['biography'], birthdate=birthdate, deathdate=deathdate, homepage=person_obj['homepage'], birthplace=person_obj['birthplace'], social_ids=TVInfoSocialIDs( ids={TVINFO_TWITTER: person_obj['social_ids']['twitter'], TVINFO_FACEBOOK: person_obj['social_ids']['facebook'], TVINFO_INSTAGRAM: person_obj['social_ids']['instagram'], TVINFO_WIKIPEDIA: person_obj['social_ids']['wikipedia'] }), ids=TVInfoIDs(ids={ TVINFO_TRAKT: person_obj['ids']['trakt'], TVINFO_SLUG: person_obj['ids']['slug'], TVINFO_IMDB: person_obj['ids']['imdb'] and try_int(person_obj['ids']['imdb'].replace('nm', ''), None), TVINFO_TMDB: person_obj['ids']['tmdb'], TVINFO_TVRAGE: person_obj['ids']['tvrage']})) def get_person(self, p_id, get_show_credits=False, get_images=False, **kwargs): # type: (integer_types, bool, bool, Any) -> Optional[TVInfoPerson] """ get person's data for id or list of matching persons for name :param p_id: persons id :param get_show_credits: get show credits (only for native id) :param get_images: get images for person :return: person object """ if not p_id: return urls = [('/people/%s?extended=full' % p_id, False)] if get_show_credits: urls.append(('/people/%s/shows?extended=full' % p_id, True)) if not urls: return result = None # type: Optional[TVInfoPerson] for url, show_credits in urls: try: cache_key_name = 'p-%s-%s' % (('main', 'credits')[show_credits], p_id) is_none, resp = self._get_cache_entry(cache_key_name) if None is resp and not is_none: resp = TraktAPI().trakt_request(url, **kwargs) self._set_cache_entry(cache_key_name, resp) if resp: if show_credits: pc = [] for c in resp.get('cast') or []: ti_show = TVInfoShow() ti_show.id = c['show']['ids'].get('trakt') ti_show.seriesname = c['show']['title'] ti_show.ids = TVInfoIDs(ids={id_map[src]: _convert_imdb_id(id_map[src], sid) for src, sid in iteritems(c['show']['ids']) if src in id_map}) ti_show.network = c['show']['network'] ti_show.firstaired = c['show']['first_aired'] ti_show.overview = enforce_type(clean_data(c['show']['overview']), str, '') ti_show.status = c['show']['status'] ti_show.imdb_id = c['show']['ids'].get('imdb') ti_show.runtime = c['show']['runtime'] ti_show.genre_list = c['show']['genres'] for ch in c.get('characters') or []: _ti_character = TVInfoCharacter(name=ch, regular=c.get('series_regular'), ti_show=ti_show, person=[result], episode_count=c.get('episode_count')) pc.append(_ti_character) ti_show.cast[(RoleTypes.ActorGuest, RoleTypes.ActorMain)[ c.get('series_regular', False)]].append(_ti_character) result.characters = pc else: result = self._convert_person_obj(resp) except ConnectionSkipException as e: raise e except TraktException as e: log.debug('Could not connect to Trakt service: %s' % ex(e)) return result def _search_person(self, name=None, ids=None): # type: (AnyStr, Dict[integer_types, integer_types]) -> List[TVInfoPerson] urls, result, ids = [], [], ids or {} for tv_src in self.supported_person_id_searches: if tv_src in ids: if TVINFO_TRAKT == tv_src: url = '/people/%s?extended=full' % ids.get(tv_src) elif tv_src in (TVINFO_IMDB, TVINFO_TMDB): url = '/search/%s/%s?type=person&extended=full&limit=100' % \ (id_map_reverse[tv_src], (ids.get(tv_src), 'nm%07d' % ids.get(tv_src))[TVINFO_IMDB == tv_src]) else: continue urls.append((tv_src, ids.get(tv_src), url)) if name: urls.append(('text', name, '/search/person?query=%s&extended=full&limit=100' % name)) for src, s_id, url in urls: try: cache_key_name = 'p-src-%s-%s' % (src, s_id) is_none, resp = self._get_cache_entry(cache_key_name) if None is resp and not is_none: resp = TraktAPI().trakt_request(url) self._set_cache_entry(cache_key_name, resp) if resp: for per in (resp, [{'person': resp, 'type': 'person'}])[url.startswith('/people')]: if 'person' != per['type']: continue person = per['person'] if not any(1 for p in result if person['ids']['trakt'] == p.id): result.append(self._convert_person_obj(person)) except ConnectionSkipException as e: raise e except TraktException as e: log.debug('Could not connect to Trakt service: %s' % ex(e)) return result @staticmethod def _convert_episode(episode_data, show_obj, season_obj): # type: (Dict, TVInfoShow, TVInfoSeason) -> TVInfoEpisode ti_episode = TVInfoEpisode(show=show_obj) ti_episode.season = season_obj ti_episode.id, ti_episode.episodename, ti_episode.seasonnumber, ti_episode.episodenumber, \ ti_episode.absolute_number, ti_episode.overview, ti_episode.firstaired, ti_episode.runtime, \ ti_episode.rating, ti_episode.vote_count = episode_data.get('ids', {}).get('trakt'), \ clean_data(episode_data.get('title')), episode_data.get('season'), episode_data.get('number'), \ episode_data.get('number_abs'), enforce_type(clean_data(episode_data.get('overview')), str, ''), \ re.sub('T.+$', '', episode_data.get('first_aired') or ''), \ episode_data['runtime'], episode_data.get('rating'), episode_data.get('votes') if episode_data.get('available_translations'): ti_episode.language = clean_data(episode_data['available_translations'][0]) ti_episode.ids = TVInfoIDs(ids={id_map[src]: _convert_imdb_id(id_map[src], sid) for src, sid in iteritems(episode_data['ids']) if src in id_map}) return ti_episode @staticmethod def _convert_show(show_data): # type: (Dict) -> TVInfoShow _s_d = (show_data, show_data.get('show'))['show' in show_data] ti_show = TVInfoShow() ti_show.seriesname, ti_show.id, ti_show.firstaired, ti_show.overview, ti_show.runtime, ti_show.network, \ ti_show.network_country, ti_show.status, ti_show.genre_list, ti_show.language, ti_show.watcher_count, \ ti_show.play_count, ti_show.collected_count, ti_show.collector_count, ti_show.vote_count, \ ti_show.vote_average, ti_show.rating, ti_show.contentrating, ti_show.official_site, ti_show.slug = \ clean_data(_s_d['title']), _s_d['ids']['trakt'], \ re.sub('T.+$', '', _s_d.get('first_aired') or '') or _s_d.get('year'), \ enforce_type(clean_data(_s_d.get('overview')), str, ''), _s_d.get('runtime'), _s_d.get('network'), \ _s_d.get('country'), _s_d.get('status'), _s_d.get('genres', []), _s_d.get('language'), \ show_data.get('watcher_count'), show_data.get('play_count'), show_data.get('collected_count'), \ show_data.get('collector_count'), _s_d.get('votes'), _s_d.get('rating'), _s_d.get('rating'), \ _s_d.get('certification'), _s_d.get('homepage'), _s_d['ids']['slug'] ti_show.ids = TVInfoIDs(ids={id_map[src]: _convert_imdb_id(id_map[src], sid) for src, sid in iteritems(_s_d['ids']) if src in id_map}) ti_show.genre = '|'.join(ti_show.genre_list or []) if _s_d.get('trailer'): ti_show.trailers = {'any': _s_d['trailer']} if 'episode' in show_data: ep_data = show_data['episode'] ti_show.next_season_airdate = re.sub('T.+$', '', ep_data.get('first_aired') or '') ti_season = TVInfoSeason(show=ti_show) ti_season.number = ep_data['season'] ti_season[ep_data['number']] = TraktIndexer._convert_episode(ep_data, ti_show, ti_season) ti_show[ep_data['season']] = ti_season return ti_show def _get_show_lists(self, url, account=None): # type: (str, Any) -> List[TVInfoShow] result = [] if account: from sickgear import TRAKT_ACCOUNTS if account in TRAKT_ACCOUNTS and TRAKT_ACCOUNTS[account].active: kw = {'send_oauth': account} else: raise TraktAuthException('Account missing or disabled') else: kw = {} resp = TraktAPI().trakt_request(url, **kw) if resp: for _show in resp: result.append(self._convert_show(_show)) return result def get_most_played(self, result_count=100, period='weekly', **kwargs): # type: (...) -> List[TVInfoShow] """ get most played shows :param period: possible values: 'daily', 'weekly', 'monthly', 'yearly', 'all' :param result_count: how many results are suppose to be returned """ use_period = ('weekly', period)[period in ('daily', 'weekly', 'monthly', 'yearly', 'all')] return self._get_show_lists('shows/played/%s?extended=full&page=%d&limit=%d' % (use_period, 1, result_count)) def get_most_watched(self, result_count=100, period='weekly', **kwargs): # type: (...) -> List[TVInfoShow] """ get most watched shows :param period: possible values: 'daily', 'weekly', 'monthly', 'yearly', 'all' :param result_count: how many results are suppose to be returned """ use_period = ('weekly', period)[period in ('daily', 'weekly', 'monthly', 'yearly', 'all')] return self._get_show_lists('shows/watched/%s?extended=full&page=%d&limit=%d' % (use_period, 1, result_count)) def get_most_collected(self, result_count=100, period='weekly', **kwargs): # type: (...) -> List[TVInfoShow] """ get most collected shows :param period: possible values: 'daily', 'weekly', 'monthly', 'yearly', 'all' :param result_count: how many results are suppose to be returned """ use_period = ('weekly', period)[period in ('daily', 'weekly', 'monthly', 'yearly', 'all')] return self._get_show_lists('shows/collected/%s?extended=full&page=%d&limit=%d' % (use_period, 1, result_count)) def get_recommended(self, result_count=100, period='weekly', **kwargs): # type: (...) -> List[TVInfoShow] """ get most recommended shows :param period: possible values: 'daily', 'weekly', 'monthly', 'yearly', 'all' :param result_count: how many results are suppose to be returned """ use_period = ('weekly', period)[period in ('daily', 'weekly', 'monthly', 'yearly', 'all')] return self._get_show_lists('shows/recommended/%s?extended=full&page=%d&limit=%d' % (use_period, 1, result_count)) def get_recommended_for_account(self, account, result_count=100, ignore_collected=False, ignore_watchlisted=False, **kwargs): # type: (...) -> List[TVInfoShow] """ get most recommended shows for account :param account: account to get recommendations for :param result_count: how many results are suppose to be returned :param ignore_collected: exclude colleded shows :param ignore_watchlisted: exclude watchlisted shows """ from sickgear import TRAKT_ACCOUNTS if not account or account not in TRAKT_ACCOUNTS or not TRAKT_ACCOUNTS[account].active: raise TraktAuthException('Account missing or disabled') extra_param = [] if ignore_collected: extra_param.append('ignore_collected=true') if ignore_watchlisted: extra_param.append('ignore_watchlisted=true') return self._get_show_lists('recommendations/shows?extended=full&page=%d&limit=%d%s' % (1, result_count, ('', '&%s' % '&'.join(extra_param))[0 < len(extra_param)]), account=account) def hide_recommended_for_account(self, account, show_ids, **kwargs): # type: (integer_types, List[integer_types], Any) -> List[integer_types] """ hide recommended show for account :param account: account to get recommendations for :param show_ids: list of show_ids to no longer recommend for account :return: list of added ids """ from sickgear import TRAKT_ACCOUNTS if not account or account not in TRAKT_ACCOUNTS or not TRAKT_ACCOUNTS[account].active: raise TraktAuthException('Account missing or disabled') if not isinstance(show_ids, list) or not show_ids or any(not isinstance(_i, int) for _i in show_ids): raise TraktException('list of show_ids (trakt id) required') resp = TraktAPI().trakt_request('users/hidden/recommendations', send_oauth=account, data={'shows': [{'ids': {'trakt': _i}} for _i in show_ids]}) if resp and isinstance(resp, dict) and 'added' in resp and 'shows' in resp['added']: if len(show_ids) == resp['added']['shows']: return show_ids if 'not_found' in resp and 'shows' in resp['not_found']: not_found = [_i['ids']['trakt'] for _i in resp['not_found']['shows']] else: not_found = [] return [_i for _i in show_ids if _i not in not_found] return [] def unhide_recommended_for_account(self, account, show_ids, **kwargs): # type: (integer_types, List[integer_types], Any) -> List[integer_types] """ unhide recommended show for account :param account: account to get recommendations for :param show_ids: list of show_ids to be included in possible recommend for account :return: list of removed ids """ from sickgear import TRAKT_ACCOUNTS if not account or account not in TRAKT_ACCOUNTS or not TRAKT_ACCOUNTS[account].active: raise TraktAuthException('Account missing or disabled') if not isinstance(show_ids, list) or not show_ids or any(not isinstance(_i, int) for _i in show_ids): raise TraktException('list of show_ids (trakt id) required') resp = TraktAPI().trakt_request('users/hidden/recommendations/remove', send_oauth=account, data={'shows': [{'ids': {'trakt': _i}} for _i in show_ids]}) if resp and isinstance(resp, dict) and 'deleted' in resp and 'shows' in resp['deleted']: if len(show_ids) == resp['deleted']['shows']: return show_ids if 'not_found' in resp and 'shows' in resp['not_found']: not_found = [_i['ids']['trakt'] for _i in resp['not_found']['shows']] else: not_found = [] return [_i for _i in show_ids if _i not in not_found] return [] def list_hidden_recommended_for_account(self, account, **kwargs): # type: (integer_types, Any) -> List[TVInfoShow] """ list hidden recommended show for account :param account: account to get recommendations for :return: list of hidden shows """ from sickgear import TRAKT_ACCOUNTS if not account or account not in TRAKT_ACCOUNTS or not TRAKT_ACCOUNTS[account].active: raise TraktAuthException('Account missing or disabled') return self._get_show_lists('users/hidden/recommendations?type=show', account=account) def get_watchlisted_for_account(self, account, result_count=100, sort='rank', **kwargs): # type: (...) -> List[TVInfoShow] """ get watchlisted shows for the account :param account: account to get recommendations for :param result_count: how many results are suppose to be returned :param sort: possible values: 'rank', 'added', 'released', 'title' """ from sickgear import TRAKT_ACCOUNTS if not account or account not in TRAKT_ACCOUNTS or not TRAKT_ACCOUNTS[account].active: raise TraktAuthException('Account missing or disabled') sort = ('rank', sort)[sort in ('rank', 'added', 'released', 'title')] return self._get_show_lists('users/%s/watchlist/shows/%s?extended=full&page=%d&limit=%d' % (TRAKT_ACCOUNTS[account].slug, sort, 1, result_count), account=account) def get_anticipated(self, result_count=100, **kwargs): # type: (...) -> List[TVInfoShow] """ get most anticipated shows :param result_count: how many results are suppose to be returned """ return self._get_show_lists('shows/anticipated?extended=full&page=%d&limit=%d' % (1, result_count)) def get_trending(self, result_count=100, **kwargs): # type: (...) -> List[TVInfoShow] """ get trending shows :param result_count: how many results are suppose to be returned """ return self._get_show_lists('shows/trending?extended=full&page=%d&limit=%d' % (1, result_count)) def get_popular(self, result_count=100, **kwargs): # type: (...) -> List[TVInfoShow] """ get all popular shows :param result_count: how many results are suppose to be returned """ return self._get_show_lists('shows/popular?extended=full&page=%d&limit=%d' % (1, result_count)) def get_similar(self, tvid, result_count=100, **kwargs): # type: (integer_types, int, Any) -> List[TVInfoShow] """ return list of similar shows to given id :param tvid: id to give similar shows for :param result_count: count of results requested """ if not isinstance(tvid, int): raise TraktException('tvid/trakt id for show required') return self._get_show_lists('shows/%d/related?extended=full&page=%d&limit=%d' % (tvid, 1, result_count)) def get_new_shows(self, result_count=100, start_date=None, days=32, **kwargs): # type: (...) -> List[TVInfoShow] """ get new shows :param result_count: how many results are suppose to be returned :param start_date: start date for returned data in format: '2014-09-01' :param days: number of days to return from start date """ if None is start_date: start_date = (datetime.datetime.now() + datetime.timedelta(days=-16)).strftime('%Y-%m-%d') return self._get_show_lists('calendars/all/shows/new/%s/%s?extended=full&page=%d&limit=%d' % (start_date, days, 1, result_count)) def get_new_seasons(self, result_count=100, start_date=None, days=32, **kwargs): # type: (...) -> List[TVInfoShow] """ get new seasons :param result_count: how many results are suppose to be returned :param start_date: start date for returned data in format: '2014-09-01' :param days: number of days to return from start date """ if None is start_date: start_date = (datetime.datetime.now() + datetime.timedelta(days=-16)).strftime('%Y-%m-%d') return self._get_show_lists('calendars/all/shows/premieres/%s/%s?extended=full&page=%d&limit=%d' % (start_date, days, 1, result_count))