test/test_utils.py

   1 #!/usr/bin/env python3
   2
   3 # Allow direct execution
   4 import os
   5 import re
   6 import sys
   7 import unittest
   8
   9 sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
  10
  11
  12 import contextlib
  13 import io
  14 import itertools
  15 import json
  16 import xml.etree.ElementTree
  17
  18 from yt_dlp.compat import (
  19     compat_etree_fromstring,
  20     compat_HTMLParseError,
  21     compat_os_name,
  22 )
  23 from yt_dlp.utils import (
  24     Config,
  25     DateRange,
  26     ExtractorError,
  27     InAdvancePagedList,
  28     LazyList,
  29     OnDemandPagedList,
  30     age_restricted,
  31     args_to_str,
  32     base_url,
  33     caesar,
  34     clean_html,
  35     clean_podcast_url,
  36     cli_bool_option,
  37     cli_option,
  38     cli_valueless_option,
  39     date_from_str,
  40     datetime_from_str,
  41     detect_exe_version,
  42     determine_ext,
  43     determine_file_encoding,
  44     dfxp2srt,
  45     dict_get,
  46     encode_base_n,
  47     encode_compat_str,
  48     encodeFilename,
  49     escape_rfc3986,
  50     escape_url,
  51     expand_path,
  52     extract_attributes,
  53     find_xpath_attr,
  54     fix_xml_ampersands,
  55     float_or_none,
  56     format_bytes,
  57     get_compatible_ext,
  58     get_element_by_attribute,
  59     get_element_by_class,
  60     get_element_html_by_attribute,
  61     get_element_html_by_class,
  62     get_element_text_and_html_by_tag,
  63     get_elements_by_attribute,
  64     get_elements_by_class,
  65     get_elements_html_by_attribute,
  66     get_elements_html_by_class,
  67     get_elements_text_and_html_by_attribute,
  68     int_or_none,
  69     intlist_to_bytes,
  70     iri_to_uri,
  71     is_html,
  72     js_to_json,
  73     limit_length,
  74     locked_file,
  75     lowercase_escape,
  76     match_str,
  77     merge_dicts,
  78     mimetype2ext,
  79     month_by_name,
  80     multipart_encode,
  81     ohdave_rsa_encrypt,
  82     orderedSet,
  83     parse_age_limit,
  84     parse_bitrate,
  85     parse_codecs,
  86     parse_count,
  87     parse_dfxp_time_expr,
  88     parse_duration,
  89     parse_filesize,
  90     parse_iso8601,
  91     parse_qs,
  92     parse_resolution,
  93     pkcs1pad,
  94     prepend_extension,
  95     read_batch_urls,
  96     remove_end,
  97     remove_quotes,
  98     remove_start,
  99     render_table,
 100     replace_extension,
 101     rot47,
 102     sanitize_filename,
 103     sanitize_path,
 104     sanitize_url,
 105     sanitized_Request,
 106     shell_quote,
 107     smuggle_url,
 108     str_or_none,
 109     str_to_int,
 110     strip_jsonp,
 111     strip_or_none,
 112     subtitles_filename,
 113     timeconvert,
 114     traverse_obj,
 115     unescapeHTML,
 116     unified_strdate,
 117     unified_timestamp,
 118     unsmuggle_url,
 119     update_url_query,
 120     uppercase_escape,
 121     url_basename,
 122     url_or_none,
 123     urlencode_postdata,
 124     urljoin,
 125     urshift,
 126     version_tuple,
 127     xpath_attr,
 128     xpath_element,
 129     xpath_text,
 130     xpath_with_ns,
 131 )
 132
 133
 134 class TestUtil(unittest.TestCase):
 135     def test_timeconvert(self):
 136         self.assertTrue(timeconvert('') is None)
 137         self.assertTrue(timeconvert('bougrg') is None)
 138
 139     def test_sanitize_filename(self):
 140         self.assertEqual(sanitize_filename(''), '')
 141         self.assertEqual(sanitize_filename('abc'), 'abc')
 142         self.assertEqual(sanitize_filename('abc_d-e'), 'abc_d-e')
 143
 144         self.assertEqual(sanitize_filename('123'), '123')
 145
 146         self.assertEqual('abc⧸de', sanitize_filename('abc/de'))
 147         self.assertFalse('/' in sanitize_filename('abc/de///'))
 148
 149         self.assertEqual('abc_de', sanitize_filename('abc/<>\\*|de', is_id=False))
 150         self.assertEqual('xxx', sanitize_filename('xxx/<>\\*|', is_id=False))
 151         self.assertEqual('yes no', sanitize_filename('yes? no', is_id=False))
 152         self.assertEqual('this - that', sanitize_filename('this: that', is_id=False))
 153
 154         self.assertEqual(sanitize_filename('AT&T'), 'AT&T')
 155         aumlaut = 'ä'
 156         self.assertEqual(sanitize_filename(aumlaut), aumlaut)
 157         tests = '\u043a\u0438\u0440\u0438\u043b\u043b\u0438\u0446\u0430'
 158         self.assertEqual(sanitize_filename(tests), tests)
 159
 160         self.assertEqual(
 161             sanitize_filename('New World record at 0:12:34'),
 162             'New World record at 0_12_34')
 163
 164         self.assertEqual(sanitize_filename('--gasdgf'), '--gasdgf')
 165         self.assertEqual(sanitize_filename('--gasdgf', is_id=True), '--gasdgf')
 166         self.assertEqual(sanitize_filename('--gasdgf', is_id=False), '_-gasdgf')
 167         self.assertEqual(sanitize_filename('.gasdgf'), '.gasdgf')
 168         self.assertEqual(sanitize_filename('.gasdgf', is_id=True), '.gasdgf')
 169         self.assertEqual(sanitize_filename('.gasdgf', is_id=False), 'gasdgf')
 170
 171         forbidden = '"\0\\/'
 172         for fc in forbidden:
 173             for fbc in forbidden:
 174                 self.assertTrue(fbc not in sanitize_filename(fc))
 175
 176     def test_sanitize_filename_restricted(self):
 177         self.assertEqual(sanitize_filename('abc', restricted=True), 'abc')
 178         self.assertEqual(sanitize_filename('abc_d-e', restricted=True), 'abc_d-e')
 179
 180         self.assertEqual(sanitize_filename('123', restricted=True), '123')
 181
 182         self.assertEqual('abc_de', sanitize_filename('abc/de', restricted=True))
 183         self.assertFalse('/' in sanitize_filename('abc/de///', restricted=True))
 184
 185         self.assertEqual('abc_de', sanitize_filename('abc/<>\\*|de', restricted=True))
 186         self.assertEqual('xxx', sanitize_filename('xxx/<>\\*|', restricted=True))
 187         self.assertEqual('yes_no', sanitize_filename('yes? no', restricted=True))
 188         self.assertEqual('this_-_that', sanitize_filename('this: that', restricted=True))
 189
 190         tests = 'aäb\u4e2d\u56fd\u7684c'
 191         self.assertEqual(sanitize_filename(tests, restricted=True), 'aab_c')
 192         self.assertTrue(sanitize_filename('\xf6', restricted=True) != '')  # No empty filename
 193
 194         forbidden = '"\0\\/&!: \'\t\n()[]{}$;`^,#'
 195         for fc in forbidden:
 196             for fbc in forbidden:
 197                 self.assertTrue(fbc not in sanitize_filename(fc, restricted=True))
 198
 199         # Handle a common case more neatly
 200         self.assertEqual(sanitize_filename('\u5927\u58f0\u5e26 - Song', restricted=True), 'Song')
 201         self.assertEqual(sanitize_filename('\u603b\u7edf: Speech', restricted=True), 'Speech')
 202         # .. but make sure the file name is never empty
 203         self.assertTrue(sanitize_filename('-', restricted=True) != '')
 204         self.assertTrue(sanitize_filename(':', restricted=True) != '')
 205
 206         self.assertEqual(sanitize_filename(
 207             'ÂÃÄÀÁÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖŐØŒÙÚÛÜŰÝÞßàáâãäåæçèéêëìíîïðñòóôõöőøœùúûüűýþÿ', restricted=True),
 208             'AAAAAAAECEEEEIIIIDNOOOOOOOOEUUUUUYTHssaaaaaaaeceeeeiiiionooooooooeuuuuuythy')
 209
 210     def test_sanitize_ids(self):
 211         self.assertEqual(sanitize_filename('_n_cd26wFpw', is_id=True), '_n_cd26wFpw')
 212         self.assertEqual(sanitize_filename('_BD_eEpuzXw', is_id=True), '_BD_eEpuzXw')
 213         self.assertEqual(sanitize_filename('N0Y__7-UOdI', is_id=True), 'N0Y__7-UOdI')
 214
 215     def test_sanitize_path(self):
 216         if sys.platform != 'win32':
 217             return
 218
 219         self.assertEqual(sanitize_path('abc'), 'abc')
 220         self.assertEqual(sanitize_path('abc/def'), 'abc\\def')
 221         self.assertEqual(sanitize_path('abc\\def'), 'abc\\def')
 222         self.assertEqual(sanitize_path('abc|def'), 'abc#def')
 223         self.assertEqual(sanitize_path('<>:"|?*'), '#######')
 224         self.assertEqual(sanitize_path('C:/abc/def'), 'C:\\abc\\def')
 225         self.assertEqual(sanitize_path('C?:/abc/def'), 'C##\\abc\\def')
 226
 227         self.assertEqual(sanitize_path('\\\\?\\UNC\\ComputerName\\abc'), '\\\\?\\UNC\\ComputerName\\abc')
 228         self.assertEqual(sanitize_path('\\\\?\\UNC/ComputerName/abc'), '\\\\?\\UNC\\ComputerName\\abc')
 229
 230         self.assertEqual(sanitize_path('\\\\?\\C:\\abc'), '\\\\?\\C:\\abc')
 231         self.assertEqual(sanitize_path('\\\\?\\C:/abc'), '\\\\?\\C:\\abc')
 232         self.assertEqual(sanitize_path('\\\\?\\C:\\ab?c\\de:f'), '\\\\?\\C:\\ab#c\\de#f')
 233         self.assertEqual(sanitize_path('\\\\?\\C:\\abc'), '\\\\?\\C:\\abc')
 234
 235         self.assertEqual(
 236             sanitize_path('youtube/%(uploader)s/%(autonumber)s-%(title)s-%(upload_date)s.%(ext)s'),
 237             'youtube\\%(uploader)s\\%(autonumber)s-%(title)s-%(upload_date)s.%(ext)s')
 238
 239         self.assertEqual(
 240             sanitize_path('youtube/TheWreckingYard ./00001-Not bad, Especially for Free! (1987 Yamaha 700)-20141116.mp4.part'),
 241             'youtube\\TheWreckingYard #\\00001-Not bad, Especially for Free! (1987 Yamaha 700)-20141116.mp4.part')
 242         self.assertEqual(sanitize_path('abc/def...'), 'abc\\def..#')
 243         self.assertEqual(sanitize_path('abc.../def'), 'abc..#\\def')
 244         self.assertEqual(sanitize_path('abc.../def...'), 'abc..#\\def..#')
 245
 246         self.assertEqual(sanitize_path('../abc'), '..\\abc')
 247         self.assertEqual(sanitize_path('../../abc'), '..\\..\\abc')
 248         self.assertEqual(sanitize_path('./abc'), 'abc')
 249         self.assertEqual(sanitize_path('./../abc'), '..\\abc')
 250
 251     def test_sanitize_url(self):
 252         self.assertEqual(sanitize_url('//foo.bar'), 'http://foo.bar')
 253         self.assertEqual(sanitize_url('httpss://foo.bar'), 'https://foo.bar')
 254         self.assertEqual(sanitize_url('rmtps://foo.bar'), 'rtmps://foo.bar')
 255         self.assertEqual(sanitize_url('https://foo.bar'), 'https://foo.bar')
 256         self.assertEqual(sanitize_url('foo bar'), 'foo bar')
 257
 258     def test_extract_basic_auth(self):
 259         auth_header = lambda url: sanitized_Request(url).get_header('Authorization')
 260         self.assertFalse(auth_header('http://foo.bar'))
 261         self.assertFalse(auth_header('http://:foo.bar'))
 262         self.assertEqual(auth_header('http://@foo.bar'), 'Basic Og==')
 263         self.assertEqual(auth_header('http://:pass@foo.bar'), 'Basic OnBhc3M=')
 264         self.assertEqual(auth_header('http://user:@foo.bar'), 'Basic dXNlcjo=')
 265         self.assertEqual(auth_header('http://user:pass@foo.bar'), 'Basic dXNlcjpwYXNz')
 266
 267     def test_expand_path(self):
 268         def env(var):
 269             return f'%{var}%' if sys.platform == 'win32' else f'${var}'
 270
 271         os.environ['yt_dlp_EXPATH_PATH'] = 'expanded'
 272         self.assertEqual(expand_path(env('yt_dlp_EXPATH_PATH')), 'expanded')
 273
 274         old_home = os.environ.get('HOME')
 275         test_str = R'C:\Documents and Settings\тест\Application Data'
 276         try:
 277             os.environ['HOME'] = test_str
 278             self.assertEqual(expand_path(env('HOME')), os.getenv('HOME'))
 279             self.assertEqual(expand_path('~'), os.getenv('HOME'))
 280             self.assertEqual(
 281                 expand_path('~/%s' % env('yt_dlp_EXPATH_PATH')),
 282                 '%s/expanded' % os.getenv('HOME'))
 283         finally:
 284             os.environ['HOME'] = old_home or ''
 285
 286     def test_prepend_extension(self):
 287         self.assertEqual(prepend_extension('abc.ext', 'temp'), 'abc.temp.ext')
 288         self.assertEqual(prepend_extension('abc.ext', 'temp', 'ext'), 'abc.temp.ext')
 289         self.assertEqual(prepend_extension('abc.unexpected_ext', 'temp', 'ext'), 'abc.unexpected_ext.temp')
 290         self.assertEqual(prepend_extension('abc', 'temp'), 'abc.temp')
 291         self.assertEqual(prepend_extension('.abc', 'temp'), '.abc.temp')
 292         self.assertEqual(prepend_extension('.abc.ext', 'temp'), '.abc.temp.ext')
 293
 294     def test_replace_extension(self):
 295         self.assertEqual(replace_extension('abc.ext', 'temp'), 'abc.temp')
 296         self.assertEqual(replace_extension('abc.ext', 'temp', 'ext'), 'abc.temp')
 297         self.assertEqual(replace_extension('abc.unexpected_ext', 'temp', 'ext'), 'abc.unexpected_ext.temp')
 298         self.assertEqual(replace_extension('abc', 'temp'), 'abc.temp')
 299         self.assertEqual(replace_extension('.abc', 'temp'), '.abc.temp')
 300         self.assertEqual(replace_extension('.abc.ext', 'temp'), '.abc.temp')
 301
 302     def test_subtitles_filename(self):
 303         self.assertEqual(subtitles_filename('abc.ext', 'en', 'vtt'), 'abc.en.vtt')
 304         self.assertEqual(subtitles_filename('abc.ext', 'en', 'vtt', 'ext'), 'abc.en.vtt')
 305         self.assertEqual(subtitles_filename('abc.unexpected_ext', 'en', 'vtt', 'ext'), 'abc.unexpected_ext.en.vtt')
 306
 307     def test_remove_start(self):
 308         self.assertEqual(remove_start(None, 'A - '), None)
 309         self.assertEqual(remove_start('A - B', 'A - '), 'B')
 310         self.assertEqual(remove_start('B - A', 'A - '), 'B - A')
 311
 312     def test_remove_end(self):
 313         self.assertEqual(remove_end(None, ' - B'), None)
 314         self.assertEqual(remove_end('A - B', ' - B'), 'A')
 315         self.assertEqual(remove_end('B - A', ' - B'), 'B - A')
 316
 317     def test_remove_quotes(self):
 318         self.assertEqual(remove_quotes(None), None)
 319         self.assertEqual(remove_quotes('"'), '"')
 320         self.assertEqual(remove_quotes("'"), "'")
 321         self.assertEqual(remove_quotes(';'), ';')
 322         self.assertEqual(remove_quotes('";'), '";')
 323         self.assertEqual(remove_quotes('""'), '')
 324         self.assertEqual(remove_quotes('";"'), ';')
 325
 326     def test_ordered_set(self):
 327         self.assertEqual(orderedSet([1, 1, 2, 3, 4, 4, 5, 6, 7, 3, 5]), [1, 2, 3, 4, 5, 6, 7])
 328         self.assertEqual(orderedSet([]), [])
 329         self.assertEqual(orderedSet([1]), [1])
 330         # keep the list ordered
 331         self.assertEqual(orderedSet([135, 1, 1, 1]), [135, 1])
 332
 333     def test_unescape_html(self):
 334         self.assertEqual(unescapeHTML('%20;'), '%20;')
 335         self.assertEqual(unescapeHTML('&#x2F;'), '/')
 336         self.assertEqual(unescapeHTML('&#47;'), '/')
 337         self.assertEqual(unescapeHTML('&eacute;'), 'é')
 338         self.assertEqual(unescapeHTML('&#2013266066;'), '&#2013266066;')
 339         self.assertEqual(unescapeHTML('&a&quot;'), '&a"')
 340         # HTML5 entities
 341         self.assertEqual(unescapeHTML('&period;&apos;'), '.\'')
 342
 343     def test_date_from_str(self):
 344         self.assertEqual(date_from_str('yesterday'), date_from_str('now-1day'))
 345         self.assertEqual(date_from_str('now+7day'), date_from_str('now+1week'))
 346         self.assertEqual(date_from_str('now+14day'), date_from_str('now+2week'))
 347         self.assertEqual(date_from_str('20200229+365day'), date_from_str('20200229+1year'))
 348         self.assertEqual(date_from_str('20210131+28day'), date_from_str('20210131+1month'))
 349
 350     def test_datetime_from_str(self):
 351         self.assertEqual(datetime_from_str('yesterday', precision='day'), datetime_from_str('now-1day', precision='auto'))
 352         self.assertEqual(datetime_from_str('now+7day', precision='day'), datetime_from_str('now+1week', precision='auto'))
 353         self.assertEqual(datetime_from_str('now+14day', precision='day'), datetime_from_str('now+2week', precision='auto'))
 354         self.assertEqual(datetime_from_str('20200229+365day', precision='day'), datetime_from_str('20200229+1year', precision='auto'))
 355         self.assertEqual(datetime_from_str('20210131+28day', precision='day'), datetime_from_str('20210131+1month', precision='auto'))
 356         self.assertEqual(datetime_from_str('20210131+59day', precision='day'), datetime_from_str('20210131+2month', precision='auto'))
 357         self.assertEqual(datetime_from_str('now+1day', precision='hour'), datetime_from_str('now+24hours', precision='auto'))
 358         self.assertEqual(datetime_from_str('now+23hours', precision='hour'), datetime_from_str('now+23hours', precision='auto'))
 359
 360     def test_daterange(self):
 361         _20century = DateRange("19000101", "20000101")
 362         self.assertFalse("17890714" in _20century)
 363         _ac = DateRange("00010101")
 364         self.assertTrue("19690721" in _ac)
 365         _firstmilenium = DateRange(end="10000101")
 366         self.assertTrue("07110427" in _firstmilenium)
 367
 368     def test_unified_dates(self):
 369         self.assertEqual(unified_strdate('December 21, 2010'), '20101221')
 370         self.assertEqual(unified_strdate('8/7/2009'), '20090708')
 371         self.assertEqual(unified_strdate('Dec 14, 2012'), '20121214')
 372         self.assertEqual(unified_strdate('2012/10/11 01:56:38 +0000'), '20121011')
 373         self.assertEqual(unified_strdate('1968 12 10'), '19681210')
 374         self.assertEqual(unified_strdate('1968-12-10'), '19681210')
 375         self.assertEqual(unified_strdate('31-07-2022 20:00'), '20220731')
 376         self.assertEqual(unified_strdate('28/01/2014 21:00:00 +0100'), '20140128')
 377         self.assertEqual(
 378             unified_strdate('11/26/2014 11:30:00 AM PST', day_first=False),
 379             '20141126')
 380         self.assertEqual(
 381             unified_strdate('2/2/2015 6:47:40 PM', day_first=False),
 382             '20150202')
 383         self.assertEqual(unified_strdate('Feb 14th 2016 5:45PM'), '20160214')
 384         self.assertEqual(unified_strdate('25-09-2014'), '20140925')
 385         self.assertEqual(unified_strdate('27.02.2016 17:30'), '20160227')
 386         self.assertEqual(unified_strdate('UNKNOWN DATE FORMAT'), None)
 387         self.assertEqual(unified_strdate('Feb 7, 2016 at 6:35 pm'), '20160207')
 388         self.assertEqual(unified_strdate('July 15th, 2013'), '20130715')
 389         self.assertEqual(unified_strdate('September 1st, 2013'), '20130901')
 390         self.assertEqual(unified_strdate('Sep 2nd, 2013'), '20130902')
 391         self.assertEqual(unified_strdate('November 3rd, 2019'), '20191103')
 392         self.assertEqual(unified_strdate('October 23rd, 2005'), '20051023')
 393
 394     def test_unified_timestamps(self):
 395         self.assertEqual(unified_timestamp('December 21, 2010'), 1292889600)
 396         self.assertEqual(unified_timestamp('8/7/2009'), 1247011200)
 397         self.assertEqual(unified_timestamp('Dec 14, 2012'), 1355443200)
 398         self.assertEqual(unified_timestamp('2012/10/11 01:56:38 +0000'), 1349920598)
 399         self.assertEqual(unified_timestamp('1968 12 10'), -33436800)
 400         self.assertEqual(unified_timestamp('1968-12-10'), -33436800)
 401         self.assertEqual(unified_timestamp('28/01/2014 21:00:00 +0100'), 1390939200)
 402         self.assertEqual(
 403             unified_timestamp('11/26/2014 11:30:00 AM PST', day_first=False),
 404             1417001400)
 405         self.assertEqual(
 406             unified_timestamp('2/2/2015 6:47:40 PM', day_first=False),
 407             1422902860)
 408         self.assertEqual(unified_timestamp('Feb 14th 2016 5:45PM'), 1455471900)
 409         self.assertEqual(unified_timestamp('25-09-2014'), 1411603200)
 410         self.assertEqual(unified_timestamp('27.02.2016 17:30'), 1456594200)
 411         self.assertEqual(unified_timestamp('UNKNOWN DATE FORMAT'), None)
 412         self.assertEqual(unified_timestamp('May 16, 2016 11:15 PM'), 1463440500)
 413         self.assertEqual(unified_timestamp('Feb 7, 2016 at 6:35 pm'), 1454870100)
 414         self.assertEqual(unified_timestamp('2017-03-30T17:52:41Q'), 1490896361)
 415         self.assertEqual(unified_timestamp('Sep 11, 2013 | 5:49 AM'), 1378878540)
 416         self.assertEqual(unified_timestamp('December 15, 2017 at 7:49 am'), 1513324140)
 417         self.assertEqual(unified_timestamp('2018-03-14T08:32:43.1493874+00:00'), 1521016363)
 418
 419         self.assertEqual(unified_timestamp('December 31 1969 20:00:01 EDT'), 1)
 420         self.assertEqual(unified_timestamp('Wednesday 31 December 1969 18:01:26 MDT'), 86)
 421         self.assertEqual(unified_timestamp('12/31/1969 20:01:18 EDT', False), 78)
 422
 423     def test_determine_ext(self):
 424         self.assertEqual(determine_ext('http://example.com/foo/bar.mp4/?download'), 'mp4')
 425         self.assertEqual(determine_ext('http://example.com/foo/bar/?download', None), None)
 426         self.assertEqual(determine_ext('http://example.com/foo/bar.nonext/?download', None), None)
 427         self.assertEqual(determine_ext('http://example.com/foo/bar/mp4?download', None), None)
 428         self.assertEqual(determine_ext('http://example.com/foo/bar.m3u8//?download'), 'm3u8')
 429         self.assertEqual(determine_ext('foobar', None), None)
 430
 431     def test_find_xpath_attr(self):
 432         testxml = '''<root>
 433             <node/>
 434             <node x="a"/>
 435             <node x="a" y="c" />
 436             <node x="b" y="d" />
 437             <node x="" />
 438         </root>'''
 439         doc = compat_etree_fromstring(testxml)
 440
 441         self.assertEqual(find_xpath_attr(doc, './/fourohfour', 'n'), None)
 442         self.assertEqual(find_xpath_attr(doc, './/fourohfour', 'n', 'v'), None)
 443         self.assertEqual(find_xpath_attr(doc, './/node', 'n'), None)
 444         self.assertEqual(find_xpath_attr(doc, './/node', 'n', 'v'), None)
 445         self.assertEqual(find_xpath_attr(doc, './/node', 'x'), doc[1])
 446         self.assertEqual(find_xpath_attr(doc, './/node', 'x', 'a'), doc[1])
 447         self.assertEqual(find_xpath_attr(doc, './/node', 'x', 'b'), doc[3])
 448         self.assertEqual(find_xpath_attr(doc, './/node', 'y'), doc[2])
 449         self.assertEqual(find_xpath_attr(doc, './/node', 'y', 'c'), doc[2])
 450         self.assertEqual(find_xpath_attr(doc, './/node', 'y', 'd'), doc[3])
 451         self.assertEqual(find_xpath_attr(doc, './/node', 'x', ''), doc[4])
 452
 453     def test_xpath_with_ns(self):
 454         testxml = '''<root xmlns:media="http://example.com/">
 455             <media:song>
 456                 <media:author>The Author</media:author>
 457                 <url>http://server.com/download.mp3</url>
 458             </media:song>
 459         </root>'''
 460         doc = compat_etree_fromstring(testxml)
 461         find = lambda p: doc.find(xpath_with_ns(p, {'media': 'http://example.com/'}))
 462         self.assertTrue(find('media:song') is not None)
 463         self.assertEqual(find('media:song/media:author').text, 'The Author')
 464         self.assertEqual(find('media:song/url').text, 'http://server.com/download.mp3')
 465
 466     def test_xpath_element(self):
 467         doc = xml.etree.ElementTree.Element('root')
 468         div = xml.etree.ElementTree.SubElement(doc, 'div')
 469         p = xml.etree.ElementTree.SubElement(div, 'p')
 470         p.text = 'Foo'
 471         self.assertEqual(xpath_element(doc, 'div/p'), p)
 472         self.assertEqual(xpath_element(doc, ['div/p']), p)
 473         self.assertEqual(xpath_element(doc, ['div/bar', 'div/p']), p)
 474         self.assertEqual(xpath_element(doc, 'div/bar', default='default'), 'default')
 475         self.assertEqual(xpath_element(doc, ['div/bar'], default='default'), 'default')
 476         self.assertTrue(xpath_element(doc, 'div/bar') is None)
 477         self.assertTrue(xpath_element(doc, ['div/bar']) is None)
 478         self.assertTrue(xpath_element(doc, ['div/bar'], 'div/baz') is None)
 479         self.assertRaises(ExtractorError, xpath_element, doc, 'div/bar', fatal=True)
 480         self.assertRaises(ExtractorError, xpath_element, doc, ['div/bar'], fatal=True)
 481         self.assertRaises(ExtractorError, xpath_element, doc, ['div/bar', 'div/baz'], fatal=True)
 482
 483     def test_xpath_text(self):
 484         testxml = '''<root>
 485             <div>
 486                 <p>Foo</p>
 487             </div>
 488         </root>'''
 489         doc = compat_etree_fromstring(testxml)
 490         self.assertEqual(xpath_text(doc, 'div/p'), 'Foo')
 491         self.assertEqual(xpath_text(doc, 'div/bar', default='default'), 'default')
 492         self.assertTrue(xpath_text(doc, 'div/bar') is None)
 493         self.assertRaises(ExtractorError, xpath_text, doc, 'div/bar', fatal=True)
 494
 495     def test_xpath_attr(self):
 496         testxml = '''<root>
 497             <div>
 498                 <p x="a">Foo</p>
 499             </div>
 500         </root>'''
 501         doc = compat_etree_fromstring(testxml)
 502         self.assertEqual(xpath_attr(doc, 'div/p', 'x'), 'a')
 503         self.assertEqual(xpath_attr(doc, 'div/bar', 'x'), None)
 504         self.assertEqual(xpath_attr(doc, 'div/p', 'y'), None)
 505         self.assertEqual(xpath_attr(doc, 'div/bar', 'x', default='default'), 'default')
 506         self.assertEqual(xpath_attr(doc, 'div/p', 'y', default='default'), 'default')
 507         self.assertRaises(ExtractorError, xpath_attr, doc, 'div/bar', 'x', fatal=True)
 508         self.assertRaises(ExtractorError, xpath_attr, doc, 'div/p', 'y', fatal=True)
 509
 510     def test_smuggle_url(self):
 511         data = {"ö": "ö", "abc": [3]}
 512         url = 'https://foo.bar/baz?x=y#a'
 513         smug_url = smuggle_url(url, data)
 514         unsmug_url, unsmug_data = unsmuggle_url(smug_url)
 515         self.assertEqual(url, unsmug_url)
 516         self.assertEqual(data, unsmug_data)
 517
 518         res_url, res_data = unsmuggle_url(url)
 519         self.assertEqual(res_url, url)
 520         self.assertEqual(res_data, None)
 521
 522         smug_url = smuggle_url(url, {'a': 'b'})
 523         smug_smug_url = smuggle_url(smug_url, {'c': 'd'})
 524         res_url, res_data = unsmuggle_url(smug_smug_url)
 525         self.assertEqual(res_url, url)
 526         self.assertEqual(res_data, {'a': 'b', 'c': 'd'})
 527
 528     def test_shell_quote(self):
 529         args = ['ffmpeg', '-i', encodeFilename('ñ€ß\'.mp4')]
 530         self.assertEqual(
 531             shell_quote(args),
 532             """ffmpeg -i 'ñ€ß'"'"'.mp4'""" if compat_os_name != 'nt' else '''ffmpeg -i "ñ€ß'.mp4"''')
 533
 534     def test_float_or_none(self):
 535         self.assertEqual(float_or_none('42.42'), 42.42)
 536         self.assertEqual(float_or_none('42'), 42.0)
 537         self.assertEqual(float_or_none(''), None)
 538         self.assertEqual(float_or_none(None), None)
 539         self.assertEqual(float_or_none([]), None)
 540         self.assertEqual(float_or_none(set()), None)
 541
 542     def test_int_or_none(self):
 543         self.assertEqual(int_or_none('42'), 42)
 544         self.assertEqual(int_or_none(''), None)
 545         self.assertEqual(int_or_none(None), None)
 546         self.assertEqual(int_or_none([]), None)
 547         self.assertEqual(int_or_none(set()), None)
 548
 549     def test_str_to_int(self):
 550         self.assertEqual(str_to_int('123,456'), 123456)
 551         self.assertEqual(str_to_int('123.456'), 123456)
 552         self.assertEqual(str_to_int(523), 523)
 553         self.assertEqual(str_to_int('noninteger'), None)
 554         self.assertEqual(str_to_int([]), None)
 555
 556     def test_url_basename(self):
 557         self.assertEqual(url_basename('http://foo.de/'), '')
 558         self.assertEqual(url_basename('http://foo.de/bar/baz'), 'baz')
 559         self.assertEqual(url_basename('http://foo.de/bar/baz?x=y'), 'baz')
 560         self.assertEqual(url_basename('http://foo.de/bar/baz#x=y'), 'baz')
 561         self.assertEqual(url_basename('http://foo.de/bar/baz/'), 'baz')
 562         self.assertEqual(
 563             url_basename('http://media.w3.org/2010/05/sintel/trailer.mp4'),
 564             'trailer.mp4')
 565
 566     def test_base_url(self):
 567         self.assertEqual(base_url('http://foo.de/'), 'http://foo.de/')
 568         self.assertEqual(base_url('http://foo.de/bar'), 'http://foo.de/')
 569         self.assertEqual(base_url('http://foo.de/bar/'), 'http://foo.de/bar/')
 570         self.assertEqual(base_url('http://foo.de/bar/baz'), 'http://foo.de/bar/')
 571         self.assertEqual(base_url('http://foo.de/bar/baz?x=z/x/c'), 'http://foo.de/bar/')
 572         self.assertEqual(base_url('http://foo.de/bar/baz&x=z&w=y/x/c'), 'http://foo.de/bar/baz&x=z&w=y/x/')
 573
 574     def test_urljoin(self):
 575         self.assertEqual(urljoin('http://foo.de/', '/a/b/c.txt'), 'http://foo.de/a/b/c.txt')
 576         self.assertEqual(urljoin(b'http://foo.de/', '/a/b/c.txt'), 'http://foo.de/a/b/c.txt')
 577         self.assertEqual(urljoin('http://foo.de/', b'/a/b/c.txt'), 'http://foo.de/a/b/c.txt')
 578         self.assertEqual(urljoin(b'http://foo.de/', b'/a/b/c.txt'), 'http://foo.de/a/b/c.txt')
 579         self.assertEqual(urljoin('//foo.de/', '/a/b/c.txt'), '//foo.de/a/b/c.txt')
 580         self.assertEqual(urljoin('http://foo.de/', 'a/b/c.txt'), 'http://foo.de/a/b/c.txt')
 581         self.assertEqual(urljoin('http://foo.de', '/a/b/c.txt'), 'http://foo.de/a/b/c.txt')
 582         self.assertEqual(urljoin('http://foo.de', 'a/b/c.txt'), 'http://foo.de/a/b/c.txt')
 583         self.assertEqual(urljoin('http://foo.de/', 'http://foo.de/a/b/c.txt'), 'http://foo.de/a/b/c.txt')
 584         self.assertEqual(urljoin('http://foo.de/', '//foo.de/a/b/c.txt'), '//foo.de/a/b/c.txt')
 585         self.assertEqual(urljoin(None, 'http://foo.de/a/b/c.txt'), 'http://foo.de/a/b/c.txt')
 586         self.assertEqual(urljoin(None, '//foo.de/a/b/c.txt'), '//foo.de/a/b/c.txt')
 587         self.assertEqual(urljoin('', 'http://foo.de/a/b/c.txt'), 'http://foo.de/a/b/c.txt')
 588         self.assertEqual(urljoin(['foobar'], 'http://foo.de/a/b/c.txt'), 'http://foo.de/a/b/c.txt')
 589         self.assertEqual(urljoin('http://foo.de/', None), None)
 590         self.assertEqual(urljoin('http://foo.de/', ''), None)
 591         self.assertEqual(urljoin('http://foo.de/', ['foobar']), None)
 592         self.assertEqual(urljoin('http://foo.de/a/b/c.txt', '.././../d.txt'), 'http://foo.de/d.txt')
 593         self.assertEqual(urljoin('http://foo.de/a/b/c.txt', 'rtmp://foo.de'), 'rtmp://foo.de')
 594         self.assertEqual(urljoin(None, 'rtmp://foo.de'), 'rtmp://foo.de')
 595
 596     def test_url_or_none(self):
 597         self.assertEqual(url_or_none(None), None)
 598         self.assertEqual(url_or_none(''), None)
 599         self.assertEqual(url_or_none('foo'), None)
 600         self.assertEqual(url_or_none('http://foo.de'), 'http://foo.de')
 601         self.assertEqual(url_or_none('https://foo.de'), 'https://foo.de')
 602         self.assertEqual(url_or_none('http$://foo.de'), None)
 603         self.assertEqual(url_or_none('http://foo.de'), 'http://foo.de')
 604         self.assertEqual(url_or_none('//foo.de'), '//foo.de')
 605         self.assertEqual(url_or_none('s3://foo.de'), None)
 606         self.assertEqual(url_or_none('rtmpte://foo.de'), 'rtmpte://foo.de')
 607         self.assertEqual(url_or_none('mms://foo.de'), 'mms://foo.de')
 608         self.assertEqual(url_or_none('rtspu://foo.de'), 'rtspu://foo.de')
 609         self.assertEqual(url_or_none('ftps://foo.de'), 'ftps://foo.de')
 610
 611     def test_parse_age_limit(self):
 612         self.assertEqual(parse_age_limit(None), None)
 613         self.assertEqual(parse_age_limit(False), None)
 614         self.assertEqual(parse_age_limit('invalid'), None)
 615         self.assertEqual(parse_age_limit(0), 0)
 616         self.assertEqual(parse_age_limit(18), 18)
 617         self.assertEqual(parse_age_limit(21), 21)
 618         self.assertEqual(parse_age_limit(22), None)
 619         self.assertEqual(parse_age_limit('18'), 18)
 620         self.assertEqual(parse_age_limit('18+'), 18)
 621         self.assertEqual(parse_age_limit('PG-13'), 13)
 622         self.assertEqual(parse_age_limit('TV-14'), 14)
 623         self.assertEqual(parse_age_limit('TV-MA'), 17)
 624         self.assertEqual(parse_age_limit('TV14'), 14)
 625         self.assertEqual(parse_age_limit('TV_G'), 0)
 626
 627     def test_parse_duration(self):
 628         self.assertEqual(parse_duration(None), None)
 629         self.assertEqual(parse_duration(False), None)
 630         self.assertEqual(parse_duration('invalid'), None)
 631         self.assertEqual(parse_duration('1'), 1)
 632         self.assertEqual(parse_duration('1337:12'), 80232)
 633         self.assertEqual(parse_duration('9:12:43'), 33163)
 634         self.assertEqual(parse_duration('12:00'), 720)
 635         self.assertEqual(parse_duration('00:01:01'), 61)
 636         self.assertEqual(parse_duration('x:y'), None)
 637         self.assertEqual(parse_duration('3h11m53s'), 11513)
 638         self.assertEqual(parse_duration('3h 11m 53s'), 11513)
 639         self.assertEqual(parse_duration('3 hours 11 minutes 53 seconds'), 11513)
 640         self.assertEqual(parse_duration('3 hours 11 mins 53 secs'), 11513)
 641         self.assertEqual(parse_duration('3 hours, 11 minutes, 53 seconds'), 11513)
 642         self.assertEqual(parse_duration('3 hours, 11 mins, 53 secs'), 11513)
 643         self.assertEqual(parse_duration('62m45s'), 3765)
 644         self.assertEqual(parse_duration('6m59s'), 419)
 645         self.assertEqual(parse_duration('49s'), 49)
 646         self.assertEqual(parse_duration('0h0m0s'), 0)
 647         self.assertEqual(parse_duration('0m0s'), 0)
 648         self.assertEqual(parse_duration('0s'), 0)
 649         self.assertEqual(parse_duration('01:02:03.05'), 3723.05)
 650         self.assertEqual(parse_duration('T30M38S'), 1838)
 651         self.assertEqual(parse_duration('5 s'), 5)
 652         self.assertEqual(parse_duration('3 min'), 180)
 653         self.assertEqual(parse_duration('2.5 hours'), 9000)
 654         self.assertEqual(parse_duration('02:03:04'), 7384)
 655         self.assertEqual(parse_duration('01:02:03:04'), 93784)
 656         self.assertEqual(parse_duration('1 hour 3 minutes'), 3780)
 657         self.assertEqual(parse_duration('87 Min.'), 5220)
 658         self.assertEqual(parse_duration('PT1H0.040S'), 3600.04)
 659         self.assertEqual(parse_duration('PT00H03M30SZ'), 210)
 660         self.assertEqual(parse_duration('P0Y0M0DT0H4M20.880S'), 260.88)
 661         self.assertEqual(parse_duration('01:02:03:050'), 3723.05)
 662         self.assertEqual(parse_duration('103:050'), 103.05)
 663
 664     def test_fix_xml_ampersands(self):
 665         self.assertEqual(
 666             fix_xml_ampersands('"&x=y&z=a'), '"&amp;x=y&amp;z=a')
 667         self.assertEqual(
 668             fix_xml_ampersands('"&amp;x=y&wrong;&z=a'),
 669             '"&amp;x=y&amp;wrong;&amp;z=a')
 670         self.assertEqual(
 671             fix_xml_ampersands('&amp;&apos;&gt;&lt;&quot;'),
 672             '&amp;&apos;&gt;&lt;&quot;')
 673         self.assertEqual(
 674             fix_xml_ampersands('&#1234;&#x1abC;'), '&#1234;&#x1abC;')
 675         self.assertEqual(fix_xml_ampersands('&#&#'), '&amp;#&amp;#')
 676
 677     def test_paged_list(self):
 678         def testPL(size, pagesize, sliceargs, expected):
 679             def get_page(pagenum):
 680                 firstid = pagenum * pagesize
 681                 upto = min(size, pagenum * pagesize + pagesize)
 682                 yield from range(firstid, upto)
 683
 684             pl = OnDemandPagedList(get_page, pagesize)
 685             got = pl.getslice(*sliceargs)
 686             self.assertEqual(got, expected)
 687
 688             iapl = InAdvancePagedList(get_page, size // pagesize + 1, pagesize)
 689             got = iapl.getslice(*sliceargs)
 690             self.assertEqual(got, expected)
 691
 692         testPL(5, 2, (), [0, 1, 2, 3, 4])
 693         testPL(5, 2, (1,), [1, 2, 3, 4])
 694         testPL(5, 2, (2,), [2, 3, 4])
 695         testPL(5, 2, (4,), [4])
 696         testPL(5, 2, (0, 3), [0, 1, 2])
 697         testPL(5, 2, (1, 4), [1, 2, 3])
 698         testPL(5, 2, (2, 99), [2, 3, 4])
 699         testPL(5, 2, (20, 99), [])
 700
 701     def test_read_batch_urls(self):
 702         f = io.StringIO('''\xef\xbb\xbf foo
 703             bar\r
 704             baz
 705             # More after this line\r
 706             ; or after this
 707             bam''')
 708         self.assertEqual(read_batch_urls(f), ['foo', 'bar', 'baz', 'bam'])
 709
 710     def test_urlencode_postdata(self):
 711         data = urlencode_postdata({'username': 'foo@bar.com', 'password': '1234'})
 712         self.assertTrue(isinstance(data, bytes))
 713
 714     def test_update_url_query(self):
 715         self.assertEqual(parse_qs(update_url_query(
 716             'http://example.com/path', {'quality': ['HD'], 'format': ['mp4']})),
 717             parse_qs('http://example.com/path?quality=HD&format=mp4'))
 718         self.assertEqual(parse_qs(update_url_query(
 719             'http://example.com/path', {'system': ['LINUX', 'WINDOWS']})),
 720             parse_qs('http://example.com/path?system=LINUX&system=WINDOWS'))
 721         self.assertEqual(parse_qs(update_url_query(
 722             'http://example.com/path', {'fields': 'id,formats,subtitles'})),
 723             parse_qs('http://example.com/path?fields=id,formats,subtitles'))
 724         self.assertEqual(parse_qs(update_url_query(
 725             'http://example.com/path', {'fields': ('id,formats,subtitles', 'thumbnails')})),
 726             parse_qs('http://example.com/path?fields=id,formats,subtitles&fields=thumbnails'))
 727         self.assertEqual(parse_qs(update_url_query(
 728             'http://example.com/path?manifest=f4m', {'manifest': []})),
 729             parse_qs('http://example.com/path'))
 730         self.assertEqual(parse_qs(update_url_query(
 731             'http://example.com/path?system=LINUX&system=WINDOWS', {'system': 'LINUX'})),
 732             parse_qs('http://example.com/path?system=LINUX'))
 733         self.assertEqual(parse_qs(update_url_query(
 734             'http://example.com/path', {'fields': b'id,formats,subtitles'})),
 735             parse_qs('http://example.com/path?fields=id,formats,subtitles'))
 736         self.assertEqual(parse_qs(update_url_query(
 737             'http://example.com/path', {'width': 1080, 'height': 720})),
 738             parse_qs('http://example.com/path?width=1080&height=720'))
 739         self.assertEqual(parse_qs(update_url_query(
 740             'http://example.com/path', {'bitrate': 5020.43})),
 741             parse_qs('http://example.com/path?bitrate=5020.43'))
 742         self.assertEqual(parse_qs(update_url_query(
 743             'http://example.com/path', {'test': '第二行тест'})),
 744             parse_qs('http://example.com/path?test=%E7%AC%AC%E4%BA%8C%E8%A1%8C%D1%82%D0%B5%D1%81%D1%82'))
 745
 746     def test_multipart_encode(self):
 747         self.assertEqual(
 748             multipart_encode({b'field': b'value'}, boundary='AAAAAA')[0],
 749             b'--AAAAAA\r\nContent-Disposition: form-data; name="field"\r\n\r\nvalue\r\n--AAAAAA--\r\n')
 750         self.assertEqual(
 751             multipart_encode({'欄位'.encode(): '值'.encode()}, boundary='AAAAAA')[0],
 752             b'--AAAAAA\r\nContent-Disposition: form-data; name="\xe6\xac\x84\xe4\xbd\x8d"\r\n\r\n\xe5\x80\xbc\r\n--AAAAAA--\r\n')
 753         self.assertRaises(
 754             ValueError, multipart_encode, {b'field': b'value'}, boundary='value')
 755
 756     def test_dict_get(self):
 757         FALSE_VALUES = {
 758             'none': None,
 759             'false': False,
 760             'zero': 0,
 761             'empty_string': '',
 762             'empty_list': [],
 763         }
 764         d = FALSE_VALUES.copy()
 765         d['a'] = 42
 766         self.assertEqual(dict_get(d, 'a'), 42)
 767         self.assertEqual(dict_get(d, 'b'), None)
 768         self.assertEqual(dict_get(d, 'b', 42), 42)
 769         self.assertEqual(dict_get(d, ('a', )), 42)
 770         self.assertEqual(dict_get(d, ('b', 'a', )), 42)
 771         self.assertEqual(dict_get(d, ('b', 'c', 'a', 'd', )), 42)
 772         self.assertEqual(dict_get(d, ('b', 'c', )), None)
 773         self.assertEqual(dict_get(d, ('b', 'c', ), 42), 42)
 774         for key, false_value in FALSE_VALUES.items():
 775             self.assertEqual(dict_get(d, ('b', 'c', key, )), None)
 776             self.assertEqual(dict_get(d, ('b', 'c', key, ), skip_false_values=False), false_value)
 777
 778     def test_merge_dicts(self):
 779         self.assertEqual(merge_dicts({'a': 1}, {'b': 2}), {'a': 1, 'b': 2})
 780         self.assertEqual(merge_dicts({'a': 1}, {'a': 2}), {'a': 1})
 781         self.assertEqual(merge_dicts({'a': 1}, {'a': None}), {'a': 1})
 782         self.assertEqual(merge_dicts({'a': 1}, {'a': ''}), {'a': 1})
 783         self.assertEqual(merge_dicts({'a': 1}, {}), {'a': 1})
 784         self.assertEqual(merge_dicts({'a': None}, {'a': 1}), {'a': 1})
 785         self.assertEqual(merge_dicts({'a': ''}, {'a': 1}), {'a': ''})
 786         self.assertEqual(merge_dicts({'a': ''}, {'a': 'abc'}), {'a': 'abc'})
 787         self.assertEqual(merge_dicts({'a': None}, {'a': ''}, {'a': 'abc'}), {'a': 'abc'})
 788
 789     def test_encode_compat_str(self):
 790         self.assertEqual(encode_compat_str(b'\xd1\x82\xd0\xb5\xd1\x81\xd1\x82', 'utf-8'), 'тест')
 791         self.assertEqual(encode_compat_str('тест', 'utf-8'), 'тест')
 792
 793     def test_parse_iso8601(self):
 794         self.assertEqual(parse_iso8601('2014-03-23T23:04:26+0100'), 1395612266)
 795         self.assertEqual(parse_iso8601('2014-03-23T22:04:26+0000'), 1395612266)
 796         self.assertEqual(parse_iso8601('2014-03-23T22:04:26Z'), 1395612266)
 797         self.assertEqual(parse_iso8601('2014-03-23T22:04:26.1234Z'), 1395612266)
 798         self.assertEqual(parse_iso8601('2015-09-29T08:27:31.727'), 1443515251)
 799         self.assertEqual(parse_iso8601('2015-09-29T08-27-31.727'), None)
 800
 801     def test_strip_jsonp(self):
 802         stripped = strip_jsonp('cb ([ {"id":"532cb",\n\n\n"x":\n3}\n]\n);')
 803         d = json.loads(stripped)
 804         self.assertEqual(d, [{"id": "532cb", "x": 3}])
 805
 806         stripped = strip_jsonp('parseMetadata({"STATUS":"OK"})\n\n\n//epc')
 807         d = json.loads(stripped)
 808         self.assertEqual(d, {'STATUS': 'OK'})
 809
 810         stripped = strip_jsonp('ps.embedHandler({"status": "success"});')
 811         d = json.loads(stripped)
 812         self.assertEqual(d, {'status': 'success'})
 813
 814         stripped = strip_jsonp('window.cb && window.cb({"status": "success"});')
 815         d = json.loads(stripped)
 816         self.assertEqual(d, {'status': 'success'})
 817
 818         stripped = strip_jsonp('window.cb && cb({"status": "success"});')
 819         d = json.loads(stripped)
 820         self.assertEqual(d, {'status': 'success'})
 821
 822         stripped = strip_jsonp('({"status": "success"});')
 823         d = json.loads(stripped)
 824         self.assertEqual(d, {'status': 'success'})
 825
 826     def test_strip_or_none(self):
 827         self.assertEqual(strip_or_none(' abc'), 'abc')
 828         self.assertEqual(strip_or_none('abc '), 'abc')
 829         self.assertEqual(strip_or_none(' abc '), 'abc')
 830         self.assertEqual(strip_or_none('\tabc\t'), 'abc')
 831         self.assertEqual(strip_or_none('\n\tabc\n\t'), 'abc')
 832         self.assertEqual(strip_or_none('abc'), 'abc')
 833         self.assertEqual(strip_or_none(''), '')
 834         self.assertEqual(strip_or_none(None), None)
 835         self.assertEqual(strip_or_none(42), None)
 836         self.assertEqual(strip_or_none([]), None)
 837
 838     def test_uppercase_escape(self):
 839         self.assertEqual(uppercase_escape('aä'), 'aä')
 840         self.assertEqual(uppercase_escape('\\U0001d550'), '𝕐')
 841
 842     def test_lowercase_escape(self):
 843         self.assertEqual(lowercase_escape('aä'), 'aä')
 844         self.assertEqual(lowercase_escape('\\u0026'), '&')
 845
 846     def test_limit_length(self):
 847         self.assertEqual(limit_length(None, 12), None)
 848         self.assertEqual(limit_length('foo', 12), 'foo')
 849         self.assertTrue(
 850             limit_length('foo bar baz asd', 12).startswith('foo bar'))
 851         self.assertTrue('...' in limit_length('foo bar baz asd', 12))
 852
 853     def test_mimetype2ext(self):
 854         self.assertEqual(mimetype2ext(None), None)
 855         self.assertEqual(mimetype2ext('video/x-flv'), 'flv')
 856         self.assertEqual(mimetype2ext('application/x-mpegURL'), 'm3u8')
 857         self.assertEqual(mimetype2ext('text/vtt'), 'vtt')
 858         self.assertEqual(mimetype2ext('text/vtt;charset=utf-8'), 'vtt')
 859         self.assertEqual(mimetype2ext('text/html; charset=utf-8'), 'html')
 860         self.assertEqual(mimetype2ext('audio/x-wav'), 'wav')
 861         self.assertEqual(mimetype2ext('audio/x-wav;codec=pcm'), 'wav')
 862
 863     def test_month_by_name(self):
 864         self.assertEqual(month_by_name(None), None)
 865         self.assertEqual(month_by_name('December', 'en'), 12)
 866         self.assertEqual(month_by_name('décembre', 'fr'), 12)
 867         self.assertEqual(month_by_name('December'), 12)
 868         self.assertEqual(month_by_name('décembre'), None)
 869         self.assertEqual(month_by_name('Unknown', 'unknown'), None)
 870
 871     def test_parse_codecs(self):
 872         self.assertEqual(parse_codecs(''), {})
 873         self.assertEqual(parse_codecs('avc1.77.30, mp4a.40.2'), {
 874             'vcodec': 'avc1.77.30',
 875             'acodec': 'mp4a.40.2',
 876             'dynamic_range': None,
 877         })
 878         self.assertEqual(parse_codecs('mp4a.40.2'), {
 879             'vcodec': 'none',
 880             'acodec': 'mp4a.40.2',
 881             'dynamic_range': None,
 882         })
 883         self.assertEqual(parse_codecs('mp4a.40.5,avc1.42001e'), {
 884             'vcodec': 'avc1.42001e',
 885             'acodec': 'mp4a.40.5',
 886             'dynamic_range': None,
 887         })
 888         self.assertEqual(parse_codecs('avc3.640028'), {
 889             'vcodec': 'avc3.640028',
 890             'acodec': 'none',
 891             'dynamic_range': None,
 892         })
 893         self.assertEqual(parse_codecs(', h264,,newcodec,aac'), {
 894             'vcodec': 'h264',
 895             'acodec': 'aac',
 896             'dynamic_range': None,
 897         })
 898         self.assertEqual(parse_codecs('av01.0.05M.08'), {
 899             'vcodec': 'av01.0.05M.08',
 900             'acodec': 'none',
 901             'dynamic_range': None,
 902         })
 903         self.assertEqual(parse_codecs('vp9.2'), {
 904             'vcodec': 'vp9.2',
 905             'acodec': 'none',
 906             'dynamic_range': 'HDR10',
 907         })
 908         self.assertEqual(parse_codecs('av01.0.12M.10.0.110.09.16.09.0'), {
 909             'vcodec': 'av01.0.12M.10.0.110.09.16.09.0',
 910             'acodec': 'none',
 911             'dynamic_range': 'HDR10',
 912         })
 913         self.assertEqual(parse_codecs('dvhe'), {
 914             'vcodec': 'dvhe',
 915             'acodec': 'none',
 916             'dynamic_range': 'DV',
 917         })
 918         self.assertEqual(parse_codecs('theora, vorbis'), {
 919             'vcodec': 'theora',
 920             'acodec': 'vorbis',
 921             'dynamic_range': None,
 922         })
 923         self.assertEqual(parse_codecs('unknownvcodec, unknownacodec'), {
 924             'vcodec': 'unknownvcodec',
 925             'acodec': 'unknownacodec',
 926         })
 927         self.assertEqual(parse_codecs('unknown'), {})
 928
 929     def test_escape_rfc3986(self):
 930         reserved = "!*'();:@&=+$,/?#[]"
 931         unreserved = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_.~'
 932         self.assertEqual(escape_rfc3986(reserved), reserved)
 933         self.assertEqual(escape_rfc3986(unreserved), unreserved)
 934         self.assertEqual(escape_rfc3986('тест'), '%D1%82%D0%B5%D1%81%D1%82')
 935         self.assertEqual(escape_rfc3986('%D1%82%D0%B5%D1%81%D1%82'), '%D1%82%D0%B5%D1%81%D1%82')
 936         self.assertEqual(escape_rfc3986('foo bar'), 'foo%20bar')
 937         self.assertEqual(escape_rfc3986('foo%20bar'), 'foo%20bar')
 938
 939     def test_escape_url(self):
 940         self.assertEqual(
 941             escape_url('http://wowza.imust.org/srv/vod/telemb/new/UPLOAD/UPLOAD/20224_IncendieHavré_FD.mp4'),
 942             'http://wowza.imust.org/srv/vod/telemb/new/UPLOAD/UPLOAD/20224_IncendieHavre%CC%81_FD.mp4'
 943         )
 944         self.assertEqual(
 945             escape_url('http://www.ardmediathek.de/tv/Sturm-der-Liebe/Folge-2036-Zu-Mann-und-Frau-erklärt/Das-Erste/Video?documentId=22673108&bcastId=5290'),
 946             'http://www.ardmediathek.de/tv/Sturm-der-Liebe/Folge-2036-Zu-Mann-und-Frau-erkl%C3%A4rt/Das-Erste/Video?documentId=22673108&bcastId=5290'
 947         )
 948         self.assertEqual(
 949             escape_url('http://тест.рф/фрагмент'),
 950             'http://xn--e1aybc.xn--p1ai/%D1%84%D1%80%D0%B0%D0%B3%D0%BC%D0%B5%D0%BD%D1%82'
 951         )
 952         self.assertEqual(
 953             escape_url('http://тест.рф/абв?абв=абв#абв'),
 954             'http://xn--e1aybc.xn--p1ai/%D0%B0%D0%B1%D0%B2?%D0%B0%D0%B1%D0%B2=%D0%B0%D0%B1%D0%B2#%D0%B0%D0%B1%D0%B2'
 955         )
 956         self.assertEqual(escape_url('http://vimeo.com/56015672#at=0'), 'http://vimeo.com/56015672#at=0')
 957
 958     def test_js_to_json_vars_strings(self):
 959         self.assertDictEqual(
 960             json.loads(js_to_json(
 961                 '''{
 962                     'null': a,
 963                     'nullStr': b,
 964                     'true': c,
 965                     'trueStr': d,
 966                     'false': e,
 967                     'falseStr': f,
 968                     'unresolvedVar': g,
 969                 }''',
 970                 {
 971                     'a': 'null',
 972                     'b': '"null"',
 973                     'c': 'true',
 974                     'd': '"true"',
 975                     'e': 'false',
 976                     'f': '"false"',
 977                     'g': 'var',
 978                 }
 979             )),
 980             {
 981                 'null': None,
 982                 'nullStr': 'null',
 983                 'true': True,
 984                 'trueStr': 'true',
 985                 'false': False,
 986                 'falseStr': 'false',
 987                 'unresolvedVar': 'var'
 988             }
 989         )
 990
 991         self.assertDictEqual(
 992             json.loads(js_to_json(
 993                 '''{
 994                     'int': a,
 995                     'intStr': b,
 996                     'float': c,
 997                     'floatStr': d,
 998                 }''',
 999                 {
1000                     'a': '123',
1001                     'b': '"123"',
1002                     'c': '1.23',
1003                     'd': '"1.23"',
1004                 }
1005             )),
1006             {
1007                 'int': 123,
1008                 'intStr': '123',
1009                 'float': 1.23,
1010                 'floatStr': '1.23',
1011             }
1012         )
1013
1014         self.assertDictEqual(
1015             json.loads(js_to_json(
1016                 '''{
1017                     'object': a,
1018                     'objectStr': b,
1019                     'array': c,
1020                     'arrayStr': d,
1021                 }''',
1022                 {
1023                     'a': '{}',
1024                     'b': '"{}"',
1025                     'c': '[]',
1026                     'd': '"[]"',
1027                 }
1028             )),
1029             {
1030                 'object': {},
1031                 'objectStr': '{}',
1032                 'array': [],
1033                 'arrayStr': '[]',
1034             }
1035         )
1036
1037     def test_js_to_json_realworld(self):
1038         inp = '''{
1039             'clip':{'provider':'pseudo'}
1040         }'''
1041         self.assertEqual(js_to_json(inp), '''{
1042             "clip":{"provider":"pseudo"}
1043         }''')
1044         json.loads(js_to_json(inp))
1045
1046         inp = '''{
1047             'playlist':[{'controls':{'all':null}}]
1048         }'''
1049         self.assertEqual(js_to_json(inp), '''{
1050             "playlist":[{"controls":{"all":null}}]
1051         }''')
1052
1053         inp = '''"The CW\\'s \\'Crazy Ex-Girlfriend\\'"'''
1054         self.assertEqual(js_to_json(inp), '''"The CW's 'Crazy Ex-Girlfriend'"''')
1055
1056         inp = '"SAND Number: SAND 2013-7800P\\nPresenter: Tom Russo\\nHabanero Software Training - Xyce Software\\nXyce, Sandia\\u0027s"'
1057         json_code = js_to_json(inp)
1058         self.assertEqual(json.loads(json_code), json.loads(inp))
1059
1060         inp = '''{
1061             0:{src:'skipped', type: 'application/dash+xml'},
1062             1:{src:'skipped', type: 'application/vnd.apple.mpegURL'},
1063         }'''
1064         self.assertEqual(js_to_json(inp), '''{
1065             "0":{"src":"skipped", "type": "application/dash+xml"},
1066             "1":{"src":"skipped", "type": "application/vnd.apple.mpegURL"}
1067         }''')
1068
1069         inp = '''{"foo":101}'''
1070         self.assertEqual(js_to_json(inp), '''{"foo":101}''')
1071
1072         inp = '''{"duration": "00:01:07"}'''
1073         self.assertEqual(js_to_json(inp), '''{"duration": "00:01:07"}''')
1074
1075         inp = '''{segments: [{"offset":-3.885780586188048e-16,"duration":39.75000000000001}]}'''
1076         self.assertEqual(js_to_json(inp), '''{"segments": [{"offset":-3.885780586188048e-16,"duration":39.75000000000001}]}''')
1077
1078     def test_js_to_json_edgecases(self):
1079         on = js_to_json("{abc_def:'1\\'\\\\2\\\\\\'3\"4'}")
1080         self.assertEqual(json.loads(on), {"abc_def": "1'\\2\\'3\"4"})
1081
1082         on = js_to_json('{"abc": true}')
1083         self.assertEqual(json.loads(on), {'abc': True})
1084
1085         # Ignore JavaScript code as well
1086         on = js_to_json('''{
1087             "x": 1,
1088             y: "a",
1089             z: some.code
1090         }''')
1091         d = json.loads(on)
1092         self.assertEqual(d['x'], 1)
1093         self.assertEqual(d['y'], 'a')
1094
1095         # Just drop ! prefix for now though this results in a wrong value
1096         on = js_to_json('''{
1097             a: !0,
1098             b: !1,
1099             c: !!0,
1100             d: !!42.42,
1101             e: !!![],
1102             f: !"abc",
1103             g: !"",
1104             !42: 42
1105         }''')
1106         self.assertEqual(json.loads(on), {
1107             'a': 0,
1108             'b': 1,
1109             'c': 0,
1110             'd': 42.42,
1111             'e': [],
1112             'f': "abc",
1113             'g': "",
1114             '42': 42
1115         })
1116
1117         on = js_to_json('["abc", "def",]')
1118         self.assertEqual(json.loads(on), ['abc', 'def'])
1119
1120         on = js_to_json('[/*comment\n*/"abc"/*comment\n*/,/*comment\n*/"def",/*comment\n*/]')
1121         self.assertEqual(json.loads(on), ['abc', 'def'])
1122
1123         on = js_to_json('[//comment\n"abc" //comment\n,//comment\n"def",//comment\n]')
1124         self.assertEqual(json.loads(on), ['abc', 'def'])
1125
1126         on = js_to_json('{"abc": "def",}')
1127         self.assertEqual(json.loads(on), {'abc': 'def'})
1128
1129         on = js_to_json('{/*comment\n*/"abc"/*comment\n*/:/*comment\n*/"def"/*comment\n*/,/*comment\n*/}')
1130         self.assertEqual(json.loads(on), {'abc': 'def'})
1131
1132         on = js_to_json('{ 0: /* " \n */ ",]" , }')
1133         self.assertEqual(json.loads(on), {'0': ',]'})
1134
1135         on = js_to_json('{ /*comment\n*/0/*comment\n*/: /* " \n */ ",]" , }')
1136         self.assertEqual(json.loads(on), {'0': ',]'})
1137
1138         on = js_to_json('{ 0: // comment\n1 }')
1139         self.assertEqual(json.loads(on), {'0': 1})
1140
1141         on = js_to_json(r'["<p>x<\/p>"]')
1142         self.assertEqual(json.loads(on), ['<p>x</p>'])
1143
1144         on = js_to_json(r'["\xaa"]')
1145         self.assertEqual(json.loads(on), ['\u00aa'])
1146
1147         on = js_to_json("['a\\\nb']")
1148         self.assertEqual(json.loads(on), ['ab'])
1149
1150         on = js_to_json("/*comment\n*/[/*comment\n*/'a\\\nb'/*comment\n*/]/*comment\n*/")
1151         self.assertEqual(json.loads(on), ['ab'])
1152
1153         on = js_to_json('{0xff:0xff}')
1154         self.assertEqual(json.loads(on), {'255': 255})
1155
1156         on = js_to_json('{/*comment\n*/0xff/*comment\n*/:/*comment\n*/0xff/*comment\n*/}')
1157         self.assertEqual(json.loads(on), {'255': 255})
1158
1159         on = js_to_json('{077:077}')
1160         self.assertEqual(json.loads(on), {'63': 63})
1161
1162         on = js_to_json('{/*comment\n*/077/*comment\n*/:/*comment\n*/077/*comment\n*/}')
1163         self.assertEqual(json.loads(on), {'63': 63})
1164
1165         on = js_to_json('{42:42}')
1166         self.assertEqual(json.loads(on), {'42': 42})
1167
1168         on = js_to_json('{/*comment\n*/42/*comment\n*/:/*comment\n*/42/*comment\n*/}')
1169         self.assertEqual(json.loads(on), {'42': 42})
1170
1171         on = js_to_json('{42:4.2e1}')
1172         self.assertEqual(json.loads(on), {'42': 42.0})
1173
1174         on = js_to_json('{ "0x40": "0x40" }')
1175         self.assertEqual(json.loads(on), {'0x40': '0x40'})
1176
1177         on = js_to_json('{ "040": "040" }')
1178         self.assertEqual(json.loads(on), {'040': '040'})
1179
1180         on = js_to_json('[1,//{},\n2]')
1181         self.assertEqual(json.loads(on), [1, 2])
1182
1183         on = js_to_json(R'"\^\$\#"')
1184         self.assertEqual(json.loads(on), R'^$#', msg='Unnecessary escapes should be stripped')
1185
1186         on = js_to_json('\'"\\""\'')
1187         self.assertEqual(json.loads(on), '"""', msg='Unnecessary quote escape should be escaped')
1188
1189     def test_js_to_json_malformed(self):
1190         self.assertEqual(js_to_json('42a1'), '42"a1"')
1191         self.assertEqual(js_to_json('42a-1'), '42"a"-1')
1192
1193     def test_js_to_json_template_literal(self):
1194         self.assertEqual(js_to_json('`Hello ${name}`', {'name': '"world"'}), '"Hello world"')
1195         self.assertEqual(js_to_json('`${name}${name}`', {'name': '"X"'}), '"XX"')
1196         self.assertEqual(js_to_json('`${name}${name}`', {'name': '5'}), '"55"')
1197         self.assertEqual(js_to_json('`${name}"${name}"`', {'name': '5'}), '"5\\"5\\""')
1198         self.assertEqual(js_to_json('`${name}`', {}), '"name"')
1199
1200     def test_extract_attributes(self):
1201         self.assertEqual(extract_attributes('<e x="y">'), {'x': 'y'})
1202         self.assertEqual(extract_attributes("<e x='y'>"), {'x': 'y'})
1203         self.assertEqual(extract_attributes('<e x=y>'), {'x': 'y'})
1204         self.assertEqual(extract_attributes('<e x="a \'b\' c">'), {'x': "a 'b' c"})
1205         self.assertEqual(extract_attributes('<e x=\'a "b" c\'>'), {'x': 'a "b" c'})
1206         self.assertEqual(extract_attributes('<e x="&#121;">'), {'x': 'y'})
1207         self.assertEqual(extract_attributes('<e x="&#x79;">'), {'x': 'y'})
1208         self.assertEqual(extract_attributes('<e x="&amp;">'), {'x': '&'})  # XML
1209         self.assertEqual(extract_attributes('<e x="&quot;">'), {'x': '"'})
1210         self.assertEqual(extract_attributes('<e x="&pound;">'), {'x': '£'})  # HTML 3.2
1211         self.assertEqual(extract_attributes('<e x="&lambda;">'), {'x': 'λ'})  # HTML 4.0
1212         self.assertEqual(extract_attributes('<e x="&foo">'), {'x': '&foo'})
1213         self.assertEqual(extract_attributes('<e x="\'">'), {'x': "'"})
1214         self.assertEqual(extract_attributes('<e x=\'"\'>'), {'x': '"'})
1215         self.assertEqual(extract_attributes('<e x >'), {'x': None})
1216         self.assertEqual(extract_attributes('<e x=y a>'), {'x': 'y', 'a': None})
1217         self.assertEqual(extract_attributes('<e x= y>'), {'x': 'y'})
1218         self.assertEqual(extract_attributes('<e x=1 y=2 x=3>'), {'y': '2', 'x': '3'})
1219         self.assertEqual(extract_attributes('<e \nx=\ny\n>'), {'x': 'y'})
1220         self.assertEqual(extract_attributes('<e \nx=\n"y"\n>'), {'x': 'y'})
1221         self.assertEqual(extract_attributes("<e \nx=\n'y'\n>"), {'x': 'y'})
1222         self.assertEqual(extract_attributes('<e \nx="\ny\n">'), {'x': '\ny\n'})
1223         self.assertEqual(extract_attributes('<e CAPS=x>'), {'caps': 'x'})  # Names lowercased
1224         self.assertEqual(extract_attributes('<e x=1 X=2>'), {'x': '2'})
1225         self.assertEqual(extract_attributes('<e X=1 x=2>'), {'x': '2'})
1226         self.assertEqual(extract_attributes('<e _:funny-name1=1>'), {'_:funny-name1': '1'})
1227         self.assertEqual(extract_attributes('<e x="Fáilte 世界 \U0001f600">'), {'x': 'Fáilte 世界 \U0001f600'})
1228         self.assertEqual(extract_attributes('<e x="décompose&#769;">'), {'x': 'décompose\u0301'})
1229         # "Narrow" Python builds don't support unicode code points outside BMP.
1230         try:
1231             chr(0x10000)
1232             supports_outside_bmp = True
1233         except ValueError:
1234             supports_outside_bmp = False
1235         if supports_outside_bmp:
1236             self.assertEqual(extract_attributes('<e x="Smile &#128512;!">'), {'x': 'Smile \U0001f600!'})
1237         # Malformed HTML should not break attributes extraction on older Python
1238         self.assertEqual(extract_attributes('<mal"formed/>'), {})
1239
1240     def test_clean_html(self):
1241         self.assertEqual(clean_html('a:\nb'), 'a: b')
1242         self.assertEqual(clean_html('a:\n   "b"'), 'a: "b"')
1243         self.assertEqual(clean_html('a<br>\xa0b'), 'a\nb')
1244
1245     def test_intlist_to_bytes(self):
1246         self.assertEqual(
1247             intlist_to_bytes([0, 1, 127, 128, 255]),
1248             b'\x00\x01\x7f\x80\xff')
1249
1250     def test_args_to_str(self):
1251         self.assertEqual(
1252             args_to_str(['foo', 'ba/r', '-baz', '2 be', '']),
1253             'foo ba/r -baz \'2 be\' \'\'' if compat_os_name != 'nt' else 'foo ba/r -baz "2 be" ""'
1254         )
1255
1256     def test_parse_filesize(self):
1257         self.assertEqual(parse_filesize(None), None)
1258         self.assertEqual(parse_filesize(''), None)
1259         self.assertEqual(parse_filesize('91 B'), 91)
1260         self.assertEqual(parse_filesize('foobar'), None)
1261         self.assertEqual(parse_filesize('2 MiB'), 2097152)
1262         self.assertEqual(parse_filesize('5 GB'), 5000000000)
1263         self.assertEqual(parse_filesize('1.2Tb'), 1200000000000)
1264         self.assertEqual(parse_filesize('1.2tb'), 1200000000000)
1265         self.assertEqual(parse_filesize('1,24 KB'), 1240)
1266         self.assertEqual(parse_filesize('1,24 kb'), 1240)
1267         self.assertEqual(parse_filesize('8.5 megabytes'), 8500000)
1268
1269     def test_parse_count(self):
1270         self.assertEqual(parse_count(None), None)
1271         self.assertEqual(parse_count(''), None)
1272         self.assertEqual(parse_count('0'), 0)
1273         self.assertEqual(parse_count('1000'), 1000)
1274         self.assertEqual(parse_count('1.000'), 1000)
1275         self.assertEqual(parse_count('1.1k'), 1100)
1276         self.assertEqual(parse_count('1.1 k'), 1100)
1277         self.assertEqual(parse_count('1,1 k'), 1100)
1278         self.assertEqual(parse_count('1.1kk'), 1100000)
1279         self.assertEqual(parse_count('1.1kk '), 1100000)
1280         self.assertEqual(parse_count('1,1kk'), 1100000)
1281         self.assertEqual(parse_count('100 views'), 100)
1282         self.assertEqual(parse_count('1,100 views'), 1100)
1283         self.assertEqual(parse_count('1.1kk views'), 1100000)
1284         self.assertEqual(parse_count('10M views'), 10000000)
1285         self.assertEqual(parse_count('has 10M views'), 10000000)
1286
1287     def test_parse_resolution(self):
1288         self.assertEqual(parse_resolution(None), {})
1289         self.assertEqual(parse_resolution(''), {})
1290         self.assertEqual(parse_resolution(' 1920x1080'), {'width': 1920, 'height': 1080})
1291         self.assertEqual(parse_resolution('1920×1080 '), {'width': 1920, 'height': 1080})
1292         self.assertEqual(parse_resolution('1920 x 1080'), {'width': 1920, 'height': 1080})
1293         self.assertEqual(parse_resolution('720p'), {'height': 720})
1294         self.assertEqual(parse_resolution('4k'), {'height': 2160})
1295         self.assertEqual(parse_resolution('8K'), {'height': 4320})
1296         self.assertEqual(parse_resolution('pre_1920x1080_post'), {'width': 1920, 'height': 1080})
1297         self.assertEqual(parse_resolution('ep1x2'), {})
1298         self.assertEqual(parse_resolution('1920, 1080'), {'width': 1920, 'height': 1080})
1299
1300     def test_parse_bitrate(self):
1301         self.assertEqual(parse_bitrate(None), None)
1302         self.assertEqual(parse_bitrate(''), None)
1303         self.assertEqual(parse_bitrate('300kbps'), 300)
1304         self.assertEqual(parse_bitrate('1500kbps'), 1500)
1305         self.assertEqual(parse_bitrate('300 kbps'), 300)
1306
1307     def test_version_tuple(self):
1308         self.assertEqual(version_tuple('1'), (1,))
1309         self.assertEqual(version_tuple('10.23.344'), (10, 23, 344))
1310         self.assertEqual(version_tuple('10.1-6'), (10, 1, 6))  # avconv style
1311
1312     def test_detect_exe_version(self):
1313         self.assertEqual(detect_exe_version('''ffmpeg version 1.2.1
1314 built on May 27 2013 08:37:26 with gcc 4.7 (Debian 4.7.3-4)
1315 configuration: --prefix=/usr --extra-'''), '1.2.1')
1316         self.assertEqual(detect_exe_version('''ffmpeg version N-63176-g1fb4685
1317 built on May 15 2014 22:09:06 with gcc 4.8.2 (GCC)'''), 'N-63176-g1fb4685')
1318         self.assertEqual(detect_exe_version('''X server found. dri2 connection failed!
1319 Trying to open render node...
1320 Success at /dev/dri/renderD128.
1321 ffmpeg version 2.4.4 Copyright (c) 2000-2014 the FFmpeg ...'''), '2.4.4')
1322
1323     def test_age_restricted(self):
1324         self.assertFalse(age_restricted(None, 10))  # unrestricted content
1325         self.assertFalse(age_restricted(1, None))  # unrestricted policy
1326         self.assertFalse(age_restricted(8, 10))
1327         self.assertTrue(age_restricted(18, 14))
1328         self.assertFalse(age_restricted(18, 18))
1329
1330     def test_is_html(self):
1331         self.assertFalse(is_html(b'\x49\x44\x43<html'))
1332         self.assertTrue(is_html(b'<!DOCTYPE foo>\xaaa'))
1333         self.assertTrue(is_html(  # UTF-8 with BOM
1334             b'\xef\xbb\xbf<!DOCTYPE foo>\xaaa'))
1335         self.assertTrue(is_html(  # UTF-16-LE
1336             b'\xff\xfe<\x00h\x00t\x00m\x00l\x00>\x00\xe4\x00'
1337         ))
1338         self.assertTrue(is_html(  # UTF-16-BE
1339             b'\xfe\xff\x00<\x00h\x00t\x00m\x00l\x00>\x00\xe4'
1340         ))
1341         self.assertTrue(is_html(  # UTF-32-BE
1342             b'\x00\x00\xFE\xFF\x00\x00\x00<\x00\x00\x00h\x00\x00\x00t\x00\x00\x00m\x00\x00\x00l\x00\x00\x00>\x00\x00\x00\xe4'))
1343         self.assertTrue(is_html(  # UTF-32-LE
1344             b'\xFF\xFE\x00\x00<\x00\x00\x00h\x00\x00\x00t\x00\x00\x00m\x00\x00\x00l\x00\x00\x00>\x00\x00\x00\xe4\x00\x00\x00'))
1345
1346     def test_render_table(self):
1347         self.assertEqual(
1348             render_table(
1349                 ['a', 'empty', 'bcd'],
1350                 [[123, '', 4], [9999, '', 51]]),
1351             'a    empty bcd\n'
1352             '123        4\n'
1353             '9999       51')
1354
1355         self.assertEqual(
1356             render_table(
1357                 ['a', 'empty', 'bcd'],
1358                 [[123, '', 4], [9999, '', 51]],
1359                 hide_empty=True),
1360             'a    bcd\n'
1361             '123  4\n'
1362             '9999 51')
1363
1364         self.assertEqual(
1365             render_table(
1366                 ['\ta', 'bcd'],
1367                 [['1\t23', 4], ['\t9999', 51]]),
1368             '   a bcd\n'
1369             '1 23 4\n'
1370             '9999 51')
1371
1372         self.assertEqual(
1373             render_table(
1374                 ['a', 'bcd'],
1375                 [[123, 4], [9999, 51]],
1376                 delim='-'),
1377             'a    bcd\n'
1378             '--------\n'
1379             '123  4\n'
1380             '9999 51')
1381
1382         self.assertEqual(
1383             render_table(
1384                 ['a', 'bcd'],
1385                 [[123, 4], [9999, 51]],
1386                 delim='-', extra_gap=2),
1387             'a      bcd\n'
1388             '----------\n'
1389             '123    4\n'
1390             '9999   51')
1391
1392     def test_match_str(self):
1393         # Unary
1394         self.assertFalse(match_str('xy', {'x': 1200}))
1395         self.assertTrue(match_str('!xy', {'x': 1200}))
1396         self.assertTrue(match_str('x', {'x': 1200}))
1397         self.assertFalse(match_str('!x', {'x': 1200}))
1398         self.assertTrue(match_str('x', {'x': 0}))
1399         self.assertTrue(match_str('is_live', {'is_live': True}))
1400         self.assertFalse(match_str('is_live', {'is_live': False}))
1401         self.assertFalse(match_str('is_live', {'is_live': None}))
1402         self.assertFalse(match_str('is_live', {}))
1403         self.assertFalse(match_str('!is_live', {'is_live': True}))
1404         self.assertTrue(match_str('!is_live', {'is_live': False}))
1405         self.assertTrue(match_str('!is_live', {'is_live': None}))
1406         self.assertTrue(match_str('!is_live', {}))
1407         self.assertTrue(match_str('title', {'title': 'abc'}))
1408         self.assertTrue(match_str('title', {'title': ''}))
1409         self.assertFalse(match_str('!title', {'title': 'abc'}))
1410         self.assertFalse(match_str('!title', {'title': ''}))
1411
1412         # Numeric
1413         self.assertFalse(match_str('x>0', {'x': 0}))
1414         self.assertFalse(match_str('x>0', {}))
1415         self.assertTrue(match_str('x>?0', {}))
1416         self.assertTrue(match_str('x>1K', {'x': 1200}))
1417         self.assertFalse(match_str('x>2K', {'x': 1200}))
1418         self.assertTrue(match_str('x>=1200 & x < 1300', {'x': 1200}))
1419         self.assertFalse(match_str('x>=1100 & x < 1200', {'x': 1200}))
1420         self.assertTrue(match_str('x > 1:0:0', {'x': 3700}))
1421
1422         # String
1423         self.assertFalse(match_str('y=a212', {'y': 'foobar42'}))
1424         self.assertTrue(match_str('y=foobar42', {'y': 'foobar42'}))
1425         self.assertFalse(match_str('y!=foobar42', {'y': 'foobar42'}))
1426         self.assertTrue(match_str('y!=foobar2', {'y': 'foobar42'}))
1427         self.assertTrue(match_str('y^=foo', {'y': 'foobar42'}))
1428         self.assertFalse(match_str('y!^=foo', {'y': 'foobar42'}))
1429         self.assertFalse(match_str('y^=bar', {'y': 'foobar42'}))
1430         self.assertTrue(match_str('y!^=bar', {'y': 'foobar42'}))
1431         self.assertRaises(ValueError, match_str, 'x^=42', {'x': 42})
1432         self.assertTrue(match_str('y*=bar', {'y': 'foobar42'}))
1433         self.assertFalse(match_str('y!*=bar', {'y': 'foobar42'}))
1434         self.assertFalse(match_str('y*=baz', {'y': 'foobar42'}))
1435         self.assertTrue(match_str('y!*=baz', {'y': 'foobar42'}))
1436         self.assertTrue(match_str('y$=42', {'y': 'foobar42'}))
1437         self.assertFalse(match_str('y$=43', {'y': 'foobar42'}))
1438
1439         # And
1440         self.assertFalse(match_str(
1441             'like_count > 100 & dislike_count <? 50 & description',
1442             {'like_count': 90, 'description': 'foo'}))
1443         self.assertTrue(match_str(
1444             'like_count > 100 & dislike_count <? 50 & description',
1445             {'like_count': 190, 'description': 'foo'}))
1446         self.assertFalse(match_str(
1447             'like_count > 100 & dislike_count <? 50 & description',
1448             {'like_count': 190, 'dislike_count': 60, 'description': 'foo'}))
1449         self.assertFalse(match_str(
1450             'like_count > 100 & dislike_count <? 50 & description',
1451             {'like_count': 190, 'dislike_count': 10}))
1452
1453         # Regex
1454         self.assertTrue(match_str(r'x~=\bbar', {'x': 'foo bar'}))
1455         self.assertFalse(match_str(r'x~=\bbar.+', {'x': 'foo bar'}))
1456         self.assertFalse(match_str(r'x~=^FOO', {'x': 'foo bar'}))
1457         self.assertTrue(match_str(r'x~=(?i)^FOO', {'x': 'foo bar'}))
1458
1459         # Quotes
1460         self.assertTrue(match_str(r'x^="foo"', {'x': 'foo "bar"'}))
1461         self.assertFalse(match_str(r'x^="foo  "', {'x': 'foo "bar"'}))
1462         self.assertFalse(match_str(r'x$="bar"', {'x': 'foo "bar"'}))
1463         self.assertTrue(match_str(r'x$=" \"bar\""', {'x': 'foo "bar"'}))
1464
1465         # Escaping &
1466         self.assertFalse(match_str(r'x=foo & bar', {'x': 'foo & bar'}))
1467         self.assertTrue(match_str(r'x=foo \& bar', {'x': 'foo & bar'}))
1468         self.assertTrue(match_str(r'x=foo \& bar & x^=foo', {'x': 'foo & bar'}))
1469         self.assertTrue(match_str(r'x="foo \& bar" & x^=foo', {'x': 'foo & bar'}))
1470
1471         # Example from docs
1472         self.assertTrue(match_str(
1473             r"!is_live & like_count>?100 & description~='(?i)\bcats \& dogs\b'",
1474             {'description': 'Raining Cats & Dogs'}))
1475
1476         # Incomplete
1477         self.assertFalse(match_str('id!=foo', {'id': 'foo'}, True))
1478         self.assertTrue(match_str('x', {'id': 'foo'}, True))
1479         self.assertTrue(match_str('!x', {'id': 'foo'}, True))
1480         self.assertFalse(match_str('x', {'id': 'foo'}, False))
1481
1482     def test_parse_dfxp_time_expr(self):
1483         self.assertEqual(parse_dfxp_time_expr(None), None)
1484         self.assertEqual(parse_dfxp_time_expr(''), None)
1485         self.assertEqual(parse_dfxp_time_expr('0.1'), 0.1)
1486         self.assertEqual(parse_dfxp_time_expr('0.1s'), 0.1)
1487         self.assertEqual(parse_dfxp_time_expr('00:00:01'), 1.0)
1488         self.assertEqual(parse_dfxp_time_expr('00:00:01.100'), 1.1)
1489         self.assertEqual(parse_dfxp_time_expr('00:00:01:100'), 1.1)
1490
1491     def test_dfxp2srt(self):
1492         dfxp_data = '''<?xml version="1.0" encoding="UTF-8"?>
1493             <tt xmlns="http://www.w3.org/ns/ttml" xml:lang="en" xmlns:tts="http://www.w3.org/ns/ttml#parameter">
1494             <body>
1495                 <div xml:lang="en">
1496                     <p begin="0" end="1">The following line contains Chinese characters and special symbols</p>
1497                     <p begin="1" end="2">第二行<br/>♪♪</p>
1498                     <p begin="2" dur="1"><span>Third<br/>Line</span></p>
1499                     <p begin="3" end="-1">Lines with invalid timestamps are ignored</p>
1500                     <p begin="-1" end="-1">Ignore, two</p>
1501                     <p begin="3" dur="-1">Ignored, three</p>
1502                 </div>
1503             </body>
1504             </tt>'''.encode()
1505         srt_data = '''1
1506 00:00:00,000 --> 00:00:01,000
1507 The following line contains Chinese characters and special symbols
1508
1509 2
1510 00:00:01,000 --> 00:00:02,000
1511 第二行
1512 ♪♪
1513
1514 3
1515 00:00:02,000 --> 00:00:03,000
1516 Third
1517 Line
1518
1519 '''
1520         self.assertEqual(dfxp2srt(dfxp_data), srt_data)
1521
1522         dfxp_data_no_default_namespace = b'''<?xml version="1.0" encoding="UTF-8"?>
1523             <tt xml:lang="en" xmlns:tts="http://www.w3.org/ns/ttml#parameter">
1524             <body>
1525                 <div xml:lang="en">
1526                     <p begin="0" end="1">The first line</p>
1527                 </div>
1528             </body>
1529             </tt>'''
1530         srt_data = '''1
1531 00:00:00,000 --> 00:00:01,000
1532 The first line
1533
1534 '''
1535         self.assertEqual(dfxp2srt(dfxp_data_no_default_namespace), srt_data)
1536
1537         dfxp_data_with_style = b'''<?xml version="1.0" encoding="utf-8"?>
1538 <tt xmlns="http://www.w3.org/2006/10/ttaf1" xmlns:ttp="http://www.w3.org/2006/10/ttaf1#parameter" ttp:timeBase="media" xmlns:tts="http://www.w3.org/2006/10/ttaf1#style" xml:lang="en" xmlns:ttm="http://www.w3.org/2006/10/ttaf1#metadata">
1539   <head>
1540     <styling>
1541       <style id="s2" style="s0" tts:color="cyan" tts:fontWeight="bold" />
1542       <style id="s1" style="s0" tts:color="yellow" tts:fontStyle="italic" />
1543       <style id="s3" style="s0" tts:color="lime" tts:textDecoration="underline" />
1544       <style id="s0" tts:backgroundColor="black" tts:fontStyle="normal" tts:fontSize="16" tts:fontFamily="sansSerif" tts:color="white" />
1545     </styling>
1546   </head>
1547   <body tts:textAlign="center" style="s0">
1548     <div>
1549       <p begin="00:00:02.08" id="p0" end="00:00:05.84">default style<span tts:color="red">custom style</span></p>
1550       <p style="s2" begin="00:00:02.08" id="p0" end="00:00:05.84"><span tts:color="lime">part 1<br /></span><span tts:color="cyan">part 2</span></p>
1551       <p style="s3" begin="00:00:05.84" id="p1" end="00:00:09.56">line 3<br />part 3</p>
1552       <p style="s1" tts:textDecoration="underline" begin="00:00:09.56" id="p2" end="00:00:12.36"><span style="s2" tts:color="lime">inner<br /> </span>style</p>
1553     </div>
1554   </body>
1555 </tt>'''
1556         srt_data = '''1
1557 00:00:02,080 --> 00:00:05,840
1558 <font color="white" face="sansSerif" size="16">default style<font color="red">custom style</font></font>
1559
1560 2
1561 00:00:02,080 --> 00:00:05,840
1562 <b><font color="cyan" face="sansSerif" size="16"><font color="lime">part 1
1563 </font>part 2</font></b>
1564
1565 3
1566 00:00:05,840 --> 00:00:09,560
1567 <u><font color="lime">line 3
1568 part 3</font></u>
1569
1570 4
1571 00:00:09,560 --> 00:00:12,360
1572 <i><u><font color="yellow"><font color="lime">inner
1573  </font>style</font></u></i>
1574
1575 '''
1576         self.assertEqual(dfxp2srt(dfxp_data_with_style), srt_data)
1577
1578         dfxp_data_non_utf8 = '''<?xml version="1.0" encoding="UTF-16"?>
1579             <tt xmlns="http://www.w3.org/ns/ttml" xml:lang="en" xmlns:tts="http://www.w3.org/ns/ttml#parameter">
1580             <body>
1581                 <div xml:lang="en">
1582                     <p begin="0" end="1">Line 1</p>
1583                     <p begin="1" end="2">第二行</p>
1584                 </div>
1585             </body>
1586             </tt>'''.encode('utf-16')
1587         srt_data = '''1
1588 00:00:00,000 --> 00:00:01,000
1589 Line 1
1590
1591 2
1592 00:00:01,000 --> 00:00:02,000
1593 第二行
1594
1595 '''
1596         self.assertEqual(dfxp2srt(dfxp_data_non_utf8), srt_data)
1597
1598     def test_cli_option(self):
1599         self.assertEqual(cli_option({'proxy': '127.0.0.1:3128'}, '--proxy', 'proxy'), ['--proxy', '127.0.0.1:3128'])
1600         self.assertEqual(cli_option({'proxy': None}, '--proxy', 'proxy'), [])
1601         self.assertEqual(cli_option({}, '--proxy', 'proxy'), [])
1602         self.assertEqual(cli_option({'retries': 10}, '--retries', 'retries'), ['--retries', '10'])
1603
1604     def test_cli_valueless_option(self):
1605         self.assertEqual(cli_valueless_option(
1606             {'downloader': 'external'}, '--external-downloader', 'downloader', 'external'), ['--external-downloader'])
1607         self.assertEqual(cli_valueless_option(
1608             {'downloader': 'internal'}, '--external-downloader', 'downloader', 'external'), [])
1609         self.assertEqual(cli_valueless_option(
1610             {'nocheckcertificate': True}, '--no-check-certificate', 'nocheckcertificate'), ['--no-check-certificate'])
1611         self.assertEqual(cli_valueless_option(
1612             {'nocheckcertificate': False}, '--no-check-certificate', 'nocheckcertificate'), [])
1613         self.assertEqual(cli_valueless_option(
1614             {'checkcertificate': True}, '--no-check-certificate', 'checkcertificate', False), [])
1615         self.assertEqual(cli_valueless_option(
1616             {'checkcertificate': False}, '--no-check-certificate', 'checkcertificate', False), ['--no-check-certificate'])
1617
1618     def test_cli_bool_option(self):
1619         self.assertEqual(
1620             cli_bool_option(
1621                 {'nocheckcertificate': True}, '--no-check-certificate', 'nocheckcertificate'),
1622             ['--no-check-certificate', 'true'])
1623         self.assertEqual(
1624             cli_bool_option(
1625                 {'nocheckcertificate': True}, '--no-check-certificate', 'nocheckcertificate', separator='='),
1626             ['--no-check-certificate=true'])
1627         self.assertEqual(
1628             cli_bool_option(
1629                 {'nocheckcertificate': True}, '--check-certificate', 'nocheckcertificate', 'false', 'true'),
1630             ['--check-certificate', 'false'])
1631         self.assertEqual(
1632             cli_bool_option(
1633                 {'nocheckcertificate': True}, '--check-certificate', 'nocheckcertificate', 'false', 'true', '='),
1634             ['--check-certificate=false'])
1635         self.assertEqual(
1636             cli_bool_option(
1637                 {'nocheckcertificate': False}, '--check-certificate', 'nocheckcertificate', 'false', 'true'),
1638             ['--check-certificate', 'true'])
1639         self.assertEqual(
1640             cli_bool_option(
1641                 {'nocheckcertificate': False}, '--check-certificate', 'nocheckcertificate', 'false', 'true', '='),
1642             ['--check-certificate=true'])
1643         self.assertEqual(
1644             cli_bool_option(
1645                 {}, '--check-certificate', 'nocheckcertificate', 'false', 'true', '='),
1646             [])
1647
1648     def test_ohdave_rsa_encrypt(self):
1649         N = 0xab86b6371b5318aaa1d3c9e612a9f1264f372323c8c0f19875b5fc3b3fd3afcc1e5bec527aa94bfa85bffc157e4245aebda05389a5357b75115ac94f074aefcd
1650         e = 65537
1651
1652         self.assertEqual(
1653             ohdave_rsa_encrypt(b'aa111222', e, N),
1654             '726664bd9a23fd0c70f9f1b84aab5e3905ce1e45a584e9cbcf9bcc7510338fc1986d6c599ff990d923aa43c51c0d9013cd572e13bc58f4ae48f2ed8c0b0ba881')
1655
1656     def test_pkcs1pad(self):
1657         data = [1, 2, 3]
1658         padded_data = pkcs1pad(data, 32)
1659         self.assertEqual(padded_data[:2], [0, 2])
1660         self.assertEqual(padded_data[28:], [0, 1, 2, 3])
1661
1662         self.assertRaises(ValueError, pkcs1pad, data, 8)
1663
1664     def test_encode_base_n(self):
1665         self.assertEqual(encode_base_n(0, 30), '0')
1666         self.assertEqual(encode_base_n(80, 30), '2k')
1667
1668         custom_table = '9876543210ZYXWVUTSRQPONMLKJIHGFEDCBA'
1669         self.assertEqual(encode_base_n(0, 30, custom_table), '9')
1670         self.assertEqual(encode_base_n(80, 30, custom_table), '7P')
1671
1672         self.assertRaises(ValueError, encode_base_n, 0, 70)
1673         self.assertRaises(ValueError, encode_base_n, 0, 60, custom_table)
1674
1675     def test_caesar(self):
1676         self.assertEqual(caesar('ace', 'abcdef', 2), 'cea')
1677         self.assertEqual(caesar('cea', 'abcdef', -2), 'ace')
1678         self.assertEqual(caesar('ace', 'abcdef', -2), 'eac')
1679         self.assertEqual(caesar('eac', 'abcdef', 2), 'ace')
1680         self.assertEqual(caesar('ace', 'abcdef', 0), 'ace')
1681         self.assertEqual(caesar('xyz', 'abcdef', 2), 'xyz')
1682         self.assertEqual(caesar('abc', 'acegik', 2), 'ebg')
1683         self.assertEqual(caesar('ebg', 'acegik', -2), 'abc')
1684
1685     def test_rot47(self):
1686         self.assertEqual(rot47('yt-dlp'), r'JE\5=A')
1687         self.assertEqual(rot47('YT-DLP'), r'*%\s{!')
1688
1689     def test_urshift(self):
1690         self.assertEqual(urshift(3, 1), 1)
1691         self.assertEqual(urshift(-3, 1), 2147483646)
1692
1693     GET_ELEMENT_BY_CLASS_TEST_STRING = '''
1694         <span class="foo bar">nice</span>
1695     '''
1696
1697     def test_get_element_by_class(self):
1698         html = self.GET_ELEMENT_BY_CLASS_TEST_STRING
1699
1700         self.assertEqual(get_element_by_class('foo', html), 'nice')
1701         self.assertEqual(get_element_by_class('no-such-class', html), None)
1702
1703     def test_get_element_html_by_class(self):
1704         html = self.GET_ELEMENT_BY_CLASS_TEST_STRING
1705
1706         self.assertEqual(get_element_html_by_class('foo', html), html.strip())
1707         self.assertEqual(get_element_by_class('no-such-class', html), None)
1708
1709     GET_ELEMENT_BY_ATTRIBUTE_TEST_STRING = '''
1710         <div itemprop="author" itemscope>foo</div>
1711     '''
1712
1713     def test_get_element_by_attribute(self):
1714         html = self.GET_ELEMENT_BY_CLASS_TEST_STRING
1715
1716         self.assertEqual(get_element_by_attribute('class', 'foo bar', html), 'nice')
1717         self.assertEqual(get_element_by_attribute('class', 'foo', html), None)
1718         self.assertEqual(get_element_by_attribute('class', 'no-such-foo', html), None)
1719
1720         html = self.GET_ELEMENT_BY_ATTRIBUTE_TEST_STRING
1721
1722         self.assertEqual(get_element_by_attribute('itemprop', 'author', html), 'foo')
1723
1724     def test_get_element_html_by_attribute(self):
1725         html = self.GET_ELEMENT_BY_CLASS_TEST_STRING
1726
1727         self.assertEqual(get_element_html_by_attribute('class', 'foo bar', html), html.strip())
1728         self.assertEqual(get_element_html_by_attribute('class', 'foo', html), None)
1729         self.assertEqual(get_element_html_by_attribute('class', 'no-such-foo', html), None)
1730
1731         html = self.GET_ELEMENT_BY_ATTRIBUTE_TEST_STRING
1732
1733         self.assertEqual(get_element_html_by_attribute('itemprop', 'author', html), html.strip())
1734
1735     GET_ELEMENTS_BY_CLASS_TEST_STRING = '''
1736         <span class="foo bar">nice</span><span class="foo bar">also nice</span>
1737     '''
1738     GET_ELEMENTS_BY_CLASS_RES = ['<span class="foo bar">nice</span>', '<span class="foo bar">also nice</span>']
1739
1740     def test_get_elements_by_class(self):
1741         html = self.GET_ELEMENTS_BY_CLASS_TEST_STRING
1742
1743         self.assertEqual(get_elements_by_class('foo', html), ['nice', 'also nice'])
1744         self.assertEqual(get_elements_by_class('no-such-class', html), [])
1745
1746     def test_get_elements_html_by_class(self):
1747         html = self.GET_ELEMENTS_BY_CLASS_TEST_STRING
1748
1749         self.assertEqual(get_elements_html_by_class('foo', html), self.GET_ELEMENTS_BY_CLASS_RES)
1750         self.assertEqual(get_elements_html_by_class('no-such-class', html), [])
1751
1752     def test_get_elements_by_attribute(self):
1753         html = self.GET_ELEMENTS_BY_CLASS_TEST_STRING
1754
1755         self.assertEqual(get_elements_by_attribute('class', 'foo bar', html), ['nice', 'also nice'])
1756         self.assertEqual(get_elements_by_attribute('class', 'foo', html), [])
1757         self.assertEqual(get_elements_by_attribute('class', 'no-such-foo', html), [])
1758
1759     def test_get_elements_html_by_attribute(self):
1760         html = self.GET_ELEMENTS_BY_CLASS_TEST_STRING
1761
1762         self.assertEqual(get_elements_html_by_attribute('class', 'foo bar', html), self.GET_ELEMENTS_BY_CLASS_RES)
1763         self.assertEqual(get_elements_html_by_attribute('class', 'foo', html), [])
1764         self.assertEqual(get_elements_html_by_attribute('class', 'no-such-foo', html), [])
1765
1766     def test_get_elements_text_and_html_by_attribute(self):
1767         html = self.GET_ELEMENTS_BY_CLASS_TEST_STRING
1768
1769         self.assertEqual(
1770             list(get_elements_text_and_html_by_attribute('class', 'foo bar', html)),
1771             list(zip(['nice', 'also nice'], self.GET_ELEMENTS_BY_CLASS_RES)))
1772         self.assertEqual(list(get_elements_text_and_html_by_attribute('class', 'foo', html)), [])
1773         self.assertEqual(list(get_elements_text_and_html_by_attribute('class', 'no-such-foo', html)), [])
1774
1775         self.assertEqual(list(get_elements_text_and_html_by_attribute(
1776             'class', 'foo', '<a class="foo">nice</a><span class="foo">nice</span>', tag='a')), [('nice', '<a class="foo">nice</a>')])
1777
1778     GET_ELEMENT_BY_TAG_TEST_STRING = '''
1779     random text lorem ipsum</p>
1780     <div>
1781         this should be returned
1782         <span>this should also be returned</span>
1783         <div>
1784             this should also be returned
1785         </div>
1786         closing tag above should not trick, so this should also be returned
1787     </div>
1788     but this text should not be returned
1789     '''
1790     GET_ELEMENT_BY_TAG_RES_OUTERDIV_HTML = GET_ELEMENT_BY_TAG_TEST_STRING.strip()[32:276]
1791     GET_ELEMENT_BY_TAG_RES_OUTERDIV_TEXT = GET_ELEMENT_BY_TAG_RES_OUTERDIV_HTML[5:-6]
1792     GET_ELEMENT_BY_TAG_RES_INNERSPAN_HTML = GET_ELEMENT_BY_TAG_TEST_STRING.strip()[78:119]
1793     GET_ELEMENT_BY_TAG_RES_INNERSPAN_TEXT = GET_ELEMENT_BY_TAG_RES_INNERSPAN_HTML[6:-7]
1794
1795     def test_get_element_text_and_html_by_tag(self):
1796         html = self.GET_ELEMENT_BY_TAG_TEST_STRING
1797
1798         self.assertEqual(
1799             get_element_text_and_html_by_tag('div', html),
1800             (self.GET_ELEMENT_BY_TAG_RES_OUTERDIV_TEXT, self.GET_ELEMENT_BY_TAG_RES_OUTERDIV_HTML))
1801         self.assertEqual(
1802             get_element_text_and_html_by_tag('span', html),
1803             (self.GET_ELEMENT_BY_TAG_RES_INNERSPAN_TEXT, self.GET_ELEMENT_BY_TAG_RES_INNERSPAN_HTML))
1804         self.assertRaises(compat_HTMLParseError, get_element_text_and_html_by_tag, 'article', html)
1805
1806     def test_iri_to_uri(self):
1807         self.assertEqual(
1808             iri_to_uri('https://www.google.com/search?q=foo&ie=utf-8&oe=utf-8&client=firefox-b'),
1809             'https://www.google.com/search?q=foo&ie=utf-8&oe=utf-8&client=firefox-b')  # Same
1810         self.assertEqual(
1811             iri_to_uri('https://www.google.com/search?q=Käsesoßenrührlöffel'),  # German for cheese sauce stirring spoon
1812             'https://www.google.com/search?q=K%C3%A4seso%C3%9Fenr%C3%BChrl%C3%B6ffel')
1813         self.assertEqual(
1814             iri_to_uri('https://www.google.com/search?q=lt<+gt>+eq%3D+amp%26+percent%25+hash%23+colon%3A+tilde~#trash=?&garbage=#'),
1815             'https://www.google.com/search?q=lt%3C+gt%3E+eq%3D+amp%26+percent%25+hash%23+colon%3A+tilde~#trash=?&garbage=#')
1816         self.assertEqual(
1817             iri_to_uri('http://правозащита38.рф/category/news/'),
1818             'http://xn--38-6kcaak9aj5chl4a3g.xn--p1ai/category/news/')
1819         self.assertEqual(
1820             iri_to_uri('http://www.правозащита38.рф/category/news/'),
1821             'http://www.xn--38-6kcaak9aj5chl4a3g.xn--p1ai/category/news/')
1822         self.assertEqual(
1823             iri_to_uri('https://i❤.ws/emojidomain/👍👏🤝💪'),
1824             'https://xn--i-7iq.ws/emojidomain/%F0%9F%91%8D%F0%9F%91%8F%F0%9F%A4%9D%F0%9F%92%AA')
1825         self.assertEqual(
1826             iri_to_uri('http://日本語.jp/'),
1827             'http://xn--wgv71a119e.jp/')
1828         self.assertEqual(
1829             iri_to_uri('http://导航.中国/'),
1830             'http://xn--fet810g.xn--fiqs8s/')
1831
1832     def test_clean_podcast_url(self):
1833         self.assertEqual(clean_podcast_url('https://www.podtrac.com/pts/redirect.mp3/chtbl.com/track/5899E/traffic.megaphone.fm/HSW7835899191.mp3'), 'https://traffic.megaphone.fm/HSW7835899191.mp3')
1834         self.assertEqual(clean_podcast_url('https://play.podtrac.com/npr-344098539/edge1.pod.npr.org/anon.npr-podcasts/podcast/npr/waitwait/2020/10/20201003_waitwait_wwdtmpodcast201003-015621a5-f035-4eca-a9a1-7c118d90bc3c.mp3'), 'https://edge1.pod.npr.org/anon.npr-podcasts/podcast/npr/waitwait/2020/10/20201003_waitwait_wwdtmpodcast201003-015621a5-f035-4eca-a9a1-7c118d90bc3c.mp3')
1835
1836     def test_LazyList(self):
1837         it = list(range(10))
1838
1839         self.assertEqual(list(LazyList(it)), it)
1840         self.assertEqual(LazyList(it).exhaust(), it)
1841         self.assertEqual(LazyList(it)[5], it[5])
1842
1843         self.assertEqual(LazyList(it)[5:], it[5:])
1844         self.assertEqual(LazyList(it)[:5], it[:5])
1845         self.assertEqual(LazyList(it)[::2], it[::2])
1846         self.assertEqual(LazyList(it)[1::2], it[1::2])
1847         self.assertEqual(LazyList(it)[5::-1], it[5::-1])
1848         self.assertEqual(LazyList(it)[6:2:-2], it[6:2:-2])
1849         self.assertEqual(LazyList(it)[::-1], it[::-1])
1850
1851         self.assertTrue(LazyList(it))
1852         self.assertFalse(LazyList(range(0)))
1853         self.assertEqual(len(LazyList(it)), len(it))
1854         self.assertEqual(repr(LazyList(it)), repr(it))
1855         self.assertEqual(str(LazyList(it)), str(it))
1856
1857         self.assertEqual(list(LazyList(it, reverse=True)), it[::-1])
1858         self.assertEqual(list(reversed(LazyList(it))[::-1]), it)
1859         self.assertEqual(list(reversed(LazyList(it))[1:3:7]), it[::-1][1:3:7])
1860
1861     def test_LazyList_laziness(self):
1862
1863         def test(ll, idx, val, cache):
1864             self.assertEqual(ll[idx], val)
1865             self.assertEqual(ll._cache, list(cache))
1866
1867         ll = LazyList(range(10))
1868         test(ll, 0, 0, range(1))
1869         test(ll, 5, 5, range(6))
1870         test(ll, -3, 7, range(10))
1871
1872         ll = LazyList(range(10), reverse=True)
1873         test(ll, -1, 0, range(1))
1874         test(ll, 3, 6, range(10))
1875
1876         ll = LazyList(itertools.count())
1877         test(ll, 10, 10, range(11))
1878         ll = reversed(ll)
1879         test(ll, -15, 14, range(15))
1880
1881     def test_format_bytes(self):
1882         self.assertEqual(format_bytes(0), '0.00B')
1883         self.assertEqual(format_bytes(1000), '1000.00B')
1884         self.assertEqual(format_bytes(1024), '1.00KiB')
1885         self.assertEqual(format_bytes(1024**2), '1.00MiB')
1886         self.assertEqual(format_bytes(1024**3), '1.00GiB')
1887         self.assertEqual(format_bytes(1024**4), '1.00TiB')
1888         self.assertEqual(format_bytes(1024**5), '1.00PiB')
1889         self.assertEqual(format_bytes(1024**6), '1.00EiB')
1890         self.assertEqual(format_bytes(1024**7), '1.00ZiB')
1891         self.assertEqual(format_bytes(1024**8), '1.00YiB')
1892         self.assertEqual(format_bytes(1024**9), '1024.00YiB')
1893
1894     def test_hide_login_info(self):
1895         self.assertEqual(Config.hide_login_info(['-u', 'foo', '-p', 'bar']),
1896                          ['-u', 'PRIVATE', '-p', 'PRIVATE'])
1897         self.assertEqual(Config.hide_login_info(['-u']), ['-u'])
1898         self.assertEqual(Config.hide_login_info(['-u', 'foo', '-u', 'bar']),
1899                          ['-u', 'PRIVATE', '-u', 'PRIVATE'])
1900         self.assertEqual(Config.hide_login_info(['--username=foo']),
1901                          ['--username=PRIVATE'])
1902
1903     def test_locked_file(self):
1904         TEXT = 'test_locked_file\n'
1905         FILE = 'test_locked_file.ytdl'
1906         MODES = 'war'  # Order is important
1907
1908         try:
1909             for lock_mode in MODES:
1910                 with locked_file(FILE, lock_mode, False) as f:
1911                     if lock_mode == 'r':
1912                         self.assertEqual(f.read(), TEXT * 2, 'Wrong file content')
1913                     else:
1914                         f.write(TEXT)
1915                     for test_mode in MODES:
1916                         testing_write = test_mode != 'r'
1917                         try:
1918                             with locked_file(FILE, test_mode, False):
1919                                 pass
1920                         except (BlockingIOError, PermissionError):
1921                             if not testing_write:  # FIXME
1922                                 print(f'Known issue: Exclusive lock ({lock_mode}) blocks read access ({test_mode})')
1923                                 continue
1924                             self.assertTrue(testing_write, f'{test_mode} is blocked by {lock_mode}')
1925                         else:
1926                             self.assertFalse(testing_write, f'{test_mode} is not blocked by {lock_mode}')
1927         finally:
1928             with contextlib.suppress(OSError):
1929                 os.remove(FILE)
1930
1931     def test_determine_file_encoding(self):
1932         self.assertEqual(determine_file_encoding(b''), (None, 0))
1933         self.assertEqual(determine_file_encoding(b'--verbose -x --audio-format mkv\n'), (None, 0))
1934
1935         self.assertEqual(determine_file_encoding(b'\xef\xbb\xbf'), ('utf-8', 3))
1936         self.assertEqual(determine_file_encoding(b'\x00\x00\xfe\xff'), ('utf-32-be', 4))
1937         self.assertEqual(determine_file_encoding(b'\xff\xfe'), ('utf-16-le', 2))
1938
1939         self.assertEqual(determine_file_encoding(b'\xff\xfe# coding: utf-8\n--verbose'), ('utf-16-le', 2))
1940
1941         self.assertEqual(determine_file_encoding(b'# coding: utf-8\n--verbose'), ('utf-8', 0))
1942         self.assertEqual(determine_file_encoding(b'# coding: someencodinghere-12345\n--verbose'), ('someencodinghere-12345', 0))
1943
1944         self.assertEqual(determine_file_encoding(b'#coding:utf-8\n--verbose'), ('utf-8', 0))
1945         self.assertEqual(determine_file_encoding(b'#  coding:   utf-8   \r\n--verbose'), ('utf-8', 0))
1946
1947         self.assertEqual(determine_file_encoding('# coding: utf-32-be'.encode('utf-32-be')), ('utf-32-be', 0))
1948         self.assertEqual(determine_file_encoding('# coding: utf-16-le'.encode('utf-16-le')), ('utf-16-le', 0))
1949
1950     def test_get_compatible_ext(self):
1951         self.assertEqual(get_compatible_ext(
1952             vcodecs=[None], acodecs=[None, None], vexts=['mp4'], aexts=['m4a', 'm4a']), 'mkv')
1953         self.assertEqual(get_compatible_ext(
1954             vcodecs=[None], acodecs=[None], vexts=['flv'], aexts=['flv']), 'flv')
1955
1956         self.assertEqual(get_compatible_ext(
1957             vcodecs=[None], acodecs=[None], vexts=['mp4'], aexts=['m4a']), 'mp4')
1958         self.assertEqual(get_compatible_ext(
1959             vcodecs=[None], acodecs=[None], vexts=['mp4'], aexts=['webm']), 'mkv')
1960         self.assertEqual(get_compatible_ext(
1961             vcodecs=[None], acodecs=[None], vexts=['webm'], aexts=['m4a']), 'mkv')
1962         self.assertEqual(get_compatible_ext(
1963             vcodecs=[None], acodecs=[None], vexts=['webm'], aexts=['webm']), 'webm')
1964         self.assertEqual(get_compatible_ext(
1965             vcodecs=[None], acodecs=[None], vexts=['webm'], aexts=['weba']), 'webm')
1966
1967         self.assertEqual(get_compatible_ext(
1968             vcodecs=['h264'], acodecs=['mp4a'], vexts=['mov'], aexts=['m4a']), 'mp4')
1969         self.assertEqual(get_compatible_ext(
1970             vcodecs=['av01.0.12M.08'], acodecs=['opus'], vexts=['mp4'], aexts=['webm']), 'webm')
1971
1972         self.assertEqual(get_compatible_ext(
1973             vcodecs=['vp9'], acodecs=['opus'], vexts=['webm'], aexts=['webm'], preferences=['flv', 'mp4']), 'mp4')
1974         self.assertEqual(get_compatible_ext(
1975             vcodecs=['av1'], acodecs=['mp4a'], vexts=['webm'], aexts=['m4a'], preferences=('webm', 'mkv')), 'mkv')
1976
1977     def test_traverse_obj(self):
1978         _TEST_DATA = {
1979             100: 100,
1980             1.2: 1.2,
1981             'str': 'str',
1982             'None': None,
1983             '...': ...,
1984             'urls': [
1985                 {'index': 0, 'url': 'https://www.example.com/0'},
1986                 {'index': 1, 'url': 'https://www.example.com/1'},
1987             ],
1988             'data': (
1989                 {'index': 2},
1990                 {'index': 3},
1991             ),
1992             'dict': {},
1993         }
1994
1995         # Test base functionality
1996         self.assertEqual(traverse_obj(_TEST_DATA, ('str',)), 'str',
1997                          msg='allow tuple path')
1998         self.assertEqual(traverse_obj(_TEST_DATA, ['str']), 'str',
1999                          msg='allow list path')
2000         self.assertEqual(traverse_obj(_TEST_DATA, (value for value in ("str",))), 'str',
2001                          msg='allow iterable path')
2002         self.assertEqual(traverse_obj(_TEST_DATA, 'str'), 'str',
2003                          msg='single items should be treated as a path')
2004         self.assertEqual(traverse_obj(_TEST_DATA, None), _TEST_DATA)
2005         self.assertEqual(traverse_obj(_TEST_DATA, 100), 100)
2006         self.assertEqual(traverse_obj(_TEST_DATA, 1.2), 1.2)
2007
2008         # Test Ellipsis behavior
2009         self.assertCountEqual(traverse_obj(_TEST_DATA, ...),
2010                               (item for item in _TEST_DATA.values() if item not in (None, {})),
2011                               msg='`...` should give all non discarded values')
2012         self.assertCountEqual(traverse_obj(_TEST_DATA, ('urls', 0, ...)), _TEST_DATA['urls'][0].values(),
2013                               msg='`...` selection for dicts should select all values')
2014         self.assertEqual(traverse_obj(_TEST_DATA, (..., ..., 'url')),
2015                          ['https://www.example.com/0', 'https://www.example.com/1'],
2016                          msg='nested `...` queries should work')
2017         self.assertCountEqual(traverse_obj(_TEST_DATA, (..., ..., 'index')), range(4),
2018                               msg='`...` query result should be flattened')
2019
2020         # Test function as key
2021         self.assertEqual(traverse_obj(_TEST_DATA, lambda x, y: x == 'urls' and isinstance(y, list)),
2022                          [_TEST_DATA['urls']],
2023                          msg='function as query key should perform a filter based on (key, value)')
2024         self.assertCountEqual(traverse_obj(_TEST_DATA, lambda _, x: isinstance(x[0], str)), {'str'},
2025                               msg='exceptions in the query function should be catched')
2026         if __debug__:
2027             with self.assertRaises(Exception, msg='Wrong function signature should raise in debug'):
2028                 traverse_obj(_TEST_DATA, lambda a: ...)
2029             with self.assertRaises(Exception, msg='Wrong function signature should raise in debug'):
2030                 traverse_obj(_TEST_DATA, lambda a, b, c: ...)
2031
2032         # Test set as key (transformation/type, like `expected_type`)
2033         self.assertEqual(traverse_obj(_TEST_DATA, (..., {str.upper}, )), ['STR'],
2034                          msg='Function in set should be a transformation')
2035         self.assertEqual(traverse_obj(_TEST_DATA, (..., {str})), ['str'],
2036                          msg='Type in set should be a type filter')
2037         self.assertEqual(traverse_obj(_TEST_DATA, {dict}), _TEST_DATA,
2038                          msg='A single set should be wrapped into a path')
2039         self.assertEqual(traverse_obj(_TEST_DATA, (..., {str.upper})), ['STR'],
2040                          msg='Transformation function should not raise')
2041         self.assertEqual(traverse_obj(_TEST_DATA, (..., {str_or_none})),
2042                          [item for item in map(str_or_none, _TEST_DATA.values()) if item is not None],
2043                          msg='Function in set should be a transformation')
2044         if __debug__:
2045             with self.assertRaises(Exception, msg='Sets with length != 1 should raise in debug'):
2046                 traverse_obj(_TEST_DATA, set())
2047             with self.assertRaises(Exception, msg='Sets with length != 1 should raise in debug'):
2048                 traverse_obj(_TEST_DATA, {str.upper, str})
2049
2050         # Test alternative paths
2051         self.assertEqual(traverse_obj(_TEST_DATA, 'fail', 'str'), 'str',
2052                          msg='multiple `paths` should be treated as alternative paths')
2053         self.assertEqual(traverse_obj(_TEST_DATA, 'str', 100), 'str',
2054                          msg='alternatives should exit early')
2055         self.assertEqual(traverse_obj(_TEST_DATA, 'fail', 'fail'), None,
2056                          msg='alternatives should return `default` if exhausted')
2057         self.assertEqual(traverse_obj(_TEST_DATA, (..., 'fail'), 100), 100,
2058                          msg='alternatives should track their own branching return')
2059         self.assertEqual(traverse_obj(_TEST_DATA, ('dict', ...), ('data', ...)), list(_TEST_DATA['data']),
2060                          msg='alternatives on empty objects should search further')
2061
2062         # Test branch and path nesting
2063         self.assertEqual(traverse_obj(_TEST_DATA, ('urls', (3, 0), 'url')), ['https://www.example.com/0'],
2064                          msg='tuple as key should be treated as branches')
2065         self.assertEqual(traverse_obj(_TEST_DATA, ('urls', [3, 0], 'url')), ['https://www.example.com/0'],
2066                          msg='list as key should be treated as branches')
2067         self.assertEqual(traverse_obj(_TEST_DATA, ('urls', ((1, 'fail'), (0, 'url')))), ['https://www.example.com/0'],
2068                          msg='double nesting in path should be treated as paths')
2069         self.assertEqual(traverse_obj(['0', [1, 2]], [(0, 1), 0]), [1],
2070                          msg='do not fail early on branching')
2071         self.assertCountEqual(traverse_obj(_TEST_DATA, ('urls', ((1, ('fail', 'url')), (0, 'url')))),
2072                               ['https://www.example.com/0', 'https://www.example.com/1'],
2073                               msg='tripple nesting in path should be treated as branches')
2074         self.assertEqual(traverse_obj(_TEST_DATA, ('urls', ('fail', (..., 'url')))),
2075                          ['https://www.example.com/0', 'https://www.example.com/1'],
2076                          msg='ellipsis as branch path start gets flattened')
2077
2078         # Test dictionary as key
2079         self.assertEqual(traverse_obj(_TEST_DATA, {0: 100, 1: 1.2}), {0: 100, 1: 1.2},
2080                          msg='dict key should result in a dict with the same keys')
2081         self.assertEqual(traverse_obj(_TEST_DATA, {0: ('urls', 0, 'url')}),
2082                          {0: 'https://www.example.com/0'},
2083                          msg='dict key should allow paths')
2084         self.assertEqual(traverse_obj(_TEST_DATA, {0: ('urls', (3, 0), 'url')}),
2085                          {0: ['https://www.example.com/0']},
2086                          msg='tuple in dict path should be treated as branches')
2087         self.assertEqual(traverse_obj(_TEST_DATA, {0: ('urls', ((1, 'fail'), (0, 'url')))}),
2088                          {0: ['https://www.example.com/0']},
2089                          msg='double nesting in dict path should be treated as paths')
2090         self.assertEqual(traverse_obj(_TEST_DATA, {0: ('urls', ((1, ('fail', 'url')), (0, 'url')))}),
2091                          {0: ['https://www.example.com/1', 'https://www.example.com/0']},
2092                          msg='tripple nesting in dict path should be treated as branches')
2093         self.assertEqual(traverse_obj(_TEST_DATA, {0: 'fail'}), {},
2094                          msg='remove `None` values when top level dict key fails')
2095         self.assertEqual(traverse_obj(_TEST_DATA, {0: 'fail'}, default=...), {0: ...},
2096                          msg='use `default` if key fails and `default`')
2097         self.assertEqual(traverse_obj(_TEST_DATA, {0: 'dict'}), {},
2098                          msg='remove empty values when dict key')
2099         self.assertEqual(traverse_obj(_TEST_DATA, {0: 'dict'}, default=...), {0: ...},
2100                          msg='use `default` when dict key and `default`')
2101         self.assertEqual(traverse_obj(_TEST_DATA, {0: {0: 'fail'}}), {},
2102                          msg='remove empty values when nested dict key fails')
2103         self.assertEqual(traverse_obj(None, {0: 'fail'}), {},
2104                          msg='default to dict if pruned')
2105         self.assertEqual(traverse_obj(None, {0: 'fail'}, default=...), {0: ...},
2106                          msg='default to dict if pruned and default is given')
2107         self.assertEqual(traverse_obj(_TEST_DATA, {0: {0: 'fail'}}, default=...), {0: {0: ...}},
2108                          msg='use nested `default` when nested dict key fails and `default`')
2109         self.assertEqual(traverse_obj(_TEST_DATA, {0: ('dict', ...)}), {},
2110                          msg='remove key if branch in dict key not successful')
2111
2112         # Testing default parameter behavior
2113         _DEFAULT_DATA = {'None': None, 'int': 0, 'list': []}
2114         self.assertEqual(traverse_obj(_DEFAULT_DATA, 'fail'), None,
2115                          msg='default value should be `None`')
2116         self.assertEqual(traverse_obj(_DEFAULT_DATA, 'fail', 'fail', default=...), ...,
2117                          msg='chained fails should result in default')
2118         self.assertEqual(traverse_obj(_DEFAULT_DATA, 'None', 'int'), 0,
2119                          msg='should not short cirquit on `None`')
2120         self.assertEqual(traverse_obj(_DEFAULT_DATA, 'fail', default=1), 1,
2121                          msg='invalid dict key should result in `default`')
2122         self.assertEqual(traverse_obj(_DEFAULT_DATA, 'None', default=1), 1,
2123                          msg='`None` is a deliberate sentinel and should become `default`')
2124         self.assertEqual(traverse_obj(_DEFAULT_DATA, ('list', 10)), None,
2125                          msg='`IndexError` should result in `default`')
2126         self.assertEqual(traverse_obj(_DEFAULT_DATA, (..., 'fail'), default=1), 1,
2127                          msg='if branched but not successful return `default` if defined, not `[]`')
2128         self.assertEqual(traverse_obj(_DEFAULT_DATA, (..., 'fail'), default=None), None,
2129                          msg='if branched but not successful return `default` even if `default` is `None`')
2130         self.assertEqual(traverse_obj(_DEFAULT_DATA, (..., 'fail')), [],
2131                          msg='if branched but not successful return `[]`, not `default`')
2132         self.assertEqual(traverse_obj(_DEFAULT_DATA, ('list', ...)), [],
2133                          msg='if branched but object is empty return `[]`, not `default`')
2134         self.assertEqual(traverse_obj(None, ...), [],
2135                          msg='if branched but object is `None` return `[]`, not `default`')
2136         self.assertEqual(traverse_obj({0: None}, (0, ...)), [],
2137                          msg='if branched but state is `None` return `[]`, not `default`')
2138
2139         branching_paths = [
2140             ('fail', ...),
2141             (..., 'fail'),
2142             100 * ('fail',) + (...,),
2143             (...,) + 100 * ('fail',),
2144         ]
2145         for branching_path in branching_paths:
2146             self.assertEqual(traverse_obj({}, branching_path), [],
2147                              msg='if branched but state is `None`, return `[]` (not `default`)')
2148             self.assertEqual(traverse_obj({}, 'fail', branching_path), [],
2149                              msg='if branching in last alternative and previous did not match, return `[]` (not `default`)')
2150             self.assertEqual(traverse_obj({0: 'x'}, 0, branching_path), 'x',
2151                              msg='if branching in last alternative and previous did match, return single value')
2152             self.assertEqual(traverse_obj({0: 'x'}, branching_path, 0), 'x',
2153                              msg='if branching in first alternative and non-branching path does match, return single value')
2154             self.assertEqual(traverse_obj({}, branching_path, 'fail'), None,
2155                              msg='if branching in first alternative and non-branching path does not match, return `default`')
2156
2157         # Testing expected_type behavior
2158         _EXPECTED_TYPE_DATA = {'str': 'str', 'int': 0}
2159         self.assertEqual(traverse_obj(_EXPECTED_TYPE_DATA, 'str', expected_type=str),
2160                          'str', msg='accept matching `expected_type` type')
2161         self.assertEqual(traverse_obj(_EXPECTED_TYPE_DATA, 'str', expected_type=int),
2162                          None, msg='reject non matching `expected_type` type')
2163         self.assertEqual(traverse_obj(_EXPECTED_TYPE_DATA, 'int', expected_type=lambda x: str(x)),
2164                          '0', msg='transform type using type function')
2165         self.assertEqual(traverse_obj(_EXPECTED_TYPE_DATA, 'str', expected_type=lambda _: 1 / 0),
2166                          None, msg='wrap expected_type fuction in try_call')
2167         self.assertEqual(traverse_obj(_EXPECTED_TYPE_DATA, ..., expected_type=str),
2168                          ['str'], msg='eliminate items that expected_type fails on')
2169         self.assertEqual(traverse_obj(_TEST_DATA, {0: 100, 1: 1.2}, expected_type=int),
2170                          {0: 100}, msg='type as expected_type should filter dict values')
2171         self.assertEqual(traverse_obj(_TEST_DATA, {0: 100, 1: 1.2, 2: 'None'}, expected_type=str_or_none),
2172                          {0: '100', 1: '1.2'}, msg='function as expected_type should transform dict values')
2173         self.assertEqual(traverse_obj(_TEST_DATA, ({0: 1.2}, 0, {int_or_none}), expected_type=int),
2174                          1, msg='expected_type should not filter non final dict values')
2175         self.assertEqual(traverse_obj(_TEST_DATA, {0: {0: 100, 1: 'str'}}, expected_type=int),
2176                          {0: {0: 100}}, msg='expected_type should transform deep dict values')
2177         self.assertEqual(traverse_obj(_TEST_DATA, [({0: '...'}, {0: '...'})], expected_type=type(...)),
2178                          [{0: ...}, {0: ...}], msg='expected_type should transform branched dict values')
2179         self.assertEqual(traverse_obj({1: {3: 4}}, [(1, 2), 3], expected_type=int),
2180                          [4], msg='expected_type regression for type matching in tuple branching')
2181         self.assertEqual(traverse_obj(_TEST_DATA, ['data', ...], expected_type=int),
2182                          [], msg='expected_type regression for type matching in dict result')
2183
2184         # Test get_all behavior
2185         _GET_ALL_DATA = {'key': [0, 1, 2]}
2186         self.assertEqual(traverse_obj(_GET_ALL_DATA, ('key', ...), get_all=False), 0,
2187                          msg='if not `get_all`, return only first matching value')
2188         self.assertEqual(traverse_obj(_GET_ALL_DATA, ..., get_all=False), [0, 1, 2],
2189                          msg='do not overflatten if not `get_all`')
2190
2191         # Test casesense behavior
2192         _CASESENSE_DATA = {
2193             'KeY': 'value0',
2194             0: {
2195                 'KeY': 'value1',
2196                 0: {'KeY': 'value2'},
2197             },
2198         }
2199         self.assertEqual(traverse_obj(_CASESENSE_DATA, 'key'), None,
2200                          msg='dict keys should be case sensitive unless `casesense`')
2201         self.assertEqual(traverse_obj(_CASESENSE_DATA, 'keY',
2202                                       casesense=False), 'value0',
2203                          msg='allow non matching key case if `casesense`')
2204         self.assertEqual(traverse_obj(_CASESENSE_DATA, (0, ('keY',)),
2205                                       casesense=False), ['value1'],
2206                          msg='allow non matching key case in branch if `casesense`')
2207         self.assertEqual(traverse_obj(_CASESENSE_DATA, (0, ((0, 'keY'),)),
2208                                       casesense=False), ['value2'],
2209                          msg='allow non matching key case in branch path if `casesense`')
2210
2211         # Test traverse_string behavior
2212         _TRAVERSE_STRING_DATA = {'str': 'str', 1.2: 1.2}
2213         self.assertEqual(traverse_obj(_TRAVERSE_STRING_DATA, ('str', 0)), None,
2214                          msg='do not traverse into string if not `traverse_string`')
2215         self.assertEqual(traverse_obj(_TRAVERSE_STRING_DATA, ('str', 0),
2216                                       traverse_string=True), 's',
2217                          msg='traverse into string if `traverse_string`')
2218         self.assertEqual(traverse_obj(_TRAVERSE_STRING_DATA, (1.2, 1),
2219                                       traverse_string=True), '.',
2220                          msg='traverse into converted data if `traverse_string`')
2221         self.assertEqual(traverse_obj(_TRAVERSE_STRING_DATA, ('str', ...),
2222                                       traverse_string=True), 'str',
2223                          msg='`...` should result in string (same value) if `traverse_string`')
2224         self.assertEqual(traverse_obj(_TRAVERSE_STRING_DATA, ('str', slice(0, None, 2)),
2225                                       traverse_string=True), 'sr',
2226                          msg='`slice` should result in string if `traverse_string`')
2227         self.assertEqual(traverse_obj(_TRAVERSE_STRING_DATA, ('str', lambda i, v: i or v == "s"),
2228                                       traverse_string=True), 'str',
2229                          msg='function should result in string if `traverse_string`')
2230         self.assertEqual(traverse_obj(_TRAVERSE_STRING_DATA, ('str', (0, 2)),
2231                                       traverse_string=True), ['s', 'r'],
2232                          msg='branching should result in list if `traverse_string`')
2233
2234         # Test is_user_input behavior
2235         _IS_USER_INPUT_DATA = {'range8': list(range(8))}
2236         self.assertEqual(traverse_obj(_IS_USER_INPUT_DATA, ('range8', '3'),
2237                                       is_user_input=True), 3,
2238                          msg='allow for string indexing if `is_user_input`')
2239         self.assertCountEqual(traverse_obj(_IS_USER_INPUT_DATA, ('range8', '3:'),
2240                                            is_user_input=True), tuple(range(8))[3:],
2241                               msg='allow for string slice if `is_user_input`')
2242         self.assertCountEqual(traverse_obj(_IS_USER_INPUT_DATA, ('range8', ':4:2'),
2243                                            is_user_input=True), tuple(range(8))[:4:2],
2244                               msg='allow step in string slice if `is_user_input`')
2245         self.assertCountEqual(traverse_obj(_IS_USER_INPUT_DATA, ('range8', ':'),
2246                                            is_user_input=True), range(8),
2247                               msg='`:` should be treated as `...` if `is_user_input`')
2248         with self.assertRaises(TypeError, msg='too many params should result in error'):
2249             traverse_obj(_IS_USER_INPUT_DATA, ('range8', ':::'), is_user_input=True)
2250
2251         # Test re.Match as input obj
2252         mobj = re.fullmatch(r'0(12)(?P<group>3)(4)?', '0123')
2253         self.assertEqual(traverse_obj(mobj, ...), [x for x in mobj.groups() if x is not None],
2254                          msg='`...` on a `re.Match` should give its `groups()`')
2255         self.assertEqual(traverse_obj(mobj, lambda k, _: k in (0, 2)), ['0123', '3'],
2256                          msg='function on a `re.Match` should give groupno, value starting at 0')
2257         self.assertEqual(traverse_obj(mobj, 'group'), '3',
2258                          msg='str key on a `re.Match` should give group with that name')
2259         self.assertEqual(traverse_obj(mobj, 2), '3',
2260                          msg='int key on a `re.Match` should give group with that name')
2261         self.assertEqual(traverse_obj(mobj, 'gRoUp', casesense=False), '3',
2262                          msg='str key on a `re.Match` should respect casesense')
2263         self.assertEqual(traverse_obj(mobj, 'fail'), None,
2264                          msg='failing str key on a `re.Match` should return `default`')
2265         self.assertEqual(traverse_obj(mobj, 'gRoUpS', casesense=False), None,
2266                          msg='failing str key on a `re.Match` should return `default`')
2267         self.assertEqual(traverse_obj(mobj, 8), None,
2268                          msg='failing int key on a `re.Match` should return `default`')
2269         self.assertEqual(traverse_obj(mobj, lambda k, _: k in (0, 'group')), ['0123', '3'],
2270                          msg='function on a `re.Match` should give group name as well')
2271
2272
2273 if __name__ == '__main__':
2274     unittest.main()