1 from __future__ import unicode_literals
2 from .common import InfoExtractor
4 from ..compat import compat_str
10 class SubtitlesInfoExtractor(InfoExtractor):
12 def _have_to_download_any_subtitles(self):
13 return any([self._downloader.params.get('writesubtitles', False),
14 self._downloader.params.get('writeautomaticsub')])
16 def _list_available_subtitles(self, video_id, webpage):
17 """ outputs the available subtitles for the video """
18 sub_lang_list = self._get_available_subtitles(video_id, webpage)
19 auto_captions_list = self._get_available_automatic_caption(video_id, webpage)
20 sub_lang = ",".join(list(sub_lang_list.keys()))
21 self.to_screen('%s: Available subtitles for video: %s' %
23 auto_lang = ",".join(auto_captions_list.keys())
24 self.to_screen('%s: Available automatic captions for video: %s' %
25 (video_id, auto_lang))
27 def extract_subtitles(self, video_id, webpage):
29 returns {sub_lang: sub} ,{} if subtitles not found or None if the
30 subtitles aren't requested.
32 if not self._have_to_download_any_subtitles:
34 available_subs_list = {}
35 if self._downloader.params.get('writeautomaticsub', False):
36 available_subs_list.update(self._get_available_automatic_caption(video_id, webpage))
37 if self._downloader.params.get('writesubtitles', False):
38 available_subs_list.update(self._get_available_subtitles(video_id, webpage))
40 if not available_subs_list: # error, it didn't get the available subtitles
42 if self._downloader.params.get('allsubtitles', False):
43 sub_lang_list = available_subs_list
45 if self._downloader.params.get('subtitleslangs', False):
46 requested_langs = self._downloader.params.get('subtitleslangs')
47 elif 'en' in available_subs_list:
48 requested_langs = ['en']
50 requested_langs = [list(available_subs_list.keys())[0]]
53 for sub_lang in requested_langs:
54 if sub_lang not in available_subs_list:
55 self._downloader.report_warning('no closed captions found in the specified language "%s"' % sub_lang)
57 sub_lang_list[sub_lang] = available_subs_list[sub_lang]
60 for sub_lang, url in sub_lang_list.items():
61 subtitle = self._request_subtitle_url(sub_lang, url)
63 subtitles[sub_lang] = subtitle
66 def _download_subtitle_url(self, sub_lang, url):
67 return self._download_webpage(url, None, note=False)
69 def _request_subtitle_url(self, sub_lang, url):
70 """ makes the http request for the subtitle """
72 sub = self._download_subtitle_url(sub_lang, url)
73 except ExtractorError as err:
74 self._downloader.report_warning('unable to download video subtitles for %s: %s' % (sub_lang, compat_str(err)))
77 self._downloader.report_warning('Did not fetch video subtitles')
81 def _get_available_subtitles(self, video_id, webpage):
83 returns {sub_lang: url} or {} if not available
84 Must be redefined by the subclasses
87 # By default, allow implementations to simply pass in the result
88 assert isinstance(webpage, dict), \
89 '_get_available_subtitles not implemented'
92 def _get_available_automatic_caption(self, video_id, webpage):
94 returns {sub_lang: url} or {} if not available
95 Must be redefined by the subclasses that support automatic captions,
96 otherwise it will return {}
98 self._downloader.report_warning('Automatic Captions not supported by this server')