]> Raphaƫl G. Git Repositories - youtubedl/blob - youtube_dl/extractor/pluralsight.py
New upstream version 2018.04.25
[youtubedl] / youtube_dl / extractor / pluralsight.py
1 from __future__ import unicode_literals
2
3 import collections
4 import json
5 import os
6 import random
7
8 from .common import InfoExtractor
9 from ..compat import (
10 compat_str,
11 compat_urlparse,
12 )
13 from ..utils import (
14 dict_get,
15 ExtractorError,
16 float_or_none,
17 int_or_none,
18 parse_duration,
19 qualities,
20 srt_subtitles_timecode,
21 try_get,
22 update_url_query,
23 urlencode_postdata,
24 )
25
26
27 class PluralsightBaseIE(InfoExtractor):
28 _API_BASE = 'https://app.pluralsight.com'
29
30 def _download_course(self, course_id, url, display_id):
31 try:
32 return self._download_course_rpc(course_id, url, display_id)
33 except ExtractorError:
34 # Old API fallback
35 return self._download_json(
36 'https://app.pluralsight.com/player/user/api/v1/player/payload',
37 display_id, data=urlencode_postdata({'courseId': course_id}),
38 headers={'Referer': url})
39
40 def _download_course_rpc(self, course_id, url, display_id):
41 response = self._download_json(
42 '%s/player/functions/rpc' % self._API_BASE, display_id,
43 'Downloading course JSON',
44 data=json.dumps({
45 'fn': 'bootstrapPlayer',
46 'payload': {
47 'courseId': course_id,
48 },
49 }).encode('utf-8'),
50 headers={
51 'Content-Type': 'application/json;charset=utf-8',
52 'Referer': url,
53 })
54
55 course = try_get(response, lambda x: x['payload']['course'], dict)
56 if course:
57 return course
58
59 raise ExtractorError(
60 '%s said: %s' % (self.IE_NAME, response['error']['message']),
61 expected=True)
62
63
64 class PluralsightIE(PluralsightBaseIE):
65 IE_NAME = 'pluralsight'
66 _VALID_URL = r'https?://(?:(?:www|app)\.)?pluralsight\.com/(?:training/)?player\?'
67 _LOGIN_URL = 'https://app.pluralsight.com/id/'
68
69 _NETRC_MACHINE = 'pluralsight'
70
71 _TESTS = [{
72 'url': 'http://www.pluralsight.com/training/player?author=mike-mckeown&name=hosting-sql-server-windows-azure-iaas-m7-mgmt&mode=live&clip=3&course=hosting-sql-server-windows-azure-iaas',
73 'md5': '4d458cf5cf4c593788672419a8dd4cf8',
74 'info_dict': {
75 'id': 'hosting-sql-server-windows-azure-iaas-m7-mgmt-04',
76 'ext': 'mp4',
77 'title': 'Demo Monitoring',
78 'duration': 338,
79 },
80 'skip': 'Requires pluralsight account credentials',
81 }, {
82 'url': 'https://app.pluralsight.com/training/player?course=angularjs-get-started&author=scott-allen&name=angularjs-get-started-m1-introduction&clip=0&mode=live',
83 'only_matching': True,
84 }, {
85 # available without pluralsight account
86 'url': 'http://app.pluralsight.com/training/player?author=scott-allen&name=angularjs-get-started-m1-introduction&mode=live&clip=0&course=angularjs-get-started',
87 'only_matching': True,
88 }, {
89 'url': 'https://app.pluralsight.com/player?course=ccna-intro-networking&author=ross-bagurdes&name=ccna-intro-networking-m06&clip=0',
90 'only_matching': True,
91 }]
92
93 def _real_initialize(self):
94 self._login()
95
96 def _login(self):
97 (username, password) = self._get_login_info()
98 if username is None:
99 return
100
101 login_page = self._download_webpage(
102 self._LOGIN_URL, None, 'Downloading login page')
103
104 login_form = self._hidden_inputs(login_page)
105
106 login_form.update({
107 'Username': username,
108 'Password': password,
109 })
110
111 post_url = self._search_regex(
112 r'<form[^>]+action=(["\'])(?P<url>.+?)\1', login_page,
113 'post url', default=self._LOGIN_URL, group='url')
114
115 if not post_url.startswith('http'):
116 post_url = compat_urlparse.urljoin(self._LOGIN_URL, post_url)
117
118 response = self._download_webpage(
119 post_url, None, 'Logging in',
120 data=urlencode_postdata(login_form),
121 headers={'Content-Type': 'application/x-www-form-urlencoded'})
122
123 error = self._search_regex(
124 r'<span[^>]+class="field-validation-error"[^>]*>([^<]+)</span>',
125 response, 'error message', default=None)
126 if error:
127 raise ExtractorError('Unable to login: %s' % error, expected=True)
128
129 if all(p not in response for p in ('__INITIAL_STATE__', '"currentUser"')):
130 BLOCKED = 'Your account has been blocked due to suspicious activity'
131 if BLOCKED in response:
132 raise ExtractorError(
133 'Unable to login: %s' % BLOCKED, expected=True)
134 MUST_AGREE = 'To continue using Pluralsight, you must agree to'
135 if any(p in response for p in (MUST_AGREE, '>Disagree<', '>Agree<')):
136 raise ExtractorError(
137 'Unable to login: %s some documents. Go to pluralsight.com, '
138 'log in and agree with what Pluralsight requires.'
139 % MUST_AGREE, expected=True)
140
141 raise ExtractorError('Unable to log in')
142
143 def _get_subtitles(self, author, clip_id, lang, name, duration, video_id):
144 captions_post = {
145 'a': author,
146 'cn': clip_id,
147 'lc': lang,
148 'm': name,
149 }
150 captions = self._download_json(
151 '%s/player/retrieve-captions' % self._API_BASE, video_id,
152 'Downloading captions JSON', 'Unable to download captions JSON',
153 fatal=False, data=json.dumps(captions_post).encode('utf-8'),
154 headers={'Content-Type': 'application/json;charset=utf-8'})
155 if captions:
156 return {
157 lang: [{
158 'ext': 'json',
159 'data': json.dumps(captions),
160 }, {
161 'ext': 'srt',
162 'data': self._convert_subtitles(duration, captions),
163 }]
164 }
165
166 @staticmethod
167 def _convert_subtitles(duration, subs):
168 srt = ''
169 TIME_OFFSET_KEYS = ('displayTimeOffset', 'DisplayTimeOffset')
170 TEXT_KEYS = ('text', 'Text')
171 for num, current in enumerate(subs):
172 current = subs[num]
173 start, text = (
174 float_or_none(dict_get(current, TIME_OFFSET_KEYS, skip_false_values=False)),
175 dict_get(current, TEXT_KEYS))
176 if start is None or text is None:
177 continue
178 end = duration if num == len(subs) - 1 else float_or_none(
179 dict_get(subs[num + 1], TIME_OFFSET_KEYS, skip_false_values=False))
180 if end is None:
181 continue
182 srt += os.linesep.join(
183 (
184 '%d' % num,
185 '%s --> %s' % (
186 srt_subtitles_timecode(start),
187 srt_subtitles_timecode(end)),
188 text,
189 os.linesep,
190 ))
191 return srt
192
193 def _real_extract(self, url):
194 qs = compat_urlparse.parse_qs(compat_urlparse.urlparse(url).query)
195
196 author = qs.get('author', [None])[0]
197 name = qs.get('name', [None])[0]
198 clip_id = qs.get('clip', [None])[0]
199 course_name = qs.get('course', [None])[0]
200
201 if any(not f for f in (author, name, clip_id, course_name,)):
202 raise ExtractorError('Invalid URL', expected=True)
203
204 display_id = '%s-%s' % (name, clip_id)
205
206 course = self._download_course(course_name, url, display_id)
207
208 collection = course['modules']
209
210 clip = None
211
212 for module_ in collection:
213 if name in (module_.get('moduleName'), module_.get('name')):
214 for clip_ in module_.get('clips', []):
215 clip_index = clip_.get('clipIndex')
216 if clip_index is None:
217 clip_index = clip_.get('index')
218 if clip_index is None:
219 continue
220 if compat_str(clip_index) == clip_id:
221 clip = clip_
222 break
223
224 if not clip:
225 raise ExtractorError('Unable to resolve clip')
226
227 title = clip['title']
228
229 QUALITIES = {
230 'low': {'width': 640, 'height': 480},
231 'medium': {'width': 848, 'height': 640},
232 'high': {'width': 1024, 'height': 768},
233 'high-widescreen': {'width': 1280, 'height': 720},
234 }
235
236 QUALITIES_PREFERENCE = ('low', 'medium', 'high', 'high-widescreen',)
237 quality_key = qualities(QUALITIES_PREFERENCE)
238
239 AllowedQuality = collections.namedtuple('AllowedQuality', ['ext', 'qualities'])
240
241 ALLOWED_QUALITIES = (
242 AllowedQuality('webm', ['high', ]),
243 AllowedQuality('mp4', ['low', 'medium', 'high', ]),
244 )
245
246 # Some courses also offer widescreen resolution for high quality (see
247 # https://github.com/rg3/youtube-dl/issues/7766)
248 widescreen = course.get('supportsWideScreenVideoFormats') is True
249 best_quality = 'high-widescreen' if widescreen else 'high'
250 if widescreen:
251 for allowed_quality in ALLOWED_QUALITIES:
252 allowed_quality.qualities.append(best_quality)
253
254 # In order to minimize the number of calls to ViewClip API and reduce
255 # the probability of being throttled or banned by Pluralsight we will request
256 # only single format until formats listing was explicitly requested.
257 if self._downloader.params.get('listformats', False):
258 allowed_qualities = ALLOWED_QUALITIES
259 else:
260 def guess_allowed_qualities():
261 req_format = self._downloader.params.get('format') or 'best'
262 req_format_split = req_format.split('-', 1)
263 if len(req_format_split) > 1:
264 req_ext, req_quality = req_format_split
265 req_quality = '-'.join(req_quality.split('-')[:2])
266 for allowed_quality in ALLOWED_QUALITIES:
267 if req_ext == allowed_quality.ext and req_quality in allowed_quality.qualities:
268 return (AllowedQuality(req_ext, (req_quality, )), )
269 req_ext = 'webm' if self._downloader.params.get('prefer_free_formats') else 'mp4'
270 return (AllowedQuality(req_ext, (best_quality, )), )
271 allowed_qualities = guess_allowed_qualities()
272
273 formats = []
274 for ext, qualities_ in allowed_qualities:
275 for quality in qualities_:
276 f = QUALITIES[quality].copy()
277 clip_post = {
278 'author': author,
279 'includeCaptions': False,
280 'clipIndex': int(clip_id),
281 'courseName': course_name,
282 'locale': 'en',
283 'moduleName': name,
284 'mediaType': ext,
285 'quality': '%dx%d' % (f['width'], f['height']),
286 }
287 format_id = '%s-%s' % (ext, quality)
288 viewclip = self._download_json(
289 '%s/video/clips/viewclip' % self._API_BASE, display_id,
290 'Downloading %s viewclip JSON' % format_id, fatal=False,
291 data=json.dumps(clip_post).encode('utf-8'),
292 headers={'Content-Type': 'application/json;charset=utf-8'})
293
294 # Pluralsight tracks multiple sequential calls to ViewClip API and start
295 # to return 429 HTTP errors after some time (see
296 # https://github.com/rg3/youtube-dl/pull/6989). Moreover it may even lead
297 # to account ban (see https://github.com/rg3/youtube-dl/issues/6842).
298 # To somewhat reduce the probability of these consequences
299 # we will sleep random amount of time before each call to ViewClip.
300 self._sleep(
301 random.randint(2, 5), display_id,
302 '%(video_id)s: Waiting for %(timeout)s seconds to avoid throttling')
303
304 if not viewclip:
305 continue
306
307 clip_urls = viewclip.get('urls')
308 if not isinstance(clip_urls, list):
309 continue
310
311 for clip_url_data in clip_urls:
312 clip_url = clip_url_data.get('url')
313 if not clip_url:
314 continue
315 cdn = clip_url_data.get('cdn')
316 clip_f = f.copy()
317 clip_f.update({
318 'url': clip_url,
319 'ext': ext,
320 'format_id': '%s-%s' % (format_id, cdn) if cdn else format_id,
321 'quality': quality_key(quality),
322 'source_preference': int_or_none(clip_url_data.get('rank')),
323 })
324 formats.append(clip_f)
325
326 self._sort_formats(formats)
327
328 duration = int_or_none(
329 clip.get('duration')) or parse_duration(clip.get('formattedDuration'))
330
331 # TODO: other languages?
332 subtitles = self.extract_subtitles(
333 author, clip_id, 'en', name, duration, display_id)
334
335 return {
336 'id': clip.get('clipName') or clip['name'],
337 'title': title,
338 'duration': duration,
339 'creator': author,
340 'formats': formats,
341 'subtitles': subtitles,
342 }
343
344
345 class PluralsightCourseIE(PluralsightBaseIE):
346 IE_NAME = 'pluralsight:course'
347 _VALID_URL = r'https?://(?:(?:www|app)\.)?pluralsight\.com/(?:library/)?courses/(?P<id>[^/]+)'
348 _TESTS = [{
349 # Free course from Pluralsight Starter Subscription for Microsoft TechNet
350 # https://offers.pluralsight.com/technet?loc=zTS3z&prod=zOTprodz&tech=zOttechz&prog=zOTprogz&type=zSOz&media=zOTmediaz&country=zUSz
351 'url': 'http://www.pluralsight.com/courses/hosting-sql-server-windows-azure-iaas',
352 'info_dict': {
353 'id': 'hosting-sql-server-windows-azure-iaas',
354 'title': 'Hosting SQL Server in Microsoft Azure IaaS Fundamentals',
355 'description': 'md5:61b37e60f21c4b2f91dc621a977d0986',
356 },
357 'playlist_count': 31,
358 }, {
359 # available without pluralsight account
360 'url': 'https://www.pluralsight.com/courses/angularjs-get-started',
361 'only_matching': True,
362 }, {
363 'url': 'https://app.pluralsight.com/library/courses/understanding-microsoft-azure-amazon-aws/table-of-contents',
364 'only_matching': True,
365 }]
366
367 def _real_extract(self, url):
368 course_id = self._match_id(url)
369
370 # TODO: PSM cookie
371
372 course = self._download_course(course_id, url, course_id)
373
374 title = course['title']
375 course_name = course['name']
376 course_data = course['modules']
377 description = course.get('description') or course.get('shortDescription')
378
379 entries = []
380 for num, module in enumerate(course_data, 1):
381 author = module.get('author')
382 module_name = module.get('name')
383 if not author or not module_name:
384 continue
385 for clip in module.get('clips', []):
386 clip_index = int_or_none(clip.get('index'))
387 if clip_index is None:
388 continue
389 clip_url = update_url_query(
390 '%s/player' % self._API_BASE, query={
391 'mode': 'live',
392 'course': course_name,
393 'author': author,
394 'name': module_name,
395 'clip': clip_index,
396 })
397 entries.append({
398 '_type': 'url_transparent',
399 'url': clip_url,
400 'ie_key': PluralsightIE.ie_key(),
401 'chapter': module.get('title'),
402 'chapter_number': num,
403 'chapter_id': module.get('moduleRef'),
404 })
405
406 return self.playlist_result(entries, course_id, title, description)